Como fazer a transição do Container Registry

O Artifact Registry é a evolução do Container Registry. Como um serviço totalmente gerenciado com suporte para imagens de contêiner e artefatos que não sejam de contêineres, o Artifact Registry estende os recursos do Container Registry.

Se você atualmente usa o Container Registry, veja as informações nesta página para saber como fazer a transição para o Artifact Registry.

Visão geral

O Artifact Registry oferece os mesmos recursos de gerenciamento de contêineres que o Container Registry. Comece a fazer a transição da sua automação para usar o Artifact Registry nos seus contêineres.

Compatibilidade com versões anteriores e coexistência

É possível usar o Artifact Registry e o Container Registry no mesmo projeto. Quando você visualiza uma lista de repositórios com gcloud ou o Console do Cloud, o Artifact Registry também lista os repositórios do Container Registry no mesmo projeto.

Os dois serviços continuarão coexistindo depois que o Artifact Registry estiver disponível para o público em geral. Para aproveitar os recursos expandidos no Artifact Registry, transfira seus contêineres e a automação para o Artifact Registry.

Como configurar repositórios

No Artifact Registry, é preciso criar repositórios antes de enviar imagens para eles. Por isso, uma parte fundamental da migração para o Artifact Registry é configurar os repositórios do Artifact Registry e integrá-los à automação de CI/CD.

Para oferecer mais flexibilidade, há algumas mudanças na forma como o Artifact Registry representa repositórios.

Container Registry

Cada local multirregional está associado a um único bucket de armazenamento. Organizar suas imagens em repositórios em um nome de host é opcional. Considere o exemplo a seguir que mostra a imagem webapp em três locais:

us.gcr.io/my-project/webapp
us.gcr.io/my-project/team1/webapp
us.gcr.io/my-project/team2/webapp

Os repositórios são apenas um mecanismo de organização e não restringem o acesso. Qualquer usuário com acesso ao bucket de armazenamento para us.gcr.io neste projeto pode acessar todas as versões da imagem do contêiner webapp.

Artifact Registry

Cada repositório é um recurso separado no projeto. Como cada repositório é um recurso exclusivo, é possível:

• Dar a cada repositório um nome, descrição e rótulos
• Criar vários repositórios no mesmo local
• Configurar permissões específicas de repositório

Além disso, o local de um repositório pode ser uma região ou várias regiões.

Observação: só é possível criar repositórios gcr.io nas mesmas regiões que os hosts do Container Registry.

Essas alterações oferecem mais controle sobre seus repositórios. Por exemplo, se você tem equipes em São Paulo e Sydney, pode criar um repositório para cada equipe em uma região geograficamente mais próxima do que o local multirregional mais próximo.

southamerica-east1-docker.pkg.dev/my-project/team1/webapp
australia-southeast1-docker.pkg.dev/my-project/team2/webapp

Em seguida, você pode conceder a cada equipe permissões somente para o repositório da equipe.

Consulte o guia de configuração para ver instruções de transição para o Artifact Registry.

Como enviar e extrair imagens

Para ajudar a adaptar a configuração, os comandos e a documentação criados para o Container Registry, as informações a seguir comparam o processo de criação, envio, pull e implantação de imagens.

• Mudanças na criação e implantação no Google Cloud
• Mudanças no envio e extração com o Docker

Comparação do recurso

Esta seção resume as alterações e melhorias nos recursos do Container Registry.

Depois que o Artifact Registry estiver disponível para todos os usuários, o Artifact Registry fornecerá uma opção para criar repositórios compatíveis com versões anteriores que poderão ser consultados com os nomes de host *-docker.pkg.dev e *.gcr.io.

