Aplicaciones de .NET Core Ejecutar múltiples aplicaciones Configurar grupos de aplicaciones Definir implementaciones personalizadas

Ejecutar múltiples aplicaciones y aplicaciones centrales ASP.NET con un manifiesto de implementación

Puede utilizar un manifiesto de implementación para indicarle a Elastic Beanstalk cómo se va a implementar la aplicación. Al utilizar este método, no es necesario utilizar MSDeploy para generar un paquete de código fuente para una única aplicación ASP.NET que se ejecuta en la ruta raíz del sitio web. En su lugar, puede utilizar un archivo de manifiesto para ejecutar varias aplicaciones en rutas diferentes. O bien, puede indicarle a Elastic Beanstalk que implemente y ejecute la aplicación con ASP.NET Core. También puede utilizar un manifiesto de implementación para configurar un grupo de aplicaciones en el que ejecutará las aplicaciones.

Los manifiestos de implementación añaden compatibilidad con las aplicaciones de .NET Core en Elastic Beanstalk. Puede implementar una aplicación.NET Framework sin un manifiesto de implementación. Sin embargo, las aplicaciones.NET Core requieren un manifiesto de implementación para ejecutarse en Elastic Beanstalk. Si utiliza un manifiesto de implementación, debe crear un archivo del sitio para cada aplicación y empaquetar todos ellos después en un segundo ZIP que contenga el manifiesto de implementación.

Los manifiestos de implementación también brindan la posibilidad de ejecutar varias aplicaciones en diferentes rutas. Un manifiesto de implementación define una serie de objetivos de implementación, cada uno de ellos con un archivo del sitio y una ruta en la que IIS debe ejecutarse. Por ejemplo, puede ejecutar una API web en la ruta /api para que atienda las solicitudes asincrónicas y una aplicación web en la ruta raíz que utilice la API.

También puede utilizar un manifiesto de implementación para ejecutar varias aplicaciones mediante grupos de aplicaciones en IIS o Kestrel. Puede configurar un grupo de aplicaciones para reiniciar las aplicaciones periódicamente, ejecutar aplicaciones de 32 bits o utilizar una versión específica del entorno de ejecución de .NET Framework.

Para una mayor personalización, puede escribir sus propios scripts de implementación en Windows PowerShell e indicarle a Elastic Beanstalk qué scripts ejecutar para instalar, desinstalar y reiniciar la aplicación.

El manifiesto de implementación y las características relacionadas requieren una plataforma de Windows Server versión 1.2.0 o posterior.

Aplicaciones de .NET Core

Puede utilizar un manifiesto de implementación para ejecutar aplicaciones .NET Core en Elastic Beanstalk. .NET Core es una versión multiplataforma de .NET que incluye una herramienta de línea de comandos (dotnet). Puede utilizarla para generar una aplicación, ejecutarla localmente y prepararla para su publicación.

nota

Visite Tutorial: Implementación de una aplicación ASP.NET Core con Elastic Beanstalk para ver un tutorial y una aplicación de ejemplo donde se usa un manifiesto de implementación para ejecutar una aplicación de .NET Core en Elastic Beanstalk.

Para ejecutar una aplicación de .NET Core en Elastic Beanstalk, puede ejecutar dotnet publish y empaquetar la salida en un archivo ZIP, sin incluir los directorios que contiene. Coloque el archivo del sitio en un paquete de código fuente con un manifiesto de implementación que tenga un destino de implementación de tipo aspNetCoreWeb.

El siguiente manifiesto de implementación ejecuta una aplicación de .NET Core desde un archivo del sitio llamado dotnet-core-app.zip situado en la ruta raíz.

ejemplo aws-windows-deployment-manifest.json: .NET core


{
  "manifestVersion": 1,
  "deployments": {
    "aspNetCoreWeb": [
      {
        "name": "my-dotnet-core-app",
        "parameters": {
          "archive": "dotnet-core-app.zip",
          "iisPath": "/"
        }
      }
    ]
  }
}

Empaquete el manifiesto y el archivo del sitio en un ZIP para crear un paquete de código fuente.

ejemplo dotnet-core-bundle.zip


