Manifesto de ambiente (env.yaml) - AWS Elastic Beanstalk

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Manifesto de ambiente (env.yaml)

Você pode incluir um manifesto de ambiente formatado com YAML na raiz do seu pacote de origem do aplicativo para configurar o nome do ambiente, a pilha de soluções e os links do ambiente para usar ao criá-lo.

Este formato de arquivo inclui suporte para grupos do ambiente. Para usar grupos, especifique o nome do ambiente no manifesto com um símbolo + no final. Ao criar ou atualizar o ambiente, especifique o nome do grupo com --group-name (AWS CLI) ou --env-group-suffix (EB CLI). Para obter mais informações sobre grupos, consulte Criar e atualizar grupos de ambientes do Elastic Beanstalk.

O manifesto de exemplo a seguir define um ambiente de servidor Web com um link para um componente do ambiente de operador do qual ele depende. O manifesto usa grupos para permitir a criação de vários ambientes com o mesmo pacote de origem:

~/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+"

As seguintes chaves são compatíveis.

  • AWSConfigurationTemplateVersion (obrigatória): a versão do modelo de configuração (1.1.0.0).

    AWSConfigurationTemplateVersion: 1.1.0.0
  • Plataforma: o nome de recurso da Amazon (ARN) da versão da plataforma do ambiente. Você pode especificar a plataforma pelo ARN ou pelo nome da pilha de soluções.

    Platform: PlatformArn: arn:aws:elasticbeanstalk:us-east-2::platform/Java 8 running on 64bit Amazon Linux/2.5.0
  • SolutionStack: o nome completo da pilha de soluções usada para criar o ambiente.

    SolutionStack: 64bit Amazon Linux 2017.03 v2.5.0 running Java 8
  • OptionSettings: definições da opção de Configuration (Configuração) para aplicar ao ambiente. Por exemplo, a seguinte entrada define o tipo de instância como t2.micro.

    OptionSettings: aws:autoscaling:launchconfiguration: InstanceType: t2.micro
  • Tags: até 47 tags a serem aplicadas aos recursos criados no ambiente.

    Tags: Cost Center: WebApp Dev
  • EnvironmentTier: o tipo de ambiente a ser criado. Para um ambiente de servidor Web, você pode excluir esta seção (servidor Web é o padrão). Para um ambiente de operador, use o seguinte.

    EnvironmentTier: Name: Worker Type: SQS/HTTP
  • CName: o CNAME do ambiente. Incluir um caractere + no fim do nome para habilitar grupos.

    CName: front-A08G28LG+
  • EnvironmentName: o nome do ambiente a ser criado. Incluir um caractere + no fim do nome para habilitar grupos.

    EnvironmentName: front+

    Com os grupos habilitados, você deve especificar o nome do grupo ao criar os ambientes. O Elastic Beanstalk anexa o nome do grupo ao nome do ambiente com um hífen. Por exemplo, com o nome do ambiente front+ e o nome do grupo dev, o Elastic Beanstalk criará o ambiente com o nome front-dev.

  • EnvironmentLinks: um mapa de nomes de variáveis e de ambientes das dependências. O exemplo a seguir torna o ambiente worker+ uma dependência e instrui o Elastic Beanstalk a salvar as informações do link em uma variável denominada WORKERQUEUE.

    EnvironmentLinks: "WORKERQUEUE" : "worker+"

    O valor da variável de link muda de acordo com o tipo de ambiente vinculado. Para um ambiente de servidor Web, o link é o CNAME do ambiente. Para um ambiente de operador, o link é o nome da fila do Amazon Simple Queue Service (Amazon SQS) do ambiente.

É possível usar as chaves CName, EnvironmentName e EnvironmentLinks para criar grupos do ambiente e links para outros ambientes. Atualmente, esses recursos são suportados ao usar a EB CLI, a AWS CLI ou um SDK.