Definición de opciones de configuración durante la creación del entorno - AWS Elastic Beanstalk

Definición de opciones de configuración durante la creación del entorno

Cuando crea un entorno de AWS Elastic Beanstalk usando la consola de Elastic Beanstalk, la CLI de EB, la CLI de AWS, un SDK o la API de Elastic Beanstalk, puede proporcionar los valores de las opciones de configuración para personalizar su entorno; los recursos de AWS se lanzarán con esos valores.

Para cualquier otra cosa distinta de un cambio de configuración puntual, puede almacenar los archivos de configuración localmente en su paquete de código fuente o en Amazon S3.

Este tema incluye procedimientos para todos los métodos de definición de opciones de configuración durante la creación del entorno.

En la consola de Elastic Beanstalk

Cuando crea un entorno de Elastic Beanstalk en la consola de Elastic Beanstalk, puede proporcionar las opciones de configuración mediante archivos de configuración, configuraciones guardadas y formularios del asistente Create New Environment (Crear nuevo entorno).

Uso de archivos de configuración (.ebextensions)

Incluya los archivos .config del paquete de código fuente de la aplicación en una carpeta denominada .ebextensions.

Para obtener información detallada sobre los archivos de configuración, consulte .Ebextensions.

~/workspace/my-app-v1.zip |-- .ebextensions | |-- environmentvariables.config | `-- healthcheckurl.config |-- index.php `-- styles.css

Cargue el paquete de código fuente en Elastic Beanstalk de la manera habitual durante la creación del entorno.

La consola de Elastic Beanstalk aplica los valores recomendados para algunas opciones de configuración y dispone de campos de formulario para otras. Las opciones configuradas por la consola de Elastic Beanstalk se aplican directamente al entorno e invalidan los ajustes de los archivos de configuración.

Uso de una configuración guardada

Cuando crea un nuevo entorno usando la consola de Elastic Beanstalk, uno de los primeros pasos consiste en elegir una configuración. La configuración puede ser una configuración predeterminada (por lo general, la última versión de una plataforma como PHP o Tomcat) o puede ser una configuración guardada.

Para aplicar una configuración guardada durante la creación del entorno (consola de Elastic Beanstalk)

  1. Abra la consola de Elastic Beanstalk y, en la lista Regiones, seleccione su región de AWS.

  2. En el panel de navegación, elija Applications (Aplicaciones) y, a continuación, elija el nombre de la aplicación de la lista.

    nota

    Si tiene muchas aplicaciones, utilice la barra de búsqueda para filtrar la lista de aplicaciones.

  3. En el panel de navegación, busque el nombre de la aplicación y elija Saved configurations (Configuraciones guardadas).

  4. Seleccione la configuración guardada que desea aplicar y, a continuación, elija Launch environment (Iniciar entorno).

  5. Avance por el asistente para crear su entorno.

Las configuraciones guardadas son específicas de la aplicación. Consulte Configuraciones guardadas para obtener información detallada sobre cómo crear configuraciones guardadas.

Uso del asistente de creación de nuevo entorno

La mayoría de las opciones de configuración estándar se presentan en la página Configure more options (Configurar más opciones) del Create New Environment wizard (Asistente Crear nuevo entorno). Si crea una base de datos de Amazon RDS o configura una VPC para su entorno, hay disponibles otras opciones de configuración para esos recursos.

Para definir opciones de configuración durante la creación del entorno (consola de Elastic Beanstalk)

  1. Abra la consola de Elastic Beanstalk y, en la lista Regiones, seleccione su región de AWS.

  2. En el panel de navegación, elija Applications (Aplicaciones).

  3. Elija o cree una aplicación.

  4. Elija Actions (Acciones) y, a continuación, seleccione Create environment (Crear entorno).

  5. Continúe a través del asistente y elija Configure more options (Configurar más opciones).

  6. Seleccione cualquiera de los preajustes de configuración y, a continuación, elija Edit (Editar) en una o varias de las categorías de configuración para cambiar un grupo de opciones de configuración relacionadas.

  7. Cuando haya terminado de seleccionar opciones, seleccione Create environment (Crear entorno).

Todas las opciones que define en el asistente para crear un nuevo entorno se establecen directamente en el entorno e invalidan los valores de las opciones en las configuraciones guardadas o archivos de configuración (.ebextensions) que aplique. Puede eliminar los valores después de crear el entorno mediante la CLI de EB o la CLI de AWS para permitir que se apliquen los valores de las configuraciones guardadas o los archivos de configuración.

Para obtener información acerca del nuevo asistente de entorno, consulte El asistente de creación de nuevo entorno.

Uso de la CLI de EB

Uso de archivos de configuración (.ebextensions)

Incluya los archivos .config en la carpeta del proyecto situada bajo .ebextensions para implementarlos con el código de la aplicación.

Para obtener información detallada sobre los archivos de configuración, consulte .Ebextensions.

