Esta página foi traduzida pela API Cloud Translation.
Switch to English

Nomes de repositório e imagem

O Artifact Registry usa uma convenção de nomenclatura para identificar repositórios e imagens ao usar os comandos de API, gcloud e docker para interagir com os repositórios.

Repositórios do Docker

O nome completo de um repositório do Docker está no seguinte formato:

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY

onde:

Por exemplo, considere uma imagem com as seguintes características:

  • Local do repositório: us
  • Formato do repositório: docker
  • Nome do repositório: my-repo
  • ID do projeto: my-project

O repositório é especificado como:

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

Nomes de imagens de contêiner

O nome completo de uma imagem de contêiner é um dos seguintes formatos:

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE

ou

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE:TAG

ou

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

onde:

  • LOCATION é o local regional ou multirregional do repositório.
  • PROJECT é o ID do projeto do seu Console do 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 está armazenada.
  • IMAGE é o nome da imagem no repositório.
  • TAG é a tag da versão de imagem que você quer extrair.
  • IMAGE-DIGEST é o valor de hash sha256 do conteúdo da imagem. No Console do Google Cloud, clique na imagem específica para ver os metadados dela. O resumo é listado como Resumo da imagem.

    Se você não especificar uma tag ou um resumo, o Artifact Registry procurará a imagem com a tag padrão latest. Consulte Versões de imagem de contêiner para mais informações sobre versões.

Por exemplo, considere uma imagem com as seguintes características:

  • Local do repositório: us
  • Nome do repositório: my-repo
  • ID do projeto: my-project
  • Nome da imagem: test
  • Tag: staging

Essa versão da imagem marcada com preparação é especificada como:

us-docker.pkg.dev/my-project/my-repo/test:staging

Versões de imagem de contêiner

Um registro pode ter muitas imagens de contêiner, e essas imagens podem ter diferentes versões. Para identificar uma versão específica de uma imagem, especifique a tag ou o resumo da imagem. As tags são exclusivas de uma imagem em um registro. Os resumos são gerados automaticamente, são exclusivos de uma versão de uma imagem e têm a forma @[IMAGE_DIGEST], em que [IMAGE_DIGEST] é o valor de hash sha256 do conteúdo da imagem.

Por exemplo, considere uma imagem com as seguintes características:

  • Local do repositório: us
  • Nome do repositório: my-repo
  • ID do projeto: my-project
  • Nome da imagem: test
  • Tag: staging
  • Resumo: sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

Para identificar a imagem com a tag, use:

us-docker.pkg.dev/my-project/my-repo/test:staging

Para identificá-la com o resumo, use:

us-docker.pkg.dev/my-project/my-repo/test@sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

Se o ID do projeto contiver dois pontos (:), consulte Projetos com escopo de domínio abaixo.

No console, na tela Imagens, a coluna Tags lista as tags da imagem. Clique na respectiva versão para ver os metadados, incluindo o Resumo da imagem.

Consulte Como incluir tags em imagens para mais informações sobre inclusão de tags.

Projetos de escopo de domínio

Se seu projeto estiver no escopo de seu domínio, o ID do projeto incluirá o nome do domínio seguido por dois pontos (:). Por causa de como o Docker trata dois pontos, você deve substituir o caractere de dois pontos por uma barra quando especificar um resumo de imagem no Artifact Registry. Identifique imagens nesses tipos de projetos usando o seguinte formato:

LOCATION-docker.pkg.dev/DOMAIN/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

Por exemplo, o projeto com o ID example.com:my-project poderia ter a seguinte imagem:

us-docker.pkg.dev/example.com/my-project/my-repo/image-name