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 nouveaux 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, et 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é les outils de migration automatisée, 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 (compte de service par défaut App Engine (PROJECT_ID@appspot.gserviceaccount.com) ou votre compte de service personnalisé) doit disposer d'un rôle qui accorde l'autorisation d'écriture explicite artifactregistry.repositories.uploadArtifacts dans Artifact Registry. Pour trouver les rôles associés à votre compte de service de déploiement, consultez la section 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 Écrivain 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 automatisées, 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 (compte de service par défaut d'App Engine (PROJECT_ID@appspot.gserviceaccount.com) ou votre compte de service personnalisé) doit disposer d'un rôle qui accorde les autorisations explicites d'Artifact Registry, 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 la section 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:

    • Rôle Éditeur

    • Rôle Artifact Registry prédéfini avec accès en lecture et en écriture, tel que "Artifact Registry Writer" (Écrivain Artifact Registry) (roles/artifactregistry.writer).

    • Rôle personnalisé qui accorde les autorisations artifactregistry.repositories.downloadArtifacts et artifactregistry.repositories.uploadArtifacts. Vous pouvez vérifier l'accès aux rôles personnalisés à partir de la consoleGoogle Cloud ou en exécutant la commande gcloud iam roles describe.

    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 pouvez pas déployer d'applications dans l'environnement flexible. Le scaling et le redémarrage des instances échouent également.

Lors des migrations automatisées, 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 conteneur compilées manuellement

Le processus de migration automatisée ne s'applique pas si vous avez précédemment déployé vos applications à l'aide d'images de conteneur prédéfinies ou créées manuellement à partir du registre de conteneurs. Par exemple, le processus de migration automatisée ne fonctionne pas si vous avez créé des images de conteneur avec Docker, importé ces images dans Container Registry et déployé vos applications à l'aide de la commande gcloud app deploy --image-url.

Si vous utilisez des images de conteneur prédéfinies 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 passer de Container Registry à des dépôts gcr.io hébergés sur Artifact Registry. Si vous utilisez cet outil, vous n'avez pas besoin de redéployer les nouvelles versions de votre service. Pour en savoir plus, consultez la section Migrer automatiquement de Container Registry vers Artifact Registry.

  • Transférez manuellement les images de conteneur de Container Registry vers Artifact Registry et redéployez les nouvelles versions de votre service. Pour en savoir plus, consultez la section Migration manuelle 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 les nouvelles versions de votre service.