

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

# Criar uma política de ciclo de vida para um repositório no Amazon ECR
<a name="lp_creation"></a>

 Use uma política de ciclo de vida para criar um conjunto de regras que expiram ou arquivam imagens de repositório não utilizadas. Depois de criar uma política de ciclo de vida, as imagens afetadas expiram ou são arquivadas em 24 horas.

**nota**  
Se você estiver usando a replicação do Amazon ECR para fazer cópias de um repositório em diferentes regiões ou contas, tenha em mente que uma política de ciclo de vida só pode realizar uma ação em repositórios na região em que foi criada. Portanto, se você tiver a replicação ativada, convém criar uma política de ciclo de vida em cada região e conta para a qual estiver replicando os repositórios.

## Pré-requisito
<a name="lp-creation-prerequisite"></a>

**Prática recomendada:** crie uma prévia da política de ciclo de vida para verificar se as imagens expiradas ou arquivadas de acordo com suas regras de política de ciclo de vida são o que você pretende. Para instruções, consulte [Criar uma pré-visualização de política de ciclo de vida no Amazon ECR](lpp_creation.md).

## Como criar uma política de ciclo de vida (Console de gerenciamento da AWS)
<a name="lp-creation-console"></a>

1. Abra o console do Amazon ECR nos [https://console.aws.amazon.com/ecr/repositórios](https://console.aws.amazon.com/ecr/repositories).

1. Na barra de navegação, selecione a região que contém o repositório para o qual uma política de ciclo de vida será criada.

1. No painel de navegação, em **Registro privado**, escolha **Repositórios**.

1. Na página **Repositórios privados**, selecione um repositório e use o menu suspenso **Ações** para escolher **Políticas de ciclo de vida**.

1. Na página de regras de política de ciclo de vida do repositório, selecione **Criar regra**.

1. Insira os seguintes detalhes para sua a regra da política de ciclo de vida.

   1. Em **Prioridade de regra**, digite um número para a prioridade da regra. A prioridade da regra determina em que ordem as regras de políticas de ciclo de vida são aplicadas. Um número de prioridade de regra mais baixo significa maior prioridade. Por exemplo, uma regra com prioridade 1 tem precedência sobre uma regra com prioridade 2.

   1. Em **Descrição da regra**, digite uma descrição para a regra de política de ciclo de vida.

   1. Em **Status da imagem**, escolha **Marcado (correspondência de curingas)**, **Marcado (correspondência de prefixo)**, **Sem etiqueta** ou **Qualquer**.
**Importante**  
Se você especificar várias tags, apenas imagens com todas as tags especificadas serão selecionadas.

   1. Se escolher **Marcado (correspondência de curingas)** para **Status da imagem**, em **Especificar etiquetas para correspondência de curingas**, você poderá especificar uma lista de etiquetas de imagem com um curinga (**\***) para agir com sua política de ciclo de vida. Por exemplo, se as suas imagens forem marcadas como `prod`, `prod1`, `prod2` e assim por diante, você especificaria `prod*` para agir em todas elas. Se você especificar várias tags, apenas imagens com todas as tags especificadas serão selecionadas.
**Importante**  
Existe um limite máximo de quatro curingas (`*`) por string. Por exemplo, `["*test*1*2*3", "test*1*2*3*"]` é válido, mas `["test*1*2*3*4*5*6"]` é inválido.

   1. Se escolher **Marcado (correspondência de prefixo)** para **Status da imagem** e, em **Especificar etiquetas para correspondência de prefixo**, você poderá especificar uma lista de etiquetas de imagem nas quais agir com sua política de ciclo de vida.

   1. Em **Critérios de correspondência**, escolha **Dias desde a criação da imagem**, **Dias desde a última data de extração registrada**, **Dias desde o arquivamento da imagem** **ou Contagem** de imagens e, em seguida, especifique um valor.

   1. **Em Ação de regra**, escolha **Expirar** ou **Arquivar**.

   1. Escolha **Salvar**.

1. Crie regras de política de ciclo de vida adicionais repetindo as etapas de 5 a 7.

## Como criar uma política de ciclo de vida (AWS CLI)
<a name="lp-creation-cli"></a>

1. Obtenha o nome do repositório para o qual a política de ciclo de vida será criada.

   ```
   aws ecr describe-repositories
   ```

1. Crie um arquivo local chamado `policy.json` com o conteúdo da política de ciclo de vida. Para ver exemplos de política do ciclo de vida, consulte [Exemplos de políticas de ciclo de vida no Amazon ECR](lifecycle_policy_examples.md).

1. Crie uma política de ciclo de vida especificando o nome do repositório e referencie o arquivo JSON da política de ciclo de vida criado.

   ```
   aws ecr put-lifecycle-policy \
         --repository-name {{repository-name}} \
         --lifecycle-policy-text file://{{policy.json}}
   ```