Nomes de repositórios e imagens

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

Repositórios Docker

O nome completo de um repositório do Docker tem o seguinte formato:

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY

Onde:

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

  • Localização do repositório: u-france-east1
  • Formato do repositório: docker
  • Nome do repositório: my-repo
  • ID do projeto: my-project

O repositório é especificado da seguinte forma:

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo

Nomes das imagens de contentores

O nome completo de uma imagem de contentor tem um dos seguintes formatos: 

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY/IMAGE

ou

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY/IMAGE:TAG

ou

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

where:

  • LOCATION é a localização regional do repositório.
  • PROJECT é o Trusted Cloud ID do projeto da consola.
  • REPOSITORY é o nome do repositório onde a imagem está armazenada.
  • IMAGE é o nome da imagem no repositório.
  • TAG é a etiqueta da versão da imagem que quer obter.
  • IMAGE-DIGEST é o valor hash sha256 do conteúdo da imagem. Na Trusted Cloud consola, clique na imagem específica para ver os respetivos metadados. O resumo é apresentado como o Resumo da imagem. Se não especificar uma etiqueta ou um resumo, o Artifact Registry procura a imagem com a etiqueta predefinida latest. Consulte o artigo Versões de imagens de contentores para obter informações sobre as versões.

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

  • Localização do repositório: u-france-east1
  • Nome do repositório: my-repo
  • ID do projeto: my-project
  • Nome da imagem: test
  • Etiqueta: staging

Esta versão da imagem etiquetada com a preparação está especificada como:

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/test:staging

Versões de imagens de contentores

Um repositório pode conter muitas imagens de contentores, e estas imagens podem ter versões diferentes. Para identificar uma versão específica de uma imagem, pode especificar o resumo ou a etiqueta da imagem.

Resumo
Um resumo de imagem é um hash gerado automaticamente do índice de imagens ou do manifesto de imagens. Cada resumo de imagem é um identificador exclusivo de uma versão de imagem e não pode ser alterado. O resumo é o valor hash sha256 dos conteúdos da imagem.
Etiqueta

Uma etiqueta de imagem é uma etiqueta e, muitas vezes, uma string legível, como v1.1 ou development. Uma etiqueta só pode apontar para uma versão de uma imagem. No Artifact Registry, pode configurar um repositório Docker para permitir etiquetas de imagens mutáveis ou aplicar etiquetas de imagens imutáveis.

  • Mutável: uma etiqueta aponta apenas para uma versão de uma imagem, mas o resumo específico ao qual faz referência pode mudar.

    Uma abordagem comum é etiquetar as imagens com um identificador de versão, como v1.1 no momento da criação. Quando a compilação envia várias versões da imagem para o registo com a mesma etiqueta v1.1, a etiqueta faz referência ao resumo da última versão enviada para o registo. Embora as etiquetas de imagens mutáveis ofereçam uma forma conveniente de etiquetar versões, também podem ser manipuladas por um ator malicioso para associar uma etiqueta a uma versão maliciosa de uma imagem.

  • Immutable: no repositório, uma etiqueta aponta sempre para o mesmo resumo da imagem. Se um repositório do Artifact Registry estiver configurado para etiquetas de imagens imutáveis, não são permitidas as seguintes ações:

    • Elimine uma imagem etiquetada. A eliminação de imagens sem etiquetas continua a ser permitida.
    • Remova uma etiqueta de uma imagem.
    • Enviar uma imagem com uma etiqueta que já está a ser usada por outra versão da imagem no repositório.

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

  • Localização do repositório: u-france-east1
  • Nome do repositório: my-repo
  • ID do projeto: my-project
  • Nome da imagem: test
  • Etiqueta: staging
  • Resumo: sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

Para identificar a imagem com a etiqueta, anexe :staging ao nome da imagem:

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/test:staging

Para a identificar com o resumo, anexe @ ao nome da imagem, seguido do resumo:

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/test@sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

Na consola, no ecrã Imagens, a coluna Etiquetas apresenta as etiquetas da imagem. Clique na versão da imagem para ver os metadados, incluindo o resumo da imagem.

Consulte o artigo Etiquetar imagens para mais informações sobre a etiquetagem.

Nomes dos repositórios como URLs

Para aceder a um repositório ou a um artefacto num repositório na Trusted Cloud consola, acrescente https:// ao respetivo nome completo.

Por exemplo, para ver o repositório u-france-east1-maven.s3nsregistry.fr/my-project/my-repo, use o seguinte URL:

https://u-france-east1-maven.s3nsregistry.fr/my-project/my-repo

Para ver a imagem u-france-east1-docker.s3nsregistry.fr/example.com/my-project/my-repo/my-image, use o seguinte URL:

https://u-france-east1-docker.s3nsregistry.fr/example.com/my-project/my-repo/my-image

Qualquer utilizador autenticado que tenha autorização para aceder ao repositório pode usar estes links.