Uso de la plataforma .NET Core en Linux en Elastic Beanstalk

En este tema se describe cómo configurar, crear y ejecutar las aplicaciones .NET Core en Linux en Elastic Beanstalk.

AWS Elastic Beanstalk es compatible con varias ramificaciones de la plataforma para diferentes versiones .NET Core framework que se ejecutan en el sistema operativo Linux. Consulte .NET core para Linux en Plataformas de AWS Elastic Beanstalk para obtener una lista completa.

Para obtener más información sobre las diversas formas en las que puede ampliar una plataforma Elastic Beanstalk basada en Linux, consulte Ampliación de las plataformas Linux de Elastic Beanstalk.

Consideraciones sobre las plataformas .NET Core en Linux

Servidor proxy

Las plataforma .NET Core de Elastic Beanstalk incluye un proxy inverso que reenvía las solicitudes a su aplicación. De forma predeterminada, Elastic Beanstalk utiliza NGINX como servidor proxy. Puede elegir no utilizar ningún servidor proxy y configurar Kestrel como su servidor web. Kestrel se incluye de forma predeterminada en las plantillas de proyecto ASP.NET Core.

Estructura de la aplicación

Puede publicar aplicaciones dependientes del tiempo de ejecución que utilicen el tiempo de ejecución de .NET Core proporcionado por Elastic Beanstalk. También puede publicar aplicaciones autónomas que incluyan el tiempo de ejecución de .NET Core y las dependencias de la aplicación en el paquete de código fuente. Para obtener más información, consulte Agrupación de aplicaciones para la plataforma .NET Core en Linux de Elastic Beanstalk.

Configuración de la plataforma

Para configurar los procesos que se ejecutan en las instancias de servidor en su entorno, incluya un Procfile opcional en su paquete de código fuente. Se requiere un Procfile si tiene más de una aplicación en su paquete de código fuente.

Le recomendamos que proporcione siempre un Procfile en el paquete de código fuente con su aplicación. De esta forma, puede controlar con precisión qué procesos ejecuta Elastic Beanstalk para su aplicación.

En la consola de Elastic Beanstalk hay opciones de configuración disponibles para modificar la configuración de un entorno en ejecución. Para evitar perder la configuración del entorno cuando lo termina, puede usar las configuraciones guardadas para guardar la configuración y aplicarla posteriormente a otro entorno.

Para guardar la configuración en el código fuente, puede incluir archivos de configuración. Los valores de configuración de los archivos de configuración se aplican cada vez que crea un entorno o que implementa la aplicación. También puede usar archivos de configuración para instalar paquetes, ejecutar scripts y llevar a cabo otras operaciones de personalización de instancias durante las implementaciones.

La configuración aplicada en la consola de Elastic Beanstalk anula la misma configuración en los archivos de configuración, si existe. Esto le permite tener la configuración predeterminada en los archivos de configuración y anularla con la configuración específica del entorno en la consola. Para obtener más información acerca de la prioridad y otros métodos para cambiar valores de configuración, consulte Opciones de configuración.

Configuración de su entorno de .NET Core en Linux

La configuración de la plataforma .NET Core en Linux le permite ajustar el comportamiento de las instancias de Amazon EC2. Puede editar la configuración de instancia de Amazon EC2 del entorno de Elastic Beanstalk mediante la consola de Elastic Beanstalk.

Utilice la consola de Elastic Beanstalk para habilitar la rotación de registros en Amazon S3 y configurar variables que la aplicación pueda leer desde el entorno.

Para configurar su entorno de .NET Core en Linux mediante la consola de Elastic Beanstalk

1. Abra la consola de Elastic Beanstalk y, en la lista Regions (Regiones), seleccione su Región de AWS.

2. En el panel de navegación, elija Environments (Entornos) y, a continuación, elija el nombre del entorno en la lista.

   nota

   Si tiene muchos entornos, utilice la barra de búsqueda para filtrar la lista de entornos.

3. En el panel de navegación, elija Configuration (Configuración).

4. En la categoría de configuración Actualizaciones, supervisión y registro, seleccione Editar.

Log Options (Opciones de registro)

La sección Log Options (Opciones de registro) tiene dos valores:

• Instance profile (Perfil de instancia): especifica el perfil de instancia que tiene permiso para obtener acceso al bucket de Amazon S3 asociado con la aplicación.

• Enable log file rotation to Amazon S3 (Habilitar la rotación de archivos de registro para Amazon S3): especifica si los archivos de registro de las instancias de Amazon EC2 de la aplicación se copian en el bucket de Amazon S3 asociado a la aplicación.

Propiedades del entorno

La sección Environment Properties (Propiedades del entorno) le permite especificar opciones de configuración del entorno en las instancias Amazon EC2 que ejecutan su aplicación. Las propiedades del entorno se pasan como pares de clave-valor a la aplicación.

Dentro del entorno de .NET Core en Linux que se ejecuta en Elastic Beanstalk, es posible acceder a las variables de entorno mediante Environment.GetEnvironmentVariable("variable-name"). Por ejemplo, podría leer una propiedad denominada API_ENDPOINT en una variable con el siguiente código.

string endpoint = Environment.GetEnvironmentVariable("API_ENDPOINT");

Para obtener más información, consulte Propiedades del entorno y otras opciones del software.

.NET Core en la configuración de espacio de nombres de Linux

Puede usar un archivo de configuración para definir opciones de configuración y realizar otras tareas de configuración en las instancias durante las implementaciones. Las opciones de configuración pueden ser específicas de la plataforma o aplicarse a todas las plataformas del servicio de Elastic Beanstalk en su conjunto. Las opciones de configuración se organizan en espacios de nombres.

La plataforma .NET Core en Linux admite opciones en el siguiente espacio de nombres, además de las opciones admitidas para todos los entornos Elastic Beanstalk:

• aws:elasticbeanstalk:environment:proxy: elija utilizar NGINX o ningún servidor proxy. Los valores válidos son nginx o none.

En el siguiente archivo de configuración de ejemplo se muestra el uso de las opciones de configuración específicas de .NET Core en Linux.

ejemplo .ebextensions/proxy-settings.config

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: none

Elastic Beanstalk cuenta con numerosas opciones de configuración para personalizar el entorno. Además de los archivos de configuración, también puede definir opciones en la consola, configuraciones guardadas, la CLI de EB o la AWS CLI. Para obtener más información, consulte Opciones de configuración.