.
|-- aws-windows-deployment-manifest.json
`-- dotnet-core-app.zip

El archivo del sitio contiene el código compilado de la aplicación, las dependencias y el archivo web.config.

ejemplo dotnet-core-app.zip


.
|-- Microsoft.AspNetCore.Hosting.Abstractions.dll
|-- Microsoft.AspNetCore.Hosting.Server.Abstractions.dll
|-- Microsoft.AspNetCore.Hosting.dll
|-- Microsoft.AspNetCore.Http.Abstractions.dll
|-- Microsoft.AspNetCore.Http.Extensions.dll
|-- Microsoft.AspNetCore.Http.Features.dll
|-- Microsoft.AspNetCore.Http.dll
|-- Microsoft.AspNetCore.HttpOverrides.dll
|-- Microsoft.AspNetCore.Server.IISIntegration.dll
|-- Microsoft.AspNetCore.Server.Kestrel.dll
|-- Microsoft.AspNetCore.WebUtilities.dll
|-- Microsoft.Extensions.Configuration.Abstractions.dll
|-- Microsoft.Extensions.Configuration.EnvironmentVariables.dll
|-- Microsoft.Extensions.Configuration.dll
|-- Microsoft.Extensions.DependencyInjection.Abstractions.dll
|-- Microsoft.Extensions.DependencyInjection.dll
|-- Microsoft.Extensions.FileProviders.Abstractions.dll
|-- Microsoft.Extensions.FileProviders.Physical.dll
|-- Microsoft.Extensions.FileSystemGlobbing.dll
|-- Microsoft.Extensions.Logging.Abstractions.dll
|-- Microsoft.Extensions.Logging.dll
|-- Microsoft.Extensions.ObjectPool.dll
|-- Microsoft.Extensions.Options.dll
|-- Microsoft.Extensions.PlatformAbstractions.dll
|-- Microsoft.Extensions.Primitives.dll
|-- Microsoft.Net.Http.Headers.dll
|-- System.Diagnostics.Contracts.dll
|-- System.Net.WebSockets.dll
|-- System.Text.Encodings.Web.dll
|-- dotnet-core-app.deps.json
|-- dotnet-core-app.dll
|-- dotnet-core-app.pdb
|-- dotnet-core-app.runtimeconfig.json
`-- web.config

Consulte el tutorial para ver un ejemplo completo.

Ejecutar múltiples aplicaciones

Para ejecutar varias aplicaciones con un manifiesto de implementación, debe definir diferentes objetivos de implementación.

El manifiesto de implementación siguiente configura dos aplicaciones .NET Core. La aplicación WebAPITest implementa unas pocas API web y sirve solicitudes asíncronas en la ruta /api. La aplicación ASPNetTest es una aplicación web que atiende solicitudes en la ruta raíz.

ejemplo aws-windows-deployment-manifest.json: varias aplicaciones


{
  "manifestVersion":  1,
  "deployments": {
    "aspNetCoreWeb": [
      {
        "name": "WebAPITest",
        "parameters": {
          "appBundle": "webapi.zip",
          "iisPath": "/api"
        }
      },
      {
        "name": "ASPNetTest",
        "parameters": {
          "appBundle": "aspnet.zip",
          "iisPath": "/"
        }
      }
    ]
  }
}

Aquí hay disponible una aplicación de ejemplo con varias aplicaciones:

Paquete de código fuente implementable: dotnet-multiapp-sample-bundle-v2.zip
Código fuente: dotnet-multiapp-sample-source-v2.zip

Configurar grupos de aplicaciones

Puede admitir varias aplicaciones en su entorno Windows. Hay dos enfoques disponibles:

Puede utilizar el modelo de alojamiento fuera de proceso con el servidor web Kestrel. Con este modelo, puede configurar varias aplicaciones para que se ejecuten en un grupo de aplicaciones.
Puede utilizar el modelo de alojamiento en proceso. Con este modelo, se utilizan varios grupos de aplicaciones para ejecutar varias aplicaciones con una sola aplicación en cada grupo. Si utiliza el servidor IIS y necesita ejecutar varias aplicaciones, debe utilizar este enfoque.

Si desea configurar Kestrel para que ejecute varias aplicaciones en un grupo de aplicaciones, agregue hostingModel="OutofProcess" en el archivo web.config. Considere los siguientes ejemplos:

ejemplo web.config: para el modelo de alojamiento fuera de proceso de Kestrel