Recurso	Container Registry	Artifact Registry
Formatos compatíveis	Somente imagens de contêiner	Vários formatos de artefato, incluindo imagens de contêiner, pacotes Java e módulos Node.js. Observação: os repositórios de pacotes estão na versão Alfa. Para se inscrever na versão Alfa, preencha o formulário de inscrição.
Repositórios	Criação: cria automaticamente um repositório em uma multirregião se você ainda não enviou uma imagem nele. Local: somente repositórios multirregionais. Organização: todos os repositórios no mesmo host multirregional em um projeto do Google Cloud compartilham um único bucket de armazenamento. Controle de acesso: conceda permissões no nível do projeto ou no bucket de armazenamento de cada host multirregional.	Criação: crie um repositório antes de enviar imagens para ele. Local: crie repositórios padrão em uma multirregião ou região. Por exemplo, a multirregião mais próxima da Austrália é a Asiasia. Com o suporte regional, é possível criar um repositório no data center de Sydney. Organização: é possível criar diversos repositórios discretos em cada região ou multirregião. Aplique rótulos para agrupá-los por equipe, estágio de desenvolvimento ou outras categorias. Controle de acesso: conceda permissões no projeto ou em repositórios individuais.
Nomes de host	Os hosts estão no domínio gcr.io.	Os hosts estão no domínio pkg.dev. Para detalhes sobre o formato do nome, consulte Nomes de repositório e de artefato.
Permissões	Conceder acesso usando permissões do Cloud Storage. É possível restringir o acesso a todas as imagens armazenadas em uma multirregião, mas não para repositórios individuais. Por exemplo, é possível restringir o acesso a us.gcr.io no projeto my-project, mas não é possível conceder permissões específicas para imagens em us.gcr.io/my-project/team1 e us.gcr.io/my-project/team2	Conceder acesso usando as permissões do Artifact Registry. É possível restringir o acesso a repositórios individuais. Por exemplo, é possível controlar separadamente o acesso a imagens em us-docker.pkg.dev/my-project/team1 e us-docker.pkg.dev/my-project/team2.
Authentication	Oferece vários métodos de autenticação para enviar e extrair imagens com um cliente terceirizado.	O Artifact Registry é compatível com os mesmos métodos de autenticação do Container Registry. Consulte Como configurar a autenticação para o Docker para mais detalhes. Se você usar o auxiliar de credenciais do Docker: A versão 2.0.0 ou posterior é obrigatória. As versões de cliente do Docker anteriores a v18.03 não são mais compatíveis. Adicione os locais do Artifact Registry que você usará para a configuração do assistente de credenciais.
Chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês)	Use CMEK para criptografar os buckets de armazenamento que contêm suas imagens.	Use CMEK para criptografar repositórios individuais.
Como usar o Console do Google Cloud	Veja e gerencie imagens do Container Registry na seção Container Registry do Console do Cloud.	Veja uma lista dos repositórios do Artifact Registry e do Container Registry na seção Artifact Registry do Console do Cloud. Gerencie seus repositórios e imagens do Artifact Registry nesta página. Se você clicar em um repositório do Container Registry, será direcionado para a lista de imagens na seção Container Registry do Console do Cloud.
Como usar os comandos gcloud e API	Usa comandos gcloud container images. Comandos são compatíveis com resumos abreviados. Se você não especificar a string de resumo completa, o Container Registry tentará localizar a imagem correta com base na string parcial.	Usa comandos gcloud artifacts docker. Os comandos não são compatíveis com resumos resumidos. Para ver uma comparação dos comandos gcloud do Container Registry e do Artifact Registry, consulte a comparação do comando gcloud. O Artifact Registry também inclui uma API para gerenciar repositórios e artefatos em todos os formatos.
Notificações do Pub/Sub	Publica alterações no tópico gcr.	Publica alterações no tópico gcr. Se você criar repositórios no mesmo projeto que o serviço do Container Registry atual, a configuração atual do Pub/Sub funcionará automaticamente. Para saber mais, consulte Como configurar notificações do Pub/Sub.
Imagens do Docker Hub em cache	Armazena em cache as imagens do Docker Hub solicitadas com mais frequência em mirror.gcr.io.	mirror.gcr.io continua a armazenar em cache imagens do Docker Hub solicitadas com frequência.
VPC Service Controls	É possível adicionar o Container Registry a um perímetro de serviço.	É possível adicionar o Artifact Registry a um perímetro de serviço.
Armazenamento e análise de metadados	O Container Analysis fornece armazenamento de metadados, verificação de vulnerabilidades e integração com serviços que usam os metadados, como autorização binária. Os comandos do SDK do Cloud para trabalhar com notas e ocorrências estão no grupo gcloud container images.	O Container Analysis é compatível com armazenamento de metadados e verificação de vulnerabilidades para imagens de contêiner no Artifact Registry e no Container Registry. Os dois produtos usam as mesmas APIs do Container Analysis. Ao ativar as APIs do Container Analysis no Container Registry ou no Artifact Registry, as APIs são ativadas para os dois produtos. Os dois produtos usam os mesmos tópicos Pub/Sub para notificações do Container Analysis. As assinaturas atuais incluirão notificações para o Artifact Registry e o Container Registry. Os comandos do SDK do Cloud para trabalhar com notas e ocorrências estão no grupo gcloud artifact docker.
Imagens fornecidas pelo Google	As imagens fornecidas pelo Google são hospedadas em gcr.io. Examples incluem: Imagens em cache no mirror.gcr.io. Builders do Cloud Build Imagens de base gerenciadas	As imagens fornecidas pelo Google continuam disponíveis em gcr.io.
Preço	Os preços do Container Registry são baseados no uso do Cloud Storage, incluindo armazenamento e saída de rede.	O Artifact Registry tem seu próprio preço, com base no armazenamento e na saída da rede.