¿Cómo utilizo .ebextensions para personalizar mi entorno de Elastic Beanstalk?

Solución

Nota: Si se muestran errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), consulta Solución de problemas de AWS CLI. Además, asegúrate de utilizar la versión más reciente de la AWS CLI.

Configuración del directorio .ebextensions

Sigue estos pasos:

1. En la raíz del paquete de aplicaciones, crea un directorio oculto denominado .ebextensions.
2. Guarda el archivo de configuración en el directorio .ebextensions. El paquete de origen de la aplicación tiene un aspecto similar al siguiente ejemplo:

   ~/workspace/my-application/|-- .ebextensions
   |   |-- 01-server-configuration.config
   |   `-- 02-asg-healthcheck.config
   |-- index.php
   `-- styles.css

Personalización del entorno de Elastic Beanstalk

Para modificar la configuración del entorno, utiliza la clave option_settings. Puedes elegir entre opciones generales para todos los entornos y opciones específicas de la plataforma.

Nota: Al crear o actualizar un entorno en la API de Elastic Beanstalk, el cliente aplica los valores recomendados. Los valores recomendados se establecen directamente en el nivel de API y tienen la prioridad más alta. No puedes usar option_settings para cambiar la configuración.

Las reglas de prioridad pueden detener la aplicación de las modificaciones de option_settings en la configuración del entorno. Para eliminar las configuraciones aplicadas directamente durante la creación del entorno, utiliza el comando update-environment con la marca --options-to-remove. También puedes usar la API UpdateEnvironment de Elastic Beanstalk.

Si no hay opciones para la configuración de recursos que deseas, utiliza la clave de recursos para personalizar los recursos en tu entorno de Elastic Beanstalk.

Nota: Elastic Beanstalk agrega los recursos que definas en los archivos de configuración a la plantilla de AWS CloudFormation que se usa para iniciar tu entorno. La plantilla de CloudFormation admite todos los tipos de recursos de CloudFormation. Para obtener más información sobre los nombres de los recursos lógicos, consulta Modificación de los recursos que Elastic Beanstalk crea para tu entorno.

Los archivos de configuración deben tener la extensión de archivo .config y deben usar el formato YAML o JSON.

Utiliza las claves para personalizar el software en los servidores Linux o Windows y usa cada clave solo una vez en cada archivo de configuración.

Al desplegar la aplicación en Elastic Beanstalk, utiliza varias secciones de los archivos de configuración .ebextensions para personalizar las instancias de EC2. Para ver ejemplos de archivos de configuración, consulta elastic-beanstalk-samples en el sitio web de GitHub.

Aplicación de la configuración personalizada a la aplicación

Sigue estos pasos:

1. Crea un paquete de origen de la aplicación que incluya los archivos de configuración.
   Nota: Los exploradores de archivos pueden ocultar las carpetas que comienzan con un punto, como .ebextensions. Para hacer que las carpetas sean visibles, incluye la carpeta .ebextensions en la raíz del paquete de aplicación al crear el paquete de origen de la aplicación.
2. Despliega la aplicación Elastic Beanstalk actualizada.

Información relacionada

Opciones de configuración