Etiquetar um repositório privado

Para ajudar você a gerenciar os repositórios do Amazon ECR, é possível atribuir seus próprios metadados a cada repositório na forma de tags de recursos da AWS. Este tópico descreve as tags de recursos da AWS e mostra como criá-las.

Conceitos básicos de tags

Uma tag é um rótulo atribuído a um recurso da AWS. Cada tag consiste em uma chave e um valor, ambos definidos por você.

As tags permitem categorizar seus recursos da AWS de diferentes formas (como por finalidade, por proprietário ou por ambiente). Isso é útil quando há muitos recursos do mesmo tipo; você pode identificar rapidamente um recurso específico com base nas tags atribuídas a ele. Por exemplo, você pode definir um conjunto de tags para os repositórios do Amazon ECR da sua conta para ajudar a rastrear o proprietário de cada repositório.

Recomendamos que você desenvolva um conjunto de chave de tags que atenda suas necessidades. Usar um conjunto consistente de chaves de tags facilita para você gerenciar seus recursos. É possível pesquisar e filtrar os recursos de acordo com as tags que adicionar.

As tags não têm significado semântico no Amazon ECR e são interpretadas estritamente como uma sequência dos caracteres. Além disso, as tags não são automaticamente atribuídas aos seus recursos. É possível editar chaves de tags e valores, e é possível remover as tags de um recurso a qualquer momento. É possível definir o valor de uma tag a uma string vazia, mas não pode configurar o valor de um tag como nula. Se você adicionar uma tag que tenha a mesma chave de uma tag existente nesse recurso, o novo valor substituirá o antigo. Se você excluir um recurso, todas as tags do recurso também serão excluídas.

Você pode trabalhar com tags usando o AWS Management Console, a AWS CLI e a API do Amazon ECR .

Se você estiver usando o AWS Identity and Access Management (IAM), pode controlar quais usuários na sua conta da AWS têm permissão para criar, editar ou excluir tags.

Marcar recursos

É possível marcar repositórios novos ou existentes do Amazon ECR.

Se você estiver usando o console do Amazon ECR, pode aplicar tags aos novos recursos quando eles forem criados ou aos recursos existentes usando a opção Tags no painel de navegação a qualquer momento.

Se estiver usando a API do Amazon ECR, a AWS CLI ou um AWS, você pode aplicar etiquetas a novos repositórios usando o parâmetro tags na ação CreateRepository da API ou usar a ação TagResource da API para aplicar etiquetas a recursos existentes. Para obter mais informações, consulte TagResource.

Além disso, se as tags não puderem ser aplicadas durante a criação do repositório, nós reverteremos o processo de criação do repositório. Isso garante que os repositórios sejam criados com tags ou, então, não criados, e que nenhum repositório seja deixado sem tags. Ao marcar com tags os repositórios no momento da criação, você elimina a necessidade de executar scripts personalizados de uso de tags após a criação do repositório.

Restrições de tags

As restrições básicas a seguir se aplicam às tags:

• Número máximo de tags por repositório: 50

• Em todos os repositórios, cada chave de tag deve ser exclusiva e pode ter apenas um valor.

• Comprimento máximo da chave: 128 caracteres Unicode em UTF-8

• Comprimento máximo do valor: 256 caracteres Unicode em UTF-8

• Se seu esquema de tags é usado em vários serviços e recursos, lembre-se de que outros serviços podem ter restrições nos caracteres permitidos. Em geral, os caracteres permitidos são: letras, números e espaços representáveis em UTF-8 e os seguintes caracteres: + - = . _ : / @.

• As chaves e os valores de tags diferenciam maiúsculas de minúsculas.

• Não use o prefixo aws: para chaves ou valores, pois ele é reservado para uso da AWS. Você não pode editar nem excluir chaves nem valores de tag com esse prefixo. As tags com esse prefixo não contam para as tags por limite de recurso.

Marcar recursos para faturamento

