Políticas de ciclo de vida - Amazon ECR

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

Políticas de ciclo de vida

Amazon ECRAs políticas de ciclo de vida do permitem que você especifique o gerenciamento do ciclo de vida das imagens em um repositório. Uma política de ciclo de vida é um conjunto de uma ou mais regras em que cada regra define uma ação do Amazon ECR. As ações aplicam-se a imagens que contêm tags prefixadas de determinadas strings. Isso permite a automação da limpeza de imagens não usadas, por exemplo imagens prestes a expirar com base em seu tempo de vida ou contagem. Após criar uma política de ciclo de vida, você deve esperar que as imagens afetadas expirem em 24 horas.

Modelo da apólice do ciclo de vida

O conteúdo da sua política de ciclo de vida é avaliado antes de ser associado a um repositório. Veja a seguir o modelo de sintaxe JSON de política de ciclo de vida. Para ver exemplos de política do ciclo de vida, consulte Exemplos de políticas do ciclo de vida.

{ "rules": [ { "rulePriority": integer, "description": "string", "selection": { "tagStatus": "tagged"|"untagged"|"any", "tagPrefixList": list<string>, "countType": "imageCountMoreThan"|"sinceImagePushed", "countUnit": "string", "countNumber": integer }, "action": { "type": "expire" } } ] }
nota

O tagPrefixList parâmetro só é utilizado se tagStatus é tagged. O countUnit parâmetro só é utilizado se countType é sinceImagePushed. O countNumber parâmetro só é utilizado se countType está definido para imageCountMoreThan.

Parâmetros da política do ciclo de vida

As políticas de ciclo de vida são divididas nas partes a seguir:

Prioridade da regra

rulePriority

Tipo: inteiro.

Obrigatório: sim

Define a ordem em que as regras são avaliadas, da menor para a maior. Uma regra da política do ciclo de vida com uma prioridade de 1 será atuado primeiro, uma regra com prioridade de 2 será seguinte, e por isso em. Quando adiciona regras a uma política do ciclo de vida, tem de dar-lhes um valor único para rulePriority. Os valores não precisam de ser sequenciais em todas as regras de uma apólice. Uma regra com um tagStatus valor de any tem de ter o valor mais elevado para rulePriority e ser avaliado em último lugar.

Description

description

Tipo: string.

Obrigatório: não

(Opcional) Descreve a finalidade de uma regra em uma política de ciclo de vida.

Estado da etiqueta

tagStatus

Tipo: string.

Obrigatório: sim

Determina se a regra da política de ciclo de vida que você está adicionando especifica uma tag para uma imagem. As opções aceitáveis são tagged, untagged, ou any. Se especificar any, então todas as imagens têm a regra que lhes foi aplicada. Se especificar tagged, então tem também de especificar uma tagPrefixList valor. Se você especificar untagged, você deverá omitir tagPrefixList.

Lista de prefixo de etiquetas

tagPrefixList

Tipo: list[string]

Exigido: sim, somente se tagStatus for definido como tagged

Apenas utilizado se especificado "tagStatus": "tagged". Tem de especificar uma lista de prefixos de etiquetas de imagem separadas por vírgulas para tomar medidas com a sua política de ciclo de vida. Por exemplo, se as suas imagens forem marcadas como prod, prod1, prod2, etc., utilizaria o prefixo da etiqueta prod para especificar todos os. Se você especificar várias tags, apenas imagens com todas as tags especificadas serão selecionadas.

Tipo de contagem

countType

Tipo: string.

Obrigatório: sim

Especifique um tipo de contagem a ser aplicado às imagens.

Se countType está definido para imageCountMoreThan, também especifica countNumber para criar uma regra que defina um limite no número de imagens que existem no seu repositório. Se countType está definido para sinceImagePushed, também especifica countUnit e countNumber para especificar um limite de tempo nas imagens que existem no seu repositório.

Unidade de contagem

countUnit

Tipo: string.

Exigido: sim, somente se countType for definido como sinceImagePushed

Especifique uma unidade de contagem de days para indicar que como a unidade de tempo, para além de countNumber, que é o número de dias.

Isto só deve ser especificado quando countType é sinceImagePushed um erro ocorre se especificar uma unidade de contagem quando countType qualquer outro valor.

Contagem numérica

countNumber

Tipo: inteiro.

Obrigatório: sim

Especifique um número de contagem. Os valores aceitáveis são inteiros positivos (0 não é um valor aceito).

Se o countType é imageCountMoreThan, então o valor é o número máximo de imagens que pretende reter no seu repositório. Se o countType é sinceImagePushed, então o valor é o limite de idade máximo para as suas imagens.

Action

type

Tipo: string.

Obrigatório: sim

Especifique um tipo de ação. O valor suportado é expire.

Regras de avaliação da política do ciclo de vida

O avaliador da política de ciclo de vida é responsável por analisar o JSON em formato de texto simples e aplicá-lo a imagens no repositório especificado. As seguintes regras devem ser notadas ao criar uma política de ciclo de vida:

  • Uma imagem é expirada por exatamente uma ou nenhuma regra.

  • Uma imagem que corresponde aos requisitos de marcação de uma regra não pode ser expirada por uma regra com uma prioridade inferior.

  • As regras nunca podem marcar imagens marcadas por regras de maior prioridade, mas ainda podem identificá-las como se não tivessem expirado.

  • O conjunto de regras deve conter um conjunto exclusivo de prefixos de tags.

  • Somente uma regra é permitida para selecionar imagens não marcadas.

  • A expiração é sempre solicitada por pushed_at_time e expira sempre as imagens mais antigas antes das mais novas.

  • Quando utilizar o tagPrefixList, uma imagem corresponde com sucesso se todos das etiquetas no tagPrefixList o valor é correspondente a qualquer uma das etiquetas da imagem.

  • Com countType = imageCountMoreThan, as imagens são ordenadas do mais novo para o mais antigo com base em pushed_at_time e depois todas as imagens superiores à contagem especificada expiraram.

  • Com countType = sinceImagePushed, todas as imagens que pushed_at_time é anterior ao número de dias especificado com base em countNumber expirou.