Migrar imagens de contêineres do App Engine para o Artifact Registry

ID da região

O REGION_ID é um código abreviado que o Google atribui com base na região que você selecionou ao criar o aplicativo. O código não corresponde a um país ou estado, ainda que alguns IDs de região sejam semelhantes aos códigos de país e estado geralmente usados. Para apps criados após fevereiro de 2020, o REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criados antes dessa data, o ID da região é opcional no URL.

Saiba mais sobre IDs de região.

O Container Registry foi descontinuado e desativado em 18 de março de 2025. Recomendamos o uso do Artifact Registry para armazenar e gerenciar imagens de contêiner. Por padrão, as novas implantações criadas após 5 de março de 2025 usam o Artifact Registry em vez do Container Registry para armazenar imagens de aplicativos. O Artifact Registry oferece os mesmos recursos de gerenciamento de contêineres do Container Registry, além de outros recursos e benefícios. Como um serviço totalmente gerenciado com suporte a imagens de contêiner e artefatos que não sejam de contêineres, o Artifact Registry estende os recursos do Container Registry.

Para projetos criados antes de maio de 2024 ou que ainda não executaram a ferramenta de migração automatizada, siga as etapas deste guia para permitir que o App Engine migre automaticamente seus fluxos de implantação.

Ambiente padrão do App Engine

A maioria dos componentes do aplicativo no ambiente padrão segue um processo de migração automatizado. No entanto, para uma transição tranquila para o Artifact Registry, verifique se a conta de serviço tem as seguintes permissões:

  • Para implantações padrão existentes, a conta de serviço de implantação (a conta de serviço padrão do App Engine (PROJECT_ID@appspot.gserviceaccount.com) ou a conta de serviço personalizada) precisa ter um papel que conceda a permissão de gravação explícita do Artifact Registry artifactregistry.repositories.uploadArtifacts. Para encontrar os papéis associados à sua conta de serviço de implantação, consulte Gerenciar o acesso a contas de serviço.

  • As novas implantações poderão usar o Artifact Registry se algum dos seguintes papéis estiver presente na conta de serviço associada a elas:

    Se nenhum desses papéis estiver presente, conceda o papel de Gravador do Artifact Registry (roles/artifactregistry.writer) à conta de serviço da implantação.

Se você não fornecer as permissões necessárias, não vai conseguir implantar novas versões no ambiente padrão.

Durante migrações automatizadas,o 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 do aplicativo no ambiente flexível segue um processo de migração automatizado. No entanto, para uma transição tranquila para o Artifact Registry, verifique se a conta de serviço tem as seguintes permissões:

  • Para que as implantações flexíveis atuais funcionem conforme o esperado com o Artifact Registry, a conta de serviço de implantação (a conta de serviço padrão do App Engine (PROJECT_ID@appspot.gserviceaccount.com) ou a conta de serviço personalizada) precisa ter um papel que conceda as permissões explícitas do Artifact Registry, como artifactregistry.repositories.downloadArtifacts para leitura e artifactregistry.repositories.uploadArtifacts para gravação. Para encontrar os papéis associados à sua conta de serviço de implantação, consulte Gerenciar o acesso a contas de serviço.

  • As novas implantações poderão usar o Artifact Registry se algum dos seguintes papéis estiver presente na conta de serviço associada a elas:

    Se nenhum desses papéis estiver presente, conceda o papel de administrador do repositório do Artifact Registry (roles/artifactregistry.repoAdmin) à conta de serviço da implantação.

Se você não fornecer as permissões necessárias, não vai conseguir implantar aplicativos no ambiente flexível. O escalonamento e a reinicialização de instâncias também falham.

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

Migrar para o Artifact Registry para imagens de contêiner criadas manualmente

O processo de migração automatizada não se aplica se você tiver implantado seus apps usando imagens de contêiner pré-criadas ou criadas manualmente do Container Registry. Por exemplo, o processo de migração automatizada não funciona se você criou imagens de contêiner com o Docker, enviou essas imagens para o Container Registry e implantou os apps usando o comando gcloud app deploy --image-url.

Se você usa imagens de contêiner pré-criadas ou criadas manualmente do Container Registry para implantar seus apps, escolha uma das seguintes opções para migrar para o Artifact Registry: