Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Personalización avanzada del entorno con archivos de configuración (.ebextensions)
Puede agregar archivos de AWS Elastic Beanstalk configuración (.ebextensions) al código fuente de su aplicación web para configurar su entorno y personalizar los AWS recursos que contiene. Los archivos de configuración son documentos YAML o JSON-formatted documentos con una extensión de .config archivo que se colocan en una carpeta denominada .ebextensions e implementan en el paquete Creación de una agrupación de orígenes de aplicación en Elastic Beanstalk. fuente de la aplicación.
ejemplo. ebextensions/network-load-balancer.config
En este ejemplo se realiza un simple cambio de configuración. Modifica una opción de configuración para establecer el tipo de equilibrador de carga del entorno en el equilibrador de carga de red.
option_settings:
aws:elasticbeanstalk:environment:
LoadBalancerType: networkRecomendamos utilizar YAML para los archivos de configuración, ya que es más fácil de leer que JSON. YAML admite comentarios, comandos multilínea, varias alternativas de uso de comillas, etc. Sin embargo, puede realizar cualquier cambio de configuración en los archivos de configuración de Elastic Beanstalk exactamente igual usando YAML o JSON.
nota
Los archivos de configuración solo se aplican a los entornos de Beanstalk Standard. Personalizan las instancias de Amazon EC2 que ejecutan su aplicación, algo que no tiene un entorno de Beanstalk Cluster. Con Beanstalk Cluster, instale las dependencias de su aplicación en la imagen del contenedor, ya sea en su Dockerfile o en la fuente que Elastic Beanstalk compila, y defina las opciones de configuración con o en la consola. --option-settings Consulte Creación de imágenes de contenedores para entornos de Beanstalk Cluster y Opciones de configuración para entornos de Beanstalk Cluster.
Sugerencia
Cuando esté desarrollando o probando nuevos archivos de configuración, lance un entorno limpio que ejecute la aplicación predeterminada e impleméntelos en este entorno. Si los archivos de configuración no tienen un formato correcto, se producirán error irrecuperables al lanzar un nuevo entorno.
En la sección option_settings de un archivo de configuración, se definen los valores de las opciones de configuración. Las opciones de configuración le permiten configurar el entorno de Elastic Beanstalk, los recursos que contiene y el software que ejecuta la aplicación AWS . Los archivos de configuración son solo uno de los diferentes mecanismos para definir las opciones de configuración.
La Resources sección le permite personalizar aún más los recursos del entorno de su aplicación y definir AWS recursos adicionales además de la funcionalidad que proporcionan las opciones de configuración. Puede agregar y configurar cualquier recurso compatible AWS CloudFormation que Elastic Beanstalk utilice para crear entornos.
El resto de las secciones de un archivo de configuración (packages, sources, files, users, groups, commands, container_commands y services) le permiten configurar las instancias EC2 que se lanzan en el entorno. Cuando se lanza un servidor en el entorno, Elastic Beanstalk ejecuta las operaciones definidas en estas secciones para preparar el sistema operativo y el sistema de almacenamiento de la aplicación.
Para obtener ejemplos de .ebextensions de uso común, consulte el Repositorio de archivos de configuración de Elastic Beanstalk
Requisitos
-
Ubicación: Elastic Beanstalk procesará todas las carpetas de
.ebextensionspresentes en la implementación. No obstante, le recomendamos que coloque todos sus archivos de configuración en una sola carpeta, denominada.ebextensions, en la raíz de su paquete de código fuente. Los exploradores de archivos pueden ocultar las carpetas que comienzan con un punto, así que asegúrese de agregar la carpeta al crear el paquete de código fuente. Para obtener más información, consulte Creación de una agrupación de orígenes de aplicación en Elastic Beanstalk.. -
Naming (Denominación): los archivos de configuración deben tener la extensión de archivo
.config. -
Formatting (Formato): los archivos de configuración deben cumplir las especificaciones de formato de YAML o JSON.
Si utiliza YAML, use siempre espacios para aplicar sangría a las claves en los diferentes niveles de anidación. Para obtener más información acerca de YAML, consulte YAML Ain't Markup Language (YAML™) (versión 1.1)
. -
Uniqueness (Unicidad): use cada clave una sola vez en cada archivo de configuración.
Advertencia
Si utiliza una clave (por ejemplo,
option_settings) dos veces en el mismo archivo de configuración, se descartará una de las secciones. Combine secciones duplicadas en una sola sección o colóquelas en archivos de configuración distintos.
El proceso de implementación varía ligeramente en función del cliente que se utilice para administrar los entornos. Consulte las secciones siguientes para obtener más detalles:
Temas
