

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á.

# Criando ambientes para seu aplicativo em AWS AppConfig
<a name="appconfig-creating-environment"></a>

Para cada AWS AppConfig aplicativo, você define um ou mais ambientes. Um ambiente é um grupo lógico de AppConfig destinos de implantação, como aplicativos em um `Beta` `Production` ambiente, AWS Lambda funções ou contêineres. Também é possível definir ambientes para subcomponentes de aplicativos, como os componentes `Web`, `Mobile` e `Back-end`. Você pode configurar CloudWatch alarmes da Amazon para cada ambiente. O sistema monitora os alarmes durante uma implantação de configuração. Se um alarme for acionado, o sistema reverterá a configuração. 

**Antes de começar**  
Se você quiser ativar AWS AppConfig a reversão de uma configuração em resposta a um CloudWatch alarme, deverá configurar uma função AWS Identity and Access Management (IAM) com permissões para permitir a resposta AWS AppConfig aos CloudWatch alarmes. Escolha essa função no procedimento a seguir. Para obter mais informações, consulte [Configurar permissões para reversão automática](setting-up-appconfig.md#getting-started-with-appconfig-cloudwatch-alarms-permissions).

**Topics**
+ [Criando um AWS AppConfig ambiente (console)](#appconfig-creating-environment-console)
+ [Criando um AWS AppConfig ambiente (linha de comando)](#appconfig-creating-environment-commandline)

## Criando um AWS AppConfig ambiente (console)
<a name="appconfig-creating-environment-console"></a>

Use o procedimento a seguir para criar um AWS AppConfig ambiente usando o AWS Systems Manager console.

**Para criar um ambiente**

1. Abra o AWS Systems Manager console em [https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/).

1. No painel de navegação, selecione **Aplicações** e escolha o nome de uma aplicação para abrir a página de detalhes.

1. Selecione **Ambientes** e escolha **Criar ambiente**.

1. Em **Name (Nome)**, insira um nome para o ambiente.

1. Em **Description (Descrição)**, insira informações sobre o ambiente.

1. (Opcional) Na seção **Monitores**, escolha o campo **perfil do IAM** e, depois, escolha o perfil do IAM com permissão para chamar `cloudwatch:DescribeAlarms` nas métricas que você quer monitorar para alarmes.

1. Na lista de **CloudWatch alarmes**, insira nos Amazon Resource Names (ARNs) uma ou mais métricas para monitorar. AWS AppConfig reverte a implantação da configuração se uma dessas métricas entrar em um `ALARM` estado. Para ter informações sobre as métricas recomendadas, consulte [Monitorar implantações para reversão automática](monitoring-deployments.md).

1. (Opcional) Na seção **Associar extensões**, selecione uma extensão na lista. Para obter mais informações, consulte [Entendendo AWS AppConfig as extensões](working-with-appconfig-extensions-about.md).

1. (Opcional) Na seção **Tags**, insira uma chave e um valor opcional. Você pode especificar um máximo de 50 tags para um recurso. 

1. Selecione **Criar ambiente**.

AWS AppConfig cria o ambiente e, em seguida, exibe a página de **detalhes do ambiente**. Vá para [Criando um perfil de configuração no AWS AppConfig](appconfig-creating-configuration-profile.md).

## Criando um AWS AppConfig ambiente (linha de comando)
<a name="appconfig-creating-environment-commandline"></a>

O procedimento a seguir descreve como usar o AWS CLI (no Linux ou no Windows) ou Ferramentas da AWS para PowerShell criar um AWS AppConfig ambiente.

**Para criar um ambiente passo a passo**

1. Abra AWS CLI o.

1. Execute o seguinte comando para criar um ambiente. 

------
#### [ Linux ]

   ```
   aws appconfig create-environment \
     --application-id {{The_application_ID}} \
     --name {{A_name_for_the_environment}} \
     --description {{A_description_of_the_environment}} \
     --monitors "AlarmArn={{ARN_of_the_Amazon_CloudWatch_alarm}},AlarmArnRole={{ARN_of_the_IAM role_for_AWS AppConfig_to_monitor_AlarmArn}}" \
     --tags {{User_defined_key_value_pair_metadata_of_the_environment}}
   ```

------
#### [ Windows ]

   ```
   aws appconfig create-environment ^
     --application-id {{The_application_ID}} ^
     --name {{A_name_for_the_environment}} ^
     --description {{A_description_of_the_environment}} ^
     --monitors "AlarmArn={{ARN_of_the_Amazon_CloudWatch_alarm}},AlarmArnRole={{ARN_of_the_IAM role_for_AWS AppConfig_to_monitor_AlarmArn}}" ^
     --tags {{User_defined_key_value_pair_metadata_of_the_environment}}
   ```

------
#### [ PowerShell ]

   ```
   New-APPCEnvironment `
     -Name {{Name_for_the_environment}} `
     -ApplicationId {{The_application_ID}}
     -Description {{Description_of_the_environment}} `
     -Monitors @{"AlarmArn={{ARN_of_the_Amazon_CloudWatch_alarm}},AlarmArnRole={{ARN_of_the_IAM role_for_AWS AppConfig_to_monitor_AlarmArn}}"} `
     -Tag {{Hashtable_type_user_defined_key_value_pair_metadata_of_the_environment}}
   ```

------

   O sistema retorna informações como estas.

------
#### [ Linux ]

   ```
   {
      "ApplicationId": "The application ID",
      "Id": "The_environment ID",
      "Name": "Name of the environment",
      "State": "The state of the environment",
      "Description": "Description of the environment",
      
      "Monitors": [ 
         { 
            "AlarmArn": "ARN of the Amazon CloudWatch alarm",
            "AlarmRoleArn": "ARN of the IAM role for AppConfig to monitor AlarmArn"
         }
      ]  
   }
   ```

------
#### [ Windows ]

   ```
   {
      "ApplicationId": "The application ID",
      "Id": "The environment ID",
      "Name": "Name of the environment",
      "State": "The state of the environment"
      "Description": "Description of the environment",
      
      "Monitors": [ 
         { 
            "AlarmArn": "ARN of the Amazon CloudWatch alarm",
            "AlarmRoleArn": "ARN of the IAM role for AppConfig to monitor AlarmArn"
         }
      ] 
   }
   ```

------
#### [ PowerShell ]

   ```
   ApplicationId     : The application ID
   ContentLength     : Runtime of the command
   Description       : Description of the environment
   HttpStatusCode    : HTTP Status of the runtime
   Id                : The environment ID
   Monitors          : {ARN of the Amazon CloudWatch alarm, ARN of the IAM role for AppConfig to monitor AlarmArn}
   Name              : Name of the environment
   Response Metadata : Runtime Metadata
   State             : State of the environment
   ```

------

Vá para [Criando um perfil de configuração no AWS AppConfig](appconfig-creating-configuration-profile.md).