~/workspace/my-app/ |-- .ebextensions | |-- environmentvariables.config | `-- healthcheckurl.config |-- .elasticbeanstalk | `-- config.yml |-- index.php `-- styles.css

Cree su entorno e implemente el código fuente con eb create.

~/workspace/my-app$ eb create my-env

Uso de configuraciones guardadas

Para aplicar una configuración guardada al crear un entorno con eb create, utilice la opción --cfg.

~/workspace/my-app$ eb create --cfg savedconfig

Puede almacenar la configuración guardada en su carpeta del proyecto o en la ubicación de almacenamiento de Elastic Beanstalk en Amazon S3. En el ejemplo anterior, la CLI de EB primero busca un archivo de configuración guardada denominado savedconfig.cfg.yml en la carpeta .elasticbeanstalk/saved_configs/. No incluya las extensiones de nombre de archivo (.cfg.yml) cuando aplique una configuración guardada con --cfg.

~/workspace/my-app/ |-- .ebextensions | `-- healthcheckurl.config |-- .elasticbeanstalk | |-- saved_configs | | `-- savedconfig.cfg.yml | `-- config.yml |-- index.php `-- styles.css

Si la CLI de EB no encuentra la configuración localmente, la busca en la ubicación de almacenamiento de Elastic Beanstalk en Amazon S3. Consulte Configuraciones guardadas para obtener información detallada sobre cómo crear, editar y cargar configuraciones guardadas.

Uso de las opciones de la línea de comandos

El comando eb create de la CLI de EB tiene varias opciones que puede utilizar para definir opciones de configuración durante la creación del entorno. Puede utilizar estas opciones para añadir una base de datos de RDS al entorno, configurar una VPC o invalidar los valores recomendados.

Por ejemplo, la CLI de EB utiliza el tipo de instancia t2.micro de forma predeterminada. Para elegir un tipo de instancia diferente, utilice la opción --instance_type.

$ eb create my-env --instance_type t2.medium

Para crear una instancia de base de datos de Amazon RDS y asociarla a su entorno, utilice las opciones --database.

$ eb create --database.engine postgres --database.username dbuser

Si omite el nombre del entorno, la contraseña de la base de datos y otros parámetros necesarios para crear su entorno, la CLI de EB le pedirá que los introduzca.

Consulte eb create para ver una lista completa de las opciones disponibles y ejemplos de uso.

Mediante la CLI de AWS

Cuando utiliza el comando create-environment para crear un entorno de Elastic Beanstalk con la CLI de AWS, la CLI de AWS no aplica ninguno de los valores recomendados. Todas las opciones de configuración se definen en los archivos de configuración del paquete de código fuente que especifique.

Uso de archivos de configuración (.ebextensions)

Para aplicar los archivos de configuración a un entorno que crea con la CLI de AWS, incluya estos archivos en el paquete de código fuente de la aplicación que cargó en Amazon S3.

Para obtener información detallada sobre los archivos de configuración, consulte .Ebextensions.

~/workspace/my-app-v1.zip |-- .ebextensions | |-- environmentvariables.config | `-- healthcheckurl.config |-- index.php `-- styles.css

Para cargar un paquete de código fuente de la aplicación y crear un entorno con la CLI de AWS

  1. Si aún no tiene un bucket de Elastic Beanstalk en Amazon S3, cree uno con create-storage-location.

    $ aws elasticbeanstalk create-storage-location { "S3Bucket": "elasticbeanstalk-us-west-2-123456789012" }
  2. Cargue el paquete de código fuente de la aplicación en Amazon S3.

    $ aws s3 cp sourcebundle.zip s3://elasticbeanstalk-us-west-2-123456789012/my-app/sourcebundle.zip
  3. Cree la versión de la aplicación.

    $ aws elasticbeanstalk create-application-version --application-name my-app --version-label v1 --description MyAppv1 --source-bundle S3Bucket="elasticbeanstalk-us-west-2-123456789012",S3Key="my-app/sourcebundle.zip" --auto-create-application
  4. Cree el entorno.

    $ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --solution-stack-name "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"

Uso de una configuración guardada

Para aplicar una configuración guardada al entorno durante su creación, utilice el parámetro --template-name.

$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --template-name savedconfig --version-label v1

Cuando especifique una configuración guardada, no especifique un nombre de la pila de soluciones. Las configuraciones guardadas ya especifican una pila de soluciones y Elastic Beanstalk devolverá un error si intenta utilizar ambas opciones.

Uso de las opciones de la línea de comandos

Utilice el parámetro --option-settings para especificar las opciones de configuración en formato JSON.

$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --template-name savedconfig --option-settings '[ { "Namespace": "aws:elasticbeanstalk:application", "OptionName": "Application Healthcheck URL", "Value": "/health" } ]

Para cargar el JSON desde un archivo, utilice el prefijo file://.

$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --template-name savedconfig --option-settings file://healthcheckurl.json

Elastic Beanstalk aplica los valores de las opciones que especifica con la opción --option-settings directamente a su entorno. Si se especifican las mismas opciones en una configuración guardada o archivo de configuración, --option-settings invalida esos valores.