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á.
# Usar configurações salvas do Elastic Beanstalk
Você pode salvar a configuração de seu ambiente como um objeto no Amazon Simple Storage Service (Amazon S3) para aplicar a outros ambientes durante a criação ou para aplicar a um ambiente em execução. *Configurações salvas* são modelos formatados em YAML que definem a [versão da plataforma](concepts.platforms.md), o [nível](concepts.md#concepts-tier), as definições das [opções de configuração](command-options.md) e as tags de um ambiente.
Você pode aplicar tags a uma configuração salva ao criá-la e editar tags de configurações salvas existentes. As tags aplicadas a uma configuração salva não estão relacionadas às tags especificadas em uma configuração salva que usa a chave `Tags:`. Os últimos são aplicados a um ambiente quando você aplica a configuração salva ao ambiente. Para obter detalhes, consulte [Marcação de configurações salvas](environment-configuration-savedconfig-tagging.md).
**nota**
Você pode criar e aplicar configurações salvas em seus ambientes do Elastic Beanstalk usando vários métodos. Isso inclui o console do Elastic Beanstalk, a CLI do EB e o AWS CLI.
Consulte os seguintes tópicos para ver exemplos de métodos alternativos de criação e aplicação de configurações salvas:
[Definir as opções de configuração antes da criação do ambiente](environment-configuration-methods-before.md)
[Definir as opções de configuração durante a criação do ambiente](environment-configuration-methods-during.md)
[Definir as opções de configuração depois da criação do ambiente](environment-configuration-methods-after.md)
Crie uma configuração salva com base no estado atual do ambiente no console de gerenciamento do Elastic Beanstalk.
**Para salvar a configuração de um ambiente**
1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS
1. No painel de navegação, selecione **Ambientes** e selecione o nome do ambiente na lista.
1. Escolha **Actions** (Ações) e depois **Save Configuration** (Salvar configuração).
1. Use o formulário na tela para nomear a configuração salva. Opcionalmente, forneça uma breve descrição e adicione chaves e valores de tag.
1. Escolha **Salvar**.
![\[Página Save Configuration (Salvar configuração) no console do Elastic Beanstalk\]](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/environment-cfg-saveconfiguration-dialog.png)
A configuração salva inclui todas as configurações aplicadas ao ambiente com o console ou qualquer outro cliente que usa a API do Elastic Beanstalk. Em seguida, você pode aplicar a configuração salva ao ambiente em uma data futura para restaurá-lo ao seu estado anterior ou aplicá-la a um novo ambiente durante a [criação dele](environments-create-wizard.md).
Você pode baixar uma configuração usando o [**eb config**](eb3-config.md) comando EB CLI, conforme mostrado no exemplo a seguir. *NAME*é o nome da configuração salva.
```
eb config get NAME
```
**Como aplicar uma configuração salva durante a criação do ambiente (console do Elastic Beanstalk)**
1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS
1. No painel de navegação, selecione **Aplicativos** e escolha o nome do aplicativo na lista.
1. No painel de navegação, encontre o nome do aplicativo e escolha **Saved configurations (Configurações salvas)**.
1. Selecione a configuração salva que deseja aplicar e escolha **Launch environment (Iniciar ambiente)**.
1. Continue no assistente para criar seu ambiente.
As configurações salvas não incluem as definições aplicadas com os [arquivos de configuração](ebextensions.md) no código-fonte de seu aplicativo. Se a mesma configuração for aplicada tanto em um arquivo de configuração quanto em uma configuração salva, a da configuração salva terá precedência. Da mesma forma, as opções especificadas no console do Elastic Beanstalk substituem as das configurações salvas. Para obter mais informações, consulte [Precedência](command-options.md#configuration-options-precedence).
As configurações salvas são armazenadas no bucket do S3 do Elastic Beanstalk em uma pasta com o mesmo nome da sua aplicação. Por exemplo, as configurações de uma aplicação chamada `my-app` na região us-west-2 da conta número 123456789012 podem ser encontradas em `s3://elasticbeanstalk-us-west-2-123456789012/resources/templates/my-app/`.
Visualize o conteúdo de uma configuração salva abrindo-a em um editor de texto. O exemplo a seguir mostra a configuração de um ambiente de servidor Web iniciado com o console de gerenciamento do Elastic Beanstalk.
```
EnvironmentConfigurationMetadata:
Description: Saved configuration from a multicontainer Docker environment created with the Elastic Beanstalk Management Console
DateCreated: '1520633151000'
DateModified: '1520633151000'
Platform:
PlatformArn: arn:aws:elasticbeanstalk:us-east-2::platform/Java 8 running on 64bit Amazon Linux/2.5.0
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
EnvironmentTier:
Type: Standard
Name: WebServer
AWSConfigurationTemplateVersion: 1.1.0.0
Tags:
Cost Center: WebApp Dev
```
Você pode modificar o conteúdo de uma configuração salva e salvá-lo no mesmo local no Amazon S3. Qualquer configuração salva formatada adequadamente armazenada no local certo pode ser aplicada a um ambiente usando o console de gerenciamento do Elastic Beanstalk.
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
```
**nota**
Você pode criar e aplicar configurações salvas em seus ambientes do Elastic Beanstalk usando vários métodos. Isso inclui o console do Elastic Beanstalk, a CLI do EB e o AWS CLI.
Consulte os seguintes tópicos para ver exemplos de métodos alternativos de criação e aplicação de configurações salvas:
[Definir as opções de configuração antes da criação do ambiente](environment-configuration-methods-before.md)
[Definir as opções de configuração durante a criação do ambiente](environment-configuration-methods-during.md)
[Definir as opções de configuração depois da criação do ambiente](environment-configuration-methods-after.md)
# Marcação de configurações salvas
Você pode aplicar tags às suas configurações AWS Elastic Beanstalk salvas. As tags são pares de valores-chave associados AWS aos recursos. Para obter informações sobre a atribuição de tags do recurso do Elastic Beanstalk, casos de uso, restrições de chave e valor de tag, além de tipos de recursos compatíveis, consulte [Marcar recursos da aplicação do Elastic Beanstalk](applications-tagging-resources.md).
Você pode especificar tags quando criar uma configuração salva. Em uma configuração salva existente, você pode adicionar ou remover tags e atualizar os valores de tags existentes. Você pode adicionar até 50 tags para cada configuração salva.
## Adicionar tags durante a criação de configurações salvas
Ao usar o console do Elastic Beanstalk para [salvar uma configuração](environment-configuration-savedconfig.md), é possível especificar chaves e valores de tags na página **Save Configuration (Salvar configuração)**.
Se você usar a CLI do EB para salvar uma configuração, use a opção `--tags` com **[eb config](eb3-config.md)** para adicionar tags.
```
~/workspace/my-app$ eb config --tags mytag1=value1,mytag2=value2
```
Com o AWS CLI ou outros clientes baseados em API, adicione tags usando o `--tags` parâmetro no **[create-configuration-template](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/create-configuration-template.html)** comando.
```
$ aws elasticbeanstalk create-configuration-template \
--tags Key=mytag1,Value=value1 Key=mytag2,Value=value2 \
--application-name my-app --template-name my-template --solution-stack-name solution-stack
```
## Gerenciar tags de uma configuração salva existente
É possível adicionar, atualizar e excluir tags em uma configuração salva existente do Elastic Beanstalk.
**Como gerenciar as tags de uma configuração salva usando o console do Elastic Beanstalk**
1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS
1. No painel de navegação, selecione **Aplicativos** e escolha o nome do aplicativo na lista.
1. No painel de navegação, encontre o nome do aplicativo e escolha **Saved configurations (Configurações salvas)**.
1. Selecione a configuração salva que deseja gerenciar.
1. Escolha **Actions (Ações)** e **Manage tags (Gerenciar tags)**.
1. Use o formulário na tela para adicionar, atualizar ou excluir tags.
1. Para salvar as alterações, escolha **Apply (Aplicar)** na parte inferior da página.
Se você usar a CLI do EB para atualizar a configuração salva, use **[eb tags](eb3-tags.md)** para adicionar, atualizar, excluir ou listar tags.
Por exemplo, o comando a seguir lista as tags em uma configuração salva.
```
~/workspace/my-app$ eb tags --list --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:configurationtemplate/my-app/my-template"
```
O comando a seguir atualiza a tag `mytag1` e exclui a tag `mytag2`.
```
~/workspace/my-app$ eb tags --update mytag1=newvalue --delete mytag2 \
--resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:configurationtemplate/my-app/my-template"
```
Para obter uma lista de opções e mais exemplos, consulte `eb tags`.
Com o AWS CLI ou outros clientes baseados em API, use o **[list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/list-tags-for-resource.html)** comando para listar as tags de uma configuração salva.
```
$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:configurationtemplate/my-app/my-template"
```
Use o comando **[update-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/update-tags-for-resource.html)** para adicionar, atualizar ou excluir tags em uma configuração salva.
```
$ aws elasticbeanstalk update-tags-for-resource \
--tags-to-add Key=mytag1,Value=newvalue --tags-to-remove mytag2 \
--resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:configurationtemplate/my-app/my-template"
```
Especifique as tags a serem adicionadas e atualizadas no parâmetro `--tags-to-add` do **update-tags-for-resource**. Uma tag não existente é adicionada, e o valor de uma tag existente é atualizado.
**nota**
Para usar alguns AWS CLI comandos e CLI do EB com uma configuração salva do Elastic Beanstalk, você precisa do ARN da configuração salva. Para construir o ARN, primeiro use o comando a seguir para recuperar o nome da configuração salva.
```
$ aws elasticbeanstalk describe-applications --application-names my-app
```
Procure a chave `ConfigurationTemplates` na saída do comando. Esse elemento mostra o nome da configuração salva. Use esse nome, em que `my-template` é especificado nos comandos mencionados nessa página.