Migrer des images de conteneur App Engine vers Artifact Registry

ID de la région

Le REGION_ID est un code abrégé que Google attribue en fonction de la région que vous sélectionnez lors de la création de votre application. Le code ne correspond pas à un pays ou une province, même si certains ID de région peuvent ressembler aux codes de pays et de province couramment utilisés. Pour les applications créées après février 2020, REGION_ID.r est inclus dans les URL App Engine. Pour les applications existantes créées avant cette date, l'ID de région est facultatif dans l'URL.

En savoir plus sur les ID de région

Container Registry est obsolète et a été arrêté le 18 mars 2025. Nous vous recommandons d'utiliser Artifact Registry pour stocker et gérer les images de conteneurs. Par défaut, les déploiements créés après le 5 mars 2025 utilisent Artifact Registry au lieu de Container Registry pour stocker les images d'application. Artifact Registry offre les mêmes fonctionnalités de gestion de conteneurs que Container Registry, mais inclut des fonctionnalités et des avantages supplémentaires. En tant que service entièrement géré compatible avec les images de conteneurs et les artefacts non issus de conteneurs, Artifact Registry étend les capacités de Container Registry.

Pour les projets créés avant mai 2024 ou qui n'ont pas encore exécuté l'outil de migration automatique, suivez les étapes de ce guide pour permettre à App Engine de migrer automatiquement vos flux de déploiement.

Environnement standard App Engine

La plupart des composants de votre application dans l'environnement standard suivent un processus de migration automatisé. Toutefois, pour une transition fluide vers Artifact Registry, assurez-vous que votre compte de service dispose des autorisations requises suivantes :

  • Pour les déploiements standards existants, le compte de service de déploiement (le compte de service App Engine par défaut (PROJECT_ID@appspot.gserviceaccount.com) ou votre compte de service personnalisé) doit disposer d'un rôle qui accorde l'autorisation d'écriture Artifact Registry explicite artifactregistry.repositories.uploadArtifacts. Pour trouver les rôles associés à votre compte de service de déploiement, consultez Gérer l'accès aux comptes de service.

  • Les nouveaux déploiements peuvent utiliser Artifact Registry si l'un des rôles suivants est présent dans le compte de service associé aux déploiements :

    Si aucun de ces rôles n'est présent, attribuez le rôle Rédacteur Artifact Registry (roles/artifactregistry.writer) à votre compte de service de déploiement.

Si vous ne fournissez pas les autorisations requises, vous ne pourrez pas déployer de nouvelles versions dans l'environnement standard.

Lors des migrations automatiques, Google Cloud peut créer des dépôts et copier des images de Container Registry vers Artifact Registry.

Environnement flexible App Engine

La plupart des composants de votre application dans l'environnement flexible suivent un processus de migration automatisé. Toutefois, pour une transition fluide vers Artifact Registry, assurez-vous que votre compte de service dispose des autorisations requises suivantes :

  • Pour que les déploiements flexibles existants fonctionnent comme prévu avec Artifact Registry, le compte de service de déploiement (le compte de service App Engine par défaut (PROJECT_ID@appspot.gserviceaccount.com) ou votre compte de service personnalisé) doit disposer d'un rôle qui accorde les autorisations Artifact Registry explicites, telles que artifactregistry.repositories.downloadArtifacts pour la lecture et artifactregistry.repositories.uploadArtifacts pour l'écriture. Pour trouver les rôles associés à votre compte de service de déploiement, consultez Gérer l'accès aux comptes de service.

  • Les nouveaux déploiements peuvent utiliser Artifact Registry si l'un des rôles suivants est présent dans le compte de service associé aux déploiements :

    Si aucun de ces rôles n'est présent, attribuez le rôle Administrateur du dépôt Artifact Registry (roles/artifactregistry.repoAdmin) à votre compte de service de déploiement.

Si vous ne fournissez pas les autorisations requises, vous ne pourrez pas déployer d'applications dans l'environnement flexible. Le scaling et le redémarrage des instances échouent également.

Lors des migrations automatiques, Google Cloud peut créer des dépôts et copier des images de Container Registry vers Artifact Registry.

Migrer vers Artifact Registry pour les images de conteneurs créées manuellement

Le processus de migration automatisé ne s'applique pas si vous avez déjà déployé vos applications à l'aide d'images de conteneurs prédéfinies ou créées manuellement à partir de Container Registry. Par exemple, le processus de migration automatisé ne fonctionne pas si vous avez créé des images de conteneur avec Docker, que vous les avez transférées vers Container Registry et que vous avez déployé vos applications à l'aide de la commande gcloud app deploy --image-url.

Si vous utilisez des images de conteneurs préconfigurées ou créées manuellement à partir de Container Registry pour déployer vos applications, choisissez l'une des options suivantes pour migrer vers Artifact Registry :

  • Utilisez l'outil de migration automatique pour migrer de Container Registry vers les dépôts gcr.io hébergés sur Artifact Registry. Si vous utilisez cet outil, vous n'avez pas besoin de redéployer de nouvelles versions de votre service. Pour en savoir plus, consultez Migrer automatiquement de Container Registry vers Artifact Registry.

  • Déplacez manuellement les images de conteneur de Container Registry vers Artifact Registry, puis redéployez de nouvelles versions de votre service. Pour en savoir plus, consultez Migrer manuellement vers des dépôts gcr.io dans Artifact Registry.

  • Utilisez l'option copy-only pour copier vos images de conteneur dans Artifact Registry et redéployer de nouvelles versions de votre service.