<configuration>
<location path="." inheritInChildApplications="false">
<system.webServer>
<handlers>
<add 
    name="aspNetCore" 
    path="*" verb="*" 
    modules="AspNetCoreModuleV2" 
    resourceType="Unspecified" />
</handlers>
<aspNetCore 
    processPath="dotnet" 
    arguments=".\CoreWebApp-5-0.dll" 
    stdoutLogEnabled="false" 
    stdoutLogFile=".\logs\stdout" 
    hostingModel="OutofProcess" />
</system.webServer>
</location>
</configuration>

ejemplo aws-windows-deployment-manifest.json: para varias aplicaciones


{
"manifestVersion": 1,
  "deployments": {"msDeploy": [
      {"name": "Web-app1",
        "parameters": {"archive": "site1.zip",
          "iisPath": "/"
        }
      },
      {"name": "Web-app2",
        "parameters": {"archive": "site2.zip",
          "iisPath": "/app2"
        }
      }
    ]
  }
}

IIS no admite varias aplicaciones en un grupo de aplicaciones porque utiliza el modelo de alojamiento en proceso. Por lo tanto, debe configurar varias aplicaciones mediante la asignación de cada aplicación a un grupo de aplicaciones. En otras palabras, asigne solo una aplicación a un grupo de aplicaciones.

Puede configurar IIS para que use diferentes grupos de aplicaciones en el archivo aws-windows-deployment-manifest.json. Realice las siguientes actualizaciones al consultar el siguiente archivo de ejemplo:

Agregue una sección iisConfig que incluya una subsección llamada appPools.
En el bloque appPools, enumere los grupos de aplicaciones.
En la sección deployments, defina una sección parameters para cada aplicación.
Para cada aplicación, la sección parameters especifica un archivo, una ruta de acceso para ejecutarlo y una appPool en la que se ejecutará.

El siguiente manifiesto de implementación configura dos grupos de aplicaciones que reinician su aplicación cada 10 minutos. También adjuntan sus aplicaciones a una aplicación web .NET Framework que se ejecuta en la ruta especificada.

ejemplo aws-windows-deployment-manifest.json: una aplicación por grupo de aplicaciones


{
"manifestVersion": 1,
  "iisConfig": {"appPools": [
      {"name": "MyFirstPool",
       "recycling": {"regularTimeInterval": 10}
      },
      {"name": "MySecondPool",
       "recycling": {"regularTimeInterval": 10}
      }
     ]
    },
  "deployments": {"msDeploy": [
      {"name": "Web-app1",
        "parameters": {
           "archive": "site1.zip",
           "iisPath": "/",
           "appPool": "MyFirstPool"
           }
      },
      {"name": "Web-app2",
        "parameters": {
           "archive": "site2.zip",
           "iisPath": "/app2",
           "appPool": "MySecondPool"
          }
      }
     ]
    }
}

Definir implementaciones personalizadas

Para tener aún más control, puede personalizar completamente la implementación de una aplicación y definir una implementación personalizada.

El siguiente manifiesto de implementación indica a Elastic Beanstalk que ejecute un script install denominado siteInstall.ps1. Este script instala el sitio web durante el inicio y las implementaciones de la instancia. Además, el manifiesto de implementación también indica a Elastic Beanstalk que ejecute un script uninstall antes de instalar una nueva versión durante una implementación y un script restart que reinicie la aplicación cuando elija Restart App Server (Reiniciar servidor de aplicaciones) en la Management Console de AWS.

ejemplo aws-windows-deployment-manifest.json: implementación personalizada


{
  "manifestVersion": 1,
  "deployments": {
    "custom": [
      {
        "name": "Custom site",
        "scripts": {
          "install": {
            "file": "siteInstall.ps1"
          },
          "restart": {
            "file": "siteRestart.ps1"
          },
          "uninstall": {
            "file": "siteUninstall.ps1"
          }
        }
      }
    ]
  }
}

Incluya los artefactos necesarios para ejecutar la aplicación en el paquete de código fuente con el manifiesto y los scripts.

ejemplo custom-site-bundle.zip


.
|-- aws-windows-deployment-manifest.json
|-- siteInstall.ps1
|-- siteRestart.ps1
|-- siteUninstall.ps1
`-- site-contents.zip

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Migración de versiones principales

Tutorial: ASP.NET Core