Manifiesto del entorno (env.yaml) - AWS Elastic Beanstalk

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.

Manifiesto del entorno (env.yaml)

Puede incluir un manifiesto del entorno con formato YAML en la raíz de su paquete de código fuente de la aplicación para configurar el nombre del entorno, la pila de soluciones y los enlaces del entorno que desee usar al crear el entorno.

Este formato de archivo incluye compatibilidad con los grupos de entornos. Para utilizar grupos, especifique el nombre del entorno en el archivo de manifiesto con un signo + al final. Cuando cree o actualice el entorno, especifique el nombre de grupo con --group-name (AWS CLI) o --env-group-suffix (CLI de EB). Para obtener más información acerca de los grupos, consulte Creación y actualización de grupos de entornos de Elastic Beanstalk.

El siguiente manifiesto de ejemplo define un entorno de servidor web con un enlace a un componente del entorno de trabajo del que depende. El manifiesto utiliza grupos para permitir la creación de varios entornos con el mismo paquete de código fuente:

~/myapp/frontend/env.yaml

AWSConfigurationTemplateVersion: 1.1.0.0
SolutionStack: 64bit Amazon Linux 2015.09 v2.0.6 running Multi-container Docker 1.7.1 (Generic)
OptionSettings:
  aws:elasticbeanstalk:command:
    BatchSize: '30'
    BatchSizeType: Percentage
  aws:elasticbeanstalk:sns:topics:
    Notification Endpoint: me@example.com
  aws:elb:policies:
    ConnectionDrainingEnabled: true
    ConnectionDrainingTimeout: '20'
  aws:elb:loadbalancer:
    CrossZone: true
  aws:elasticbeanstalk:environment:
    ServiceRole: aws-elasticbeanstalk-service-role
  aws:elasticbeanstalk:application:
    Application Healthcheck URL: /
  aws:elasticbeanstalk:healthreporting:system:
    SystemType: enhanced
  aws:autoscaling:launchconfiguration:
    IamInstanceProfile: aws-elasticbeanstalk-ec2-role
    InstanceType: t2.micro
    EC2KeyName: workstation-uswest2
  aws:autoscaling:updatepolicy:rollingupdate:
    RollingUpdateType: Health
    RollingUpdateEnabled: true
Tags:
  Cost Center: WebApp Dev
CName: front-A08G28LG+
EnvironmentName: front+
EnvironmentLinks:
  "WORKERQUEUE" : "worker+"

Se admiten las siguientes claves.

  • AWSConfigurationTemplateVersion (obligatoria): la versión de la plantilla de configuración (1.1.0.0).

    AWSConfigurationTemplateVersion: 1.1.0.0

  • Platform: el nombre de recurso de Amazon (ARN) de la versión de la plataforma del entorno. Puede especificar la plataforma por ARN o el nombre de una pila de soluciones.

    Platform:
  PlatformArn: arn:aws:elasticbeanstalk:us-east-2::platform/Java 8 running on 64bit Amazon Linux/2.5.0

  • SolutionStack: el nombre completo de la pila de soluciones usada para crear el entorno.

    SolutionStack: 64bit Amazon Linux 2017.03 v2.5.0 running Java 8

  • OptionSettings: los valores de las opciones de configuración que se van a aplicar al entorno. Por ejemplo, la siguiente entrada establece el tipo de instancia en t2.micro.

    OptionSettings:
  aws:autoscaling:launchconfiguration:
    InstanceType: t2.micro

  • Tags: etiquetas (hasta un máximo de 47) que se aplican a los recursos creados en el entorno.

    Tags:
  Cost Center: WebApp Dev

  • EnvironmentTier: el tipo de entorno que se va a crear. Para un entorno de servidor web, puede excluir esta sección (servidor web es el valor predeterminado). Para un entorno de trabajo, use lo siguiente.

    EnvironmentTier:
  Name: Worker
  Type: SQS/HTTP

  • CName: el CNAME del entorno. Incluya un carácter + al final del nombre para habilitar grupos.

    CName: front-A08G28LG+

  • EnvironmentName: el nombre del entorno que se va a crear. Incluya un carácter + al final del nombre para habilitar grupos.

    EnvironmentName: front+

    Con los grupos habilitados, debe especificar un nombre de grupo al crear los entornos. Elastic Beanstalk añade el nombre de grupo al nombre del entorno con un guion. Por ejemplo, con el nombre de entorno front+ y el nombre de grupo dev, Elastic Beanstalk creará el entorno con el nombre front-dev.

  • EnvironmentLinks: un mapa de variables de entorno y nombres de dependencias del entorno. El siguiente ejemplo incluye en el entorno worker+ una dependencia e indica a Elastic Beanstalk que guarde la información del enlace en una variable denominada WORKERQUEUE.

    EnvironmentLinks:
  "WORKERQUEUE" : "worker+"

    El valor de la variable de enlace varía según el tipo de entorno vinculado. Para un entorno de servidor web, el enlace es el CNAME del entorno. Para un entorno de trabajo, el vínculo es el nombre de la cola del servicio Amazon Simple Queue (Amazon SQS) del entorno.

Las claves CName, EnvironmentName y EnvironmentLinks se pueden usar para crear grupos de entornos y enlaces a otros entornos. Estas características se admiten actualmente cuando se utiliza la CLI de EB, la AWS CLI o un SDK.