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á.
# Gerenciar versões de aplicativos
Este tópico explica as versões de aplicações e como criá-las e gerenciá-las.
O Elastic Beanstalk cria uma versão da aplicação sempre que você faz upload do código-fonte. Isso normalmente ocorre quando você cria um ambiente ou faz upload e implanta o código usando o [console de gerenciamento do ambiente](environments-console.md) ou a [CLI do EB](eb-cli3.md). O Elastic Beanstalk exclui essas versões da aplicação de acordo com a política de ciclo de vida da aplicação e quando a aplicação é excluída. Para obter detalhes sobre a política de ciclo de vida de aplicativo, consulte [Definir as configurações de ciclo de vida da versão do aplicativo](applications-lifecycle.md).
Também é possível fazer upload de um pacote de origem sem implantá-lo usando o [console de gerenciamento da aplicação](applications-console.md)ou com o comando **[**eb appversion**](eb3-appversion.md)** da EB CLI. O Elastic Beanstalk armazena pacotes de origem no Amazon Simple Storage Service (Amazon S3) e não os exclui automaticamente.
Você pode aplicar tags a uma versão do aplicativo ao criá-la e editar tags de versões existentes do aplicativo. Para obter detalhes, consulte [Atribuir tags em versões do aplicativo](applications-versions-tagging.md).
## Criação de versões de aplicações
Você também pode criar outra versão da aplicação usando a EB CLI. Para obter mais informações, consulte [**eb appversion**](eb3-appversion.md) no capítulo *Comandos da EB CLI*.
**nota**
Com o tempo, seu aplicativo pode acumular várias versões do aplicativo. Para economizar espaço de armazenamento e evitar atingir a [cota de versões da aplicação](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_elastic_beanstalk), é recomendável excluir versões da aplicação que não são mais necessárias.
O arquivo especificado no procedimento a seguir está associado à sua aplicação. Você pode implantar a versão do aplicativo em um ambiente novo ou existente.
**Criar uma nova versão da aplicação**
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 **Application versions (Versões do aplicativo)**.
1. Escolha **Carregar**. Use o formulário na tela para carregar o [pacote de origem](applications-sourcebundle.md) do aplicativo.
**nota**
O tamanho máximo do arquivo do pacote de fontes é 500 MB.
1. Opcionalmente, forneça uma breve descrição e adicione chaves e valores de tag.
1. Escolha **Carregar**.
## Exclusão de versões de aplicações
Você também pode excluir uma versão da aplicação usando a EB CLI. Para obter mais informações, consulte [**eb appversion**](eb3-appversion.md) no capítulo *Comandos da EB CLI*.
**nota**
A exclusão de uma versão do aplicativo não afeta os ambientes que a estão executando no momento.
Também é possível configurar o Elastic Beanstalk para excluir versões antigas automaticamente ao definir as configurações do ciclo de vida de versões da aplicação. Se você definir essas configurações de ciclo de vida do aplicativo, elas serão aplicadas a novas versões do aplicativo. Por exemplo, se você configurar, no máximo, 25 versões da aplicação, o Elastic Beanstalk excluirá a versão mais antiga quando você fizer upload da 26ª versão. Se você definir um período máximo de 90 dias, todas as versões com mais de 90 dias serão excluídas quando você fizer upload de uma nova versão. Para obter detalhes, consulte [Definir as configurações de ciclo de vida da versão do aplicativo](applications-lifecycle.md).
**Excluir uma versão da aplicação**
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 **Application versions (Versões do aplicativo)**.
1. Selecione uma ou mais versões do aplicativo que você deseja excluir.
1. Escolha **Ações** e **Excluir**.
1. (Opcional) Para deixar o pacote de origem da aplicação para essas versões de aplicações no bucket do Amazon Simple Storage Service (Amazon S3), desmarque a caixa **Delete versions from Amazon S3 (Excluir versões do Amazon S3)**.
1. Escolha **Excluir**.
Se você não optar por excluir o pacote de origem do Amazon S3, o Elastic Beanstalk ainda excluirá a versão de seus registros. No entanto, o pacote de origem é deixado no [bucket de armazenamento do Elastic Beanstalk](AWSHowTo.S3.md). A cota de versões da aplicação se aplica apenas a versões monitoradas pelo Elastic Beanstalk. Portanto, se for necessário, você poderá excluir versões para se manter dentro da cota, mas retenha todos os pacotes de origem no Amazon S3.
**nota**
A cota de versões da aplicação não se aplica a pacotes de origem, mas ainda assim pode haver cobranças do Amazon S3 e reter informações pessoais além do tempo necessário. O Elastic Beanstalk nunca exclui pacotes de origem automaticamente. Você deve excluir os pacotes de origem quando não precisar mais deles.
# Definir as configurações de ciclo de vida da versão do aplicativo
Este tópico explica as políticas e cotas que o Elastic Beanstalk aplica às versões da sua aplicação em um determinado ambiente, incluindo por quanto tempo uma versão da aplicação permanece em um ambiente.
Cada vez que você faz upload de uma nova versão da sua aplicação com o console do Elastic Beanstalk ou a CLI do EB, o Elastic Beanstalk cria uma [versão da aplicação](applications-versions.md). Se você não excluir as versões que não usa mais, acabará atingindo a [cota de versões da aplicação](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html#limits_elastic_beanstalk) e não poderá criar novas versões dela.
Você pode evitar atingir a cota aplicando uma *política de ciclo de vida de versão do aplicativo* aos aplicativos. Uma política de ciclo de vida instrui o Elastic Beanstalk a excluir versões da aplicação antigas ou excluí-las quando o total de versões de uma determinada aplicação excede um número especificado.
O Elastic Beanstalk aplica uma política de ciclo de vida de uma aplicação cada vez que uma nova versão da aplicação é aplicada e exclui até 100 versões cada vez que a política de ciclo de vida é aplicada. O Elastic Beanstalk exclui versões antigas depois de criar a nova versão e não considera a nova versão no número máximo de versões definido na política.
O Elastic Beanstalk não exclui versões da aplicação que estão sendo usadas por um ambiente nem versões da aplicação implantadas em ambientes que foram encerrados menos de dez semanas antes do acionamento da política.
A cota de versões do aplicativo é utilizada em todos os aplicativos em uma região. Se você tiver vários aplicativos, configure cada um com uma política de ciclo de vida adequada para evitar atingir a cota. Por exemplo, se você tiver 10 aplicações em uma região e a cota for 1.000 versões da aplicação, considere definir uma política de ciclo de vida com uma cota de 99 versões para todas as aplicações ou definir outros valores em cada aplicação, desde que o total seja inferior a 1.000 versões. O Elastic Beanstalk somente aplicará a política se a criação da versão da aplicação for bem-sucedida, portanto, se você já atingiu a cota, deverá excluir algumas versões manualmente antes de criar uma nova.
Por padrão, o Elastic Beanstalk deixa o [pacote de origem](applications-sourcebundle.md) da versão da aplicação no Amazon S3 para evitar a perda de dados. Você pode excluir esse pacote para economizar espaço.
Você pode definir as configurações do ciclo de vida por meio da CLI do Elastic Beanstalk e. APIs Consulte[**eb appversion**](eb3-appversion.md), [CreateApplication](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_CreateApplication.html)(usando o `ResourceLifecycleConfig` parâmetro) e [UpdateApplicationResourceLifecycle](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_UpdateApplicationResourceLifecycle.html)para obter detalhes.
## Definir as configurações de ciclo de vida do aplicativo no console
É possível especificar as configurações do ciclo de vida no console do Elastic Beanstalk.
**Como especificar configurações de ciclo de vida do seu aplicativo**
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 **Application versions (Versões do aplicativo)**.
1. Escolha **Configurações**.
1. Use o formulário na tela para definir as configurações do ciclo de vida do aplicativo.
1. Escolha **Salvar**.
Na página de configurações, você pode fazer o seguinte:
+ Defina as configurações do ciclo de vida com base na contagem total de versões do aplicativo ou na idade das versões do aplicativo.
+ Especifique se deseja excluir o pacote de origem do S3 quando a versão do aplicativo for excluída.
+ Especifique a função de serviço na qual a versão do aplicativo é excluída. Para incluir todas as permissões necessárias para a exclusão da versão, escolha a função de serviço padrão do Elastic Beanstalk, denominada `aws-elasticbeanstalk-service-role`, ou outra função de serviço usando as políticas de serviço gerenciadas do Elastic Beanstalk. Para obter mais informações, consulte [Gerenciar funções de serviço do Elastic Beanstalk](iam-servicerole.md).
# Atribuir tags em versões do aplicativo
Este tópico explica os benefícios de marcar as versões da aplicação Elastic Beanstalk e como gerenciar as etiquetas.
Você pode aplicar tags às versões do seu AWS Elastic Beanstalk aplicativo. 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 versão do aplicativo. Em uma versão de aplicativo existente, você pode adicionar ou remover tags e atualizar os valores de tags existentes. Você pode adicionar até 50 tags para cada versão do aplicativo.
## Adicionar tags durante a criação da versão do aplicativo
Ao usar o console do Elastic Beanstalk para [criar um ambiente](environments-create-wizard.md) e optar por fazer upload de uma versão do código da aplicação, você pode especificar chaves e valores de tags para associar à nova versão da aplicação.
Também é possível usar o console do Elastic Beanstalk para [fazer upload de uma versão da aplicação](applications-versions.md) sem usá-lo imediatamente em um ambiente. Você pode especificar valores e chaves de tag ao carregar uma versão do aplicativo.
Com o AWS CLI ou outros clientes baseados em API, adicione tags usando o `--tags` parâmetro no **[create-application-version](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/create-application-version.html)** comando.
```
$ aws elasticbeanstalk create-application-version \
--tags Key=mytag1,Value=value1 Key=mytag2,Value=value2 \
--application-name my-app --version-label v1
```
Quando você usa a CLI do EB para criar ou atualizar um ambiente, uma versão do aplicativo é criada a partir do código implementado. Não há uma maneira direta de atribuir uma tag a uma versão do aplicativo durante sua criação por meio da CLI do EB. Consulte a seção a seguir para saber como adicionar tags a uma versão do aplicativo existente.
## Gerenciar tags de uma versão do aplicativo existente
É possível adicionar, atualizar e excluir tags em uma versão existente da aplicação do Elastic Beanstalk.
**Como gerenciar as tags de uma versão da aplicação 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 **Application versions (Versões do aplicativo)**.
1. Selecione a versão do aplicativo que você 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 versão do aplicativo, use **[eb tags](eb3-tags.md)** para adicionar, atualizar, excluir ou listar tags.
Por exemplo, o comando a seguir lista as tags em uma versão do aplicativo.
```
~/workspace/my-app$ eb tags --list --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:applicationversion/my-app/my-version"
```
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:applicationversion/my-app/my-version"
```
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 versão do aplicativo.
```
$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:applicationversion/my-app/my-version"
```
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 versão do aplicação.
```
$ 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:applicationversion/my-app/my-version"
```
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 versão do aplicativo Elastic Beanstalk, você precisa do ARN da versão do aplicativo. Você pode recuperar o ARN usando o comando a seguir.
```
$ aws elasticbeanstalk describe-application-versions --application-name my-app --version-label my-version
```