Migre imagens de contentores do App Engine para o Artifact Registry

ID da região

O REGION_ID é um código abreviado que a Google atribui com base na região que seleciona quando cria a sua app. O código não corresponde a um país ou uma província, embora alguns IDs de regiões possam parecer semelhantes aos códigos de países e províncias usados frequentemente. Para apps criadas após fevereiro de 2020, REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criadas antes desta data, o ID da região é opcional no URL.

Saiba mais acerca dos IDs de regiões.

O Container Registry foi descontinuado e encerrado a 18 de março de 2025. Recomendamos que use o Artifact Registry para armazenar e gerir imagens de contentores. Por predefinição, as novas implementações criadas após 5 de março de 2025 usam o Artifact Registry em vez do Container Registry para armazenar imagens de aplicações. O Artifact Registry oferece as mesmas funcionalidades de gestão de contentores que o Container Registry e inclui funcionalidades e vantagens adicionais. Como um serviço totalmente gerido com suporte para imagens de contentores e artefactos sem contentores, o Artifact Registry expande as capacidades do Container Registry.

Para projetos criados antes de maio de 2024 ou que ainda não executaram as ferramentas de migração automática, siga os passos neste guia para permitir que o App Engine migre automaticamente os seus fluxos de implementação.

Ambiente padrão do App Engine

A maioria dos componentes da sua aplicação no ambiente padrão segue um processo de migração automatizado. No entanto, para uma transição sem problemas para o Artifact Registry, certifique-se de que a sua conta de serviço tem as seguintes autorizações necessárias:

  • Para implementações padrão existentes, a conta de serviço de implementação (a conta de serviço predefinida do App Engine [PROJECT_ID@appspot.gserviceaccount.com] ou a sua conta de serviço personalizada) tem de ter uma função que conceda a autorização de gravação explícita do Artifact Registry artifactregistry.repositories.uploadArtifacts. Para encontrar as funções associadas à sua conta de serviço de implementação, consulte o artigo Gerir o acesso a contas de serviço.

  • As novas implementações podem usar o Artifact Registry se qualquer uma das seguintes funções estiver presente na conta de serviço associada às implementações:

    Se nenhuma destas funções estiver presente, conceda a função de escritor do Artifact Registry (roles/artifactregistry.writer) à sua conta de serviço de implementação.

Se não conceder as autorizações necessárias, não pode implementar novas versões no ambiente padrão.

Durante as migrações automáticas, Google Cloud pode criar novos repositórios e copiar imagens do Container Registry para o Artifact Registry.

Ambiente flexível do App Engine

A maioria dos componentes da sua aplicação no ambiente flexível segue um processo de migração automatizado. No entanto, para uma transição sem problemas para o Artifact Registry, certifique-se de que a sua conta de serviço tem as seguintes autorizações necessárias:

  • Para que as implementações flexíveis existentes funcionem como esperado com o Artifact Registry, a conta de serviço de implementação (a conta de serviço predefinida do App Engine [PROJECT_ID@appspot.gserviceaccount.com] ou a sua conta de serviço personalizada) tem de ter uma função que conceda as autorizações explícitas do Artifact Registry, como artifactregistry.repositories.downloadArtifacts para leitura e artifactregistry.repositories.uploadArtifacts para escrita. Para encontrar as funções associadas à sua conta de serviço de implementação, consulte o artigo Gerir o acesso a contas de serviço.

  • As novas implementações podem usar o Artifact Registry se alguma das seguintes funções estiver presente na conta de serviço associada às implementações:

    Se nenhuma destas funções estiver presente, conceda a função de administrador do repositório do Artifact Registry (roles/artifactregistry.repoAdmin) à sua conta de serviço de implementação.

Se não fornecer as autorizações necessárias, não pode implementar aplicações no ambiente flexível. O dimensionamento e o reinício das instâncias também falham.

Durante as migrações automáticas, Google Cloud pode criar novos repositórios e copiar imagens do Container Registry para o Artifact Registry.

Migre para o Artifact Registry para imagens de contentores criadas manualmente

O processo de migração automática não se aplica se tiver implementado anteriormente as suas apps através de imagens de contentores pré-criadas ou criadas manualmente a partir do Container Registry. Por exemplo, o processo de migração automatizado não funciona se tiver criado imagens de contentores com o Docker, enviado estas imagens para o Container Registry e implementado as suas apps através do comando gcloud app deploy --image-url.

Se usar imagens de contentores pré-criadas ou criadas manualmente a partir do Container Registry para implementar as suas apps, escolha uma das seguintes opções para migrar para o Artifact Registry:

  • Use a ferramenta de migração automática para migrar do Container Registry para repositórios gcr.io alojados no Artifact Registry. Não precisa de voltar a implementar novas versões do seu serviço se usar esta ferramenta. Para mais informações, consulte o artigo Migre automaticamente do Container Registry para o Artifact Registry.

  • Mova manualmente as imagens de contentores do Container Registry para o Artifact Registry e implemente novamente novas versões do seu serviço. Para mais informações, consulte o artigo Migração manual para repositórios gcr.io no Artifact Registry.

  • Use a flag copy-only para copiar as imagens de contentores para o Artifact Registry e reimplementar novas versões do seu serviço.