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.

OK

O Container Registry foi descontinuado e desativado em 18 de março de 2025. Recomendamos usar o 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 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 sua 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 ([e-mail]) ou sua conta de serviço personalizada) precisa ter uma função 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 podem usar o Artifact Registry se algum dos seguintes papéis estiver presente na conta de serviço associada a elas:

  • Papel de Editor

  • Papel predefinido do Artifact Registry com acesso de gravação, como Gravador do Artifact Registry (roles/artifactregistry.writer).

  • Papel personalizado que concede a permissão artifactregistry.repositories.uploadArtifacts. É possível verificar o acesso aos papéis personalizados no console doGoogle Cloud ou executando o comando gcloud iam roles describe.

  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 será possível implantar novas versões no ambiente padrão.

Durante as 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 sua conta de serviço tem as seguintes permissões necessárias:

• Para que as implantações flexíveis atuais funcionem como esperado com o Artifact Registry, a conta de serviço de implantação (a conta de serviço padrão do App Engine ([e-mail]) 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 à sua 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:

  • Papel de Editor

  • Papel predefinido do Artifact Registry com acesso de leitura e gravação, como Gravador do Artifact Registry (roles/artifactregistry.writer).

  • Papel personalizado que concede as permissões artifactregistry.repositories.downloadArtifacts e artifactregistry.repositories.uploadArtifacts. É possível verificar o acesso a funções personalizadas no consoleGoogle Cloud ou executando o comando gcloud iam roles describe.

  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 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,o Google Cloud pode criar novos repositórios e copiar imagens do Container Registry para o Artifact Registry.

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

O processo de migração automatizada não se aplica se você já 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 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:

• Use a ferramenta de migração automática para migrar do Container Registry para repositórios gcr.io hospedados no Artifact Registry. Não é necessário reimplantar novas versões do serviço se você usar essa ferramenta. Para mais informações, consulte Migrar automaticamente do Container Registry para o Artifact Registry.

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

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