Preparar-se para o encerramento do Container Registry

Determine como você quer se preparar para o encerramento do Container Registry.

O Container Registry será descontinuado. A partir de 18 de março de 2025, o Container Registry será desativado, e não será possível gravar imagens nele.

Os URLs gcr.io hospedados no Artifact Registry, incluindo imagens de propriedade do Google com URLs gcr.io, não são afetados pelo encerramento do Container Registry.

Para mais detalhes sobre a descontinuação do Container Registry e como migrar para o Artifact Registry, consulte Descontinuação do Container Registry.

O Artifact Registry é o serviço recomendado para armazenamento e gerenciamento de imagens de contêiner no Google Cloud. O Artifact Registry oferece os mesmos recursos de gerenciamento de contêineres que o Container Registry e inclui outros recursos e benefícios.

O que tenho que fazer?

Se você tiver imagens de contêiner no Container Registry que quer continuar usando ou se usar um serviço que depende do Container Registry, como o App Engine, será necessário fazer upgrade para usar os repositórios do Artifact Registry.

O que acontece depois de 18 de março de 2025

A desativação do Container Registry tem três etapas:

  • A partir de 18 de março de 2025, não será possível gravar imagens no Container Registry.
  • A partir de 3 de junho de 2025, a leitura de imagens no Container Registry não estará disponível.

  • A partir de 14 de outubro de 2025, se você tiver concluído as etapas para configurar repositórios gcr.io no Artifact Registry, o envio para endpoints gcr.io vai armazenar imagens no Artifact Registry, e todos os URLs gcr.io serão veiculados pelo Artifact Registry. Todas as imagens no Container Registry que não foram copiadas para o Artifact Registry ficam indisponíveis.

    A ferramenta de migração automática ainda estará disponível para migração após 14 de outubro de 2025.

Identificar o uso do Container Registry e escolher uma opção de transição

  1. Identifique o uso do Container Registry no seu Google Cloud projeto, pasta ou organização. Use nossa ferramenta de uso do Container Registry para determinar se você está usando o Container Registry.

  2. Se você tiver imagens de contêiner no Container Registry que quer continuar usando, determine qual opção de transição você quer seguir.

  3. Se você não precisar de nenhuma das imagens armazenadas no Container Registry, configure repositórios pkg.dev ou gcr.io do Artifact Registry.

    Para saber mais sobre as diferenças entre o Container Registry e o Artifact Registry, consulte o seguinte:

Usar nossas ferramentas de transição

Use a ferramenta de migração automática para fazer a transição do Container Registry para repositórios gcr.io hospedados no Artifact Registry ou para repositórios pkg.dev do Artifact Registry.

É possível migrar endpoints do Container Registry para repositórios do Artifact Registry gcr.io sem exigir tempo de inatividade ou interrupção do serviço.

A ferramenta de migração automática pode realizar as seguintes ações, dependendo do caminho de transição escolhido:

  • Crie repositórios gcr.io ou pkg.dev no Artifact Registry para cada um dos projetos gcr.io listados na região correspondente.
  • Sugerir uma política do IAM para cada repositório e aplicar a política ou pular a aplicação, dependendo da preferência do usuário.
  • Redirecione todo o tráfego dos endpoints gcr.io para o Artifact Registry.
  • Copie todas as imagens de contêiner armazenadas no Container Registry para os repositórios gcr.io ou pkg.dev do Artifact Registry, mesmo que você já tenha ativado o redirecionamento.

Para instruções sobre como usar a ferramenta de migração automática, consulte Migrar automaticamente do Container Registry para o Artifact Registry.

Validar sua automação e integrações

Verifique se a automação e a integração atuais com serviços como Cloud Build, Google Kubernetes Engine, funções do Cloud Run ou qualquer ferramenta de terceiros usada para enviar ou extrair do repositório funcionam como esperado.

Limpar imagens do Container Registry

Quando o redirecionamento está ativado, os comandos para excluir imagens em caminhos gcr.io excluem imagens no repositório gcr.io correspondente do Artifact Registry, mas não excluem imagens armazenadas em hosts do Container Registry.

Depois de validar que todos os projetos funcionam com a opção de transição escolhida e que todas as imagens que você quer manter foram copiadas para o Artifact Registry, é possível excluir os buckets de armazenamento do Container Registry. Para instruções sobre como excluir buckets do Cloud Storage, consulte Limpar imagens no Container Registry.