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.