

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`)
<a name="environment-cfg-manifest"></a>

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](environment-cfg-links.md) 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](environment-mgmt-compose.md).

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ório) — 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](concepts.platforms.md) usada para criar o ambiente.

  ```
  SolutionStack: {{64bit Amazon Linux 2017.03 v2.5.0 running Java 8}}
  ```
+ **OptionSettings**— Configurações das [opções de configuração](command-options.md) a serem aplicadas 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 para o 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 nomes de ambientes de 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.

As **EnvironmentLinks**teclas **CName**, **EnvironmentName**e podem ser usadas para criar [grupos de ambientes](environment-mgmt-compose.md) e [links para outros ambientes](environment-cfg-links.md). Atualmente, esses recursos são suportados ao usar o EB CLI AWS CLI ou um SDK.