Gerenciar imagens

Nesta página, explicamos como gerenciar imagens de contêiner em um repositório do Docker. Gerenciar imagens inclui listar imagens em um repositório, adicionar tags, excluir tags, copiar imagens para um novo repositório e excluir imagens.

Para informações sobre como enviar e extrair imagens, consulte Como enviar e extrair imagens.

Antes de começar

1. Se não existir um repositório de destino, crie um novo repositório.
2. Verifique se você tem as permissões necessárias para o repositório.
3. (Opcional) Configure padrões para comandos gcloud.

Funções exigidas

Para ter as permissões necessárias para gerenciar imagens, peça ao administrador para conceder a você os seguintes papéis do IAM no repositório:

• Visualizar imagens, arquivos em imagens e tags: Leitor do Artifact Registry (roles/artifactregistry.reader)
• Marque imagens ou edite tags usando o Artifact Registry: Gravador do Artifact Registry (roles/artifactregistry.writer)
• Excluir imagens ou remover tags: Administrador do repositório do Artifact Registry (roles/artifactregistry.repoAdmin)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Você também pode conseguir as permissões necessárias por meio de tags personalizadas ou outras funções predefinidas papéis.

Listar imagens

Modos de repositório: padrão, remoto

É possível listar as imagens usando o console do Google Cloud ou CLI gcloud.

gcloud artifacts docker images list

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
--include-tags

us-west1-docker.pkg.dev/my-project/my-repo

us-west1-docker.pkg.dev/my-project/my-repo/my-image

Como listar arquivos

Modos de repositório: padrão, remoto

É possível listar arquivos em um repositório, arquivos em todas as versões de um imagem de contêiner ou arquivos em uma versão específica de uma imagem.

Para todos os comandos a seguir, você pode definir um número máximo de arquivos a serem retornados adicionando a sinalização --limit ao comando.

Para listar todos os arquivos no projeto, repositório e local quando os valores padrão estiverem configurados:

gcloud artifacts files list

Para listar arquivos em um projeto, repositório e local especificados, execute o comando:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

Para listar arquivos de todas as versões de uma imagem de contêiner específica:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

Para listar arquivos de uma versão específica da imagem do contêiner:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --tag=TAG

Substitua os seguintes valores:

• LOCATION: o regional ou multirregional local do repositório.
• PROJECT: seuID de projeto no Google Cloud. Caso o ID do projeto contenha dois pontos (`:`), consulte Projetos com escopo de domínio.
• REPOSITORY: o nome do repositório em que a imagem são armazenados.
• PACKAGE: o nome da imagem.
• VERSION: resumo da imagem, uma string que começa com sha256:.
• TAG: a tag associada à imagem do contêiner.

Exemplos

Considere as seguintes informações da imagem:

• Projeto: my-project
• Repositório: my-repo
• Local do repositório: us-west1
• Imagem: my-app

O comando a seguir lista todos os arquivos no repositório my-repo na Local us-west1 no projeto padrão:

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=sha256:88b205d7995332e10e836514fbfd59ecaf8976fc15060cd66e85cdcebe7fb356

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --tag=1.0-dev

Como marcar imagens

É possível marcar as imagens atuais em um repositório do Artifact Registry ou marque-os antes de enviá-los ao repositório.

Como marcar imagens em um repositório

Modos de repositório: padrão

É possível adicionar uma tag a uma imagem em um repositório do Artifact Registry usando o Console do Google Cloud ou linha de comando. Em um registro, as tags são exclusivas para uma versão de uma imagem. Portanto, se você tiver várias versões de uma imagem, cada tag se aplicará apenas a uma delas. Se adicionar à imagem uma tag que já está em uso, a tag da versão original será movida para a versão recém-marcada.

gcloud artifacts docker tags add IMAGE-VERSION TAG

gcloud artifacts docker tags add \
us-west1-docker.pkg.dev/my-project/my-repo/my-image:iteration6-final \
us-west1-docker.pkg.dev/my-project/my-repo/my-image:release-candidate

Como marcar imagens locais

Para enviar qualquer imagem local para o Artifact Registry, primeiro marque-a com o nome do registro e, em seguida, envie a imagem. Para ver instruções, consulte Como enviar e extrair.

Como desmarcar imagens

Modos de repositório: padrão

Para remover a tag de uma imagem no Artifact Registry, use o Console do Google Cloud ou linha de comando.

 gcloud artifacts docker tags delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG

Como excluir imagens

Modos de repositório: padrão, remoto

É possível excluir uma imagem de contêiner inteira ou uma versão de imagem específica associada a uma tag ou um resumo.

• Não é possível desfazer a exclusão de uma imagem.
• A exclusão de imagens não exclui imediatamente as camadas referenciadas. Sem referência camadas são excluídas diariamente.
• Para repositórios remotos, a cópia em cache da imagem é removida. A imagem permanece disponível na origem upstream. Se o controle remoto repositório receber uma nova solicitação para a mesma imagem, faça o download e armazene em cache novamente.

Outras ferramentas estão disponíveis para ajudar você a gerenciar imagens não utilizadas. Por exemplo o comando gcr-cleaner localiza e exclui imagens antigas com base em diferentes critérios. A remoção de imagens não usadas pode ajudar a reduzir os custos de armazenamento. A ferramenta gcr-cleaner não é um produto oficial do Google.

Para excluir uma imagem usando o console do Google Cloud ou a CLI gcloud:

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE --delete-tags

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG [--delete-tags]

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE@IMAGE-DIGEST [--delete-tags]

A seguir

• Fazer o download de arquivos individuais armazenadas em uma imagem sem usar comandos Docker. Isso pode ser útil para inspecionando rapidamente os arquivos de manifesto.