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 foi 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 que o Container Registry e inclui outros recursos e benefícios. 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.

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 os 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 necessárias:

  • Para implantações padrão atuais, a conta de serviço de implantação (a conta de serviço padrão do App Engine (PROJECT_ID@appspot.gserviceaccount.com) ou sua 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 à conta de serviço de implantação, consulte Gerenciar o acesso a contas de serviço.

  • As novas implantações podem 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 Gravador do Artifact Registry (roles/artifactregistry.writer) à conta de serviço da implantação.

Se você não conceder as permissões necessárias, não será possível implantar novas versões no ambiente padrão.

Durante as migrações automatizadas, 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 necessárias:

  • 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 sua 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 à 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 conceder as permissões necessárias, não será possível implantar aplicativos no ambiente flexível. O escalonamento e a reinicialização de instâncias também falham.

Durante as migrações automatizadas, 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ê implantou 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 seus 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: