¿Cómo puedo transferir variables de mi entorno de Elastic Beanstalk a instancias de Linux y Windows?

Descripción breve

Puede transferir variables de entorno a instancias de Amazon EC2 de la siguiente manera:

• Consola de Elastic Beanstalk
• Interfaz de línea de comandos de Elastic Beanstalk (EB CLI)
• Opciones de configuración
• Interfaz de la línea de comandos de AWS (AWS CLI)

Nota: Si recibe errores al ejecutar los comandos de AWS CLI, asegúrese de utilizar la versión más reciente de AWS CLI.

Resolución

Importante: Para transferir información confidencial (como la contraseña de una base de datos) a la instancia, siga las instrucciones que se indican en Almacenamiento seguro de claves privadas en Amazon S3.

Transferir las variables de entorno

Elija una de las siguientes formas de transferir las variables de entorno.

Utilizar la consola de Elastic Beanstalk

Para transferir las variables de entorno mediante la consola, siga las instrucciones de Configuración de las propiedades de entorno.

Importante: Tenga en cuenta los límites de propiedad de entorno.

Utilizar EB CLI

Para establecer una variable de entorno en EB CLI, ejecute el siguiente comando:

eb setenv key=value

En el siguiente ejemplo, se establece la variable de entorno ExampleVar:

$ eb setenv ExampleVar=ExampleValue
2018-07-11 21:05:25    INFO: Environment update is starting.
2018-07-11 21:05:29    INFO: Updating environment tmp-dev's configuration settings.
2018-07-11 21:06:50    INFO: Successfully deployed new configuration to environment.
2018-07-11 21:06:51    INFO: Environment update completed successfully.

Para configurar varias propiedades de entorno, utilice el siguiente comando:

$ eb setenv foo=bar JDBC_CONNECTION_STRING=hello PARAM4= PARAM5=

Utilizar las opciones de configuración

Puede utilizar los archivos de configuración de Elastic Beanstalk para establecer las propiedades del entorno y las opciones de configuración en el código fuente.

Para definir las propiedades del entorno, utilice el espacio de nombres aws:elasticbeanstalk:application:environment.

Consulte el siguiente ejemplo de .ebextensions/options.config:

option_settings:
  aws:elasticbeanstalk:application:environment:
    API_ENDPOINT: www.example.com/api

Para configurar las propiedades del entorno en AWS CLI, ejecute el siguiente comando:

$ aws elasticbeanstalk update-environment --environment-name my-env --option-settings file://options.json

Por ejemplo:

[
  {
    "Namespace": "aws:elasticbeanstalk:application:environment",
    "OptionName": "API_ENDPOINT",
    "Value": "www.example.com/api"
  },
  {
    "Namespace": "aws:elasticbeanstalk:application:environment",
    "OptionName": "URL",
    "Value": "http://myurl.com"
  }
]

Acceder a las variables de entorno

Nota: Las propiedades del entorno no se exportan automáticamente al shell, aunque estén presentes en la instancia. En cambio, las propiedades del entorno se ponen a disposición de la aplicación a través de la pila en la que se ejecuta, en función de la plataforma que utilice.

Para acceder a las variables de entorno, consulte Acceso a las propiedades del entorno.

Para acceder a las variables de entorno fuera del código de la aplicación (por ejemplo, en un script que se ejecuta durante el despliegue), utilice el script get.config.platform o Fn::GetOptionSetting.

Para las instancias de Windows, las propiedades del entorno se transfieren de C:\ProgramFiles\Amazon\ElasticBeanstalk\config\containerconfiguration al servidor de Microsoft Internet Information Services (IIS). Advertencia: La ubicación de este archivo está sujeta a la estructura de Elastic Beanstalk y se puede cambiar sin previo aviso.

---