Preparar para o encerramento do Container Registry

Determine as próximas etapas para se preparar para o encerramento do Container Registry.

O Container Registry foi descontinuado e vai ser desativado em 18 de março de 2025. 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.

Para mais informações sobre a suspensão de uso do Container Registry, consulte Descontinuação do Container Registry.

O que tenho que fazer?

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

O que acontecerá depois de 18 de março de 2025

O encerramento do Container Registry tem três estágios:

  • Desde 18 de março de 2025, não é mais possível gravar imagens no Container Registry.
  • A partir de 22 de abril de 2025, a leitura de imagens no Container Registry não estará disponível.
  • A partir de 22 de maio de 2025, se você tiver concluído as etapas de configuração de repositórios do gcr.io no Artifact Registry, o envio para endpoints gcr.io armazenará imagens no Artifact Registry, e todos os repositórios do Container Registry serão disponibilizados pelo Artifact Registry. As imagens no Container Registry que não foram copiadas para o Artifact Registry estão indisponíveis.

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

  1. Identifique o uso do Container Registry no projeto, na pasta ou na organização do Google Cloud. Use nossa ferramenta de uso do Container Registry para determinar se esse é o seu caso.

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

  3. Se você não precisar das imagens armazenadas no Container Registry, poderá configurar os repositórios padrão do Artifact Registry ou repositórios gcr.io do Artifact Registry.

    Para saber mais sobre as diferenças entre o Container Registry e o Artifact Registry, revise 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 os repositórios gcr.io hospedados no Artifact Registry ou para repositórios padrão do Artifact Registry.

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 repositórios padrão no Artifact Registry para cada um dos projetos gcr.io listados na região correspondente.
  • Sugira uma política do IAM para cada repositório e aplique-a ou ignore o aplicativo, 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 padrão 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 Fazer upgrade automaticamente para o Artifact Registry.

Validar a automação e as integrações

Verifique se a automação e a integração atuais com serviços como Cloud Build, Google Kubernetes Engine ou Cloud Functions funcionam conforme o esperado.

Limpar imagens do Container Registry

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

Depois de validar todos os projetos com a opção de transição escolhida e se todas as imagens que você quer manter tiverem sido copiadas para o Artifact Registry, será 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.