As tags que você adiciona aos repositórios do Amazon ECR são úteis para analisar a alocação de custos depois de habilitá-las em seu Relatório de custo e uso. Para obter mais informações, consulte Relatórios de uso do Amazon ECR.

Para ver o custo dos recursos combinados, é possível organizar as informações de faturamento com base nos recursos com os mesmos valores da chave da tag. Por exemplo, é possível etiquetar vários recursos com um nome de aplicação específico, e depois organizar suas informações de faturamento para ver o custo total daquela aplicação em vários serviços. Para obter mais informações sobre como configurar um relatório de alocação de custos com tags, consulte Relatório mensal de alocação de custos no Manual do usuário do AWS Billing.

nota

Se você tiver acabado de habilitar a criação de relatórios, os dados do mês atual estarão disponíveis para visualização após 24 horas.

Trabalhar com tags usando o console

Com o console do Amazon ECR, é possível gerenciar as tags associadas a repositórios novos ou existentes.

Quando seleciona um repositório específico no console do Amazon ECR, você pode visualizar as tags selecionando Tags no painel de navegação.

Para adicionar uma tag a um repositório (AWS Management Console)

1. Abra o console do Amazon ECR em https://console.aws.amazon.com/ecr/.

2. Na barra de navegação, selecione a região a ser usada.

3. No painel de navegação, escolha Repositories (Repositórios).

4. Na página Repositórios, marque a caixa de seleção ao lado do repositório que você deseja marcar.

5. No menu Ação, selecione Tags do repositório.

6. Na página Tags do repositório, selecione Adicionar tags, Adicionar tag.

7. Na página Editar tags do repositório, especifique a chave e o valor de cada tag e escolha Salvar.

Para excluir uma tag de um recurso individual (AWS Management Console)

1. Abra o console do Amazon ECR em https://console.aws.amazon.com/ecr/.

2. Na barra de navegação, selecione a região a ser usada.

3. Na página Repositórios, marque a caixa de seleção ao lado do repositório do qual você deseja remover uma tag.

4. No menu Ação, selecione Tags do repositório.

5. Na página Tags do repositório, selecione Editar.

6. Na página Editar tags do repositório, selecione Remover para cada tag que você desejar excluir e escolha Salvar.

Trabalho com tags usando a AWS CLI ou a API

Use o seguinte para adicionar, atualizar, listar e excluir as tags para seus recursos. A documentação correspondente traz exemplos.

Suporte à marcação para recursos do Amazon ECR
Tarefa	AWS CLI	Ação de API
Adicione ou sobrescreva uma ou mais tags.	tag-resource	TagResource
Exclua uma ou mais tags.	untag-resource	UntagResource

Os exemplos a seguir mostram como gerenciar tags usando a AWS CLI.

Exemplo 1: marcar um repositório existente

O comando a seguir marca um repositório existente.

aws ecr tag-resource \
     --resource-arn arn:aws:ecr:region:account_id:repository/repository_name \
     --tags Key=stack,Value=dev

Exemplo 2: marcar um repositório existente com várias tags

O comando a seguir marca um repositório existente.

aws ecr tag-resource \
     --resource-arn arn:aws:ecr:region:account_id:repository/repository_name \
     --tags Key=key1,Value=value1 Key=key2,Value=value2 Key=key3,Value=value3

Exemplo 3: desmarcar um repositório existente

O comando a seguir exclui uma tag de um repositório existente.

aws ecr untag-resource \
     --resource-arn arn:aws:ecr:region:account_id:repository/repository_name \
     --tag-keys tag_key

Exemplo 4: listar tags de um repositório

O comando a seguir lista as tags associadas a um repositório existente.

aws ecr list-tags-for-resource \
     --resource-arn arn:aws:ecr:region:account_id:repository/repository_name

Exemplo 5: criar um repositório e aplicar uma tag

O comando a seguir cria um repositório chamado test-repo e adiciona uma tag com a chave team e o valor devs.

aws ecr create-repository \
     --repository-name test-repo \
     --tags Key=team,Value=devs