Migrer automatiquement de Container Registry vers Artifact Registry

Utilisez l'outil de migration automatique pour effectuer la transition de Container Registry vers Dépôts gcr.io hébergés sur Artifact Registry ou vers Artifact Registry standard des dépôts.

La migration vers les dépôts gcr.io Artifact Registry peut être effectuée sur les points de terminaison Container Registry qui reçoivent du trafic sans nécessiter de temps d'arrêt ni d'interruption de service.

L'outil de migration automatique peut effectuer les actions suivantes en fonction du chemin de transition que vous choisissez :

  • Créez des dépôts gcr.io ou standards dans Artifact Registry pour chacun de vos projets gcr.io listés dans la région correspondante.
  • Suggérez une stratégie IAM pour chaque dépôt et appliquez le ou ignorer l'application selon les préférences de l'utilisateur.
  • Rediriger tout le trafic des points de terminaison gcr.io vers Artifact Registry.
  • Copiez toutes les images de conteneur stockées dans Container Registry dans vos dépôts gcr.io ou dépôts standards Artifact Registry, même si vous avez déjà activé la redirection.

Avant de commencer

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command: 

    gcloud init
  3. Choisissez une option de transition.
    • Si vous passez aux dépôts gcr.io hébergés sur Artifact Registry, activez l'API Artifact Registry dans les projets Container Registry que vous souhaitez migrer. L'outil vous invite également à activer l'API Artifact Registry si vous ignorez cette étape.

      Enable the Artifact Registry API.

      Enable the API

    • Si vous passez à des dépôts Artifact Registry standards, activez l'API Artifact Registry dans le projet vers lequel vous souhaitez migrer vos images de conteneur Container Registry. Vous pouvez utiliser le projet où Container Registry est activé, ou il s'agit d'un autre projet.

      Enable the Artifact Registry API.

      Enable the API

Rôles requis

Les rôles suivants sont requis pour toutes les options de transition utilisant le outil de migration.

Rôles requis par le compte de service Artifact Registry:

Pour vous assurer que le compte de service Artifact Registry dispose des autorisations les autorisations permettant de copier des images de Container Registry vers Artifact Registry ; demandez à votre administrateur d'accorder au compte de service Artifact Registry le rôle Rôle IAM Lecteur des objets Storage (roles/storage.objectViewer) sur le projet Container Registry. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Votre administrateur peut également attribuer au compte de service Artifact Registry les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Rôles requis pour générer des recommandations IAM:

Pour obtenir les autorisations nécessaires pour analyser une stratégie d'autorisation, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le ou les projets Container Registry que vous souhaitez migrer :

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour analyser une stratégie d'autorisation. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour analyser une stratégie d'autorisation :

  • cloudasset.assets.analyzeIamPolicy
  • cloudasset.assets.searchAllResources
  • cloudasset.assets.searchAllIamPolicies
  • Pour analyser les stratégies avec des rôles IAM personnalisés: iam.roles.get
  • Pour analyser les règles à l'aide de la Google Cloud CLI : serviceusage.services.use

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Les rôles suivants sont attribués sur différentes ressources en fonction de vos option de transition.

Dépôts gcr.io

Pour obtenir les autorisations nécessaires pour passer aux dépôts gcr.io hébergés sur Artifact Registry, demandez à votre administrateur de vous accorder les rôles IAM suivants :

  • Créez des dépôts Artifact Registry et accordez l'accès à chaque dépôt: Administrateur Artifact Registry (roles/artifactregistry.admin) sur le projet Google Cloud contenant vos images Container Registry
  • Afficher et gérer la configuration Container Registry existante appliquée aux buckets de stockage Cloud Storage : Storage Admin (roles/storage.admin) sur le projet Google Cloud contenant vos images Container Registry

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

dépôts standards

Pour obtenir les autorisations nécessaires pour passer aux dépôts Artifact Registry standards, demandez à votre administrateur de vous accorder le rôles IAM suivants:

  • Créez des dépôts Artifact Registry et accordez l'accès à des dépôts individuels : Administrateur Artifact Registry (roles/artifactregistry.admin) sur le projet Google Cloud où l'API Artifact Registry est activée.
  • Affichez et gérez la configuration Container Registry existante appliquée aux buckets de stockage Cloud Storage: Administrateur Storage (roles/storage.admin) sur le projet Google Cloud contenant vos images Container Registry

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Migrer vers des dépôts gcr.io hébergés sur Artifact Registry

Vous pouvez migrer un ou plusieurs projets Google Cloud en même temps à l'aide de gcloud artifacts docker upgrade migrate .

Pour migrer vers des dépôts gcr.io, exécutez la commande suivante.

gcloud artifacts docker upgrade migrate \
    --projects=PROJECTS

Où PROJECTS est l'ID d'un seul projet que vous souhaitez migrer vers des dépôts gcr.io hébergés sur Artifact Registry, ou une liste d'ID de projet séparés par une virgule que vous souhaitez migrer vers des dépôts gcr.io hébergés sur Artifact Registry.

L'outil de migration effectue les étapes suivantes :

  • Crée des dépôts gcr.io dans Artifact Registry pour chacun des vos projets gcr.io répertoriés dans la région correspondante.
  • Suggère une stratégie IAM pour chaque dépôt, puis applique la stratégie ou ignore l'application en fonction des préférences de l'utilisateur.
  • Redirige tout le trafic du point de terminaison gcr.io vers Artifact Registry. Artifact Registry diffuse temporairement les images manquantes en les copiant depuis Container Registry au moment de la requête jusqu'à ce que toutes les images de conteneur soient copiées dans Artifact Registry.
  • Il copie toutes les images de conteneurs stockées dans vos buckets gcr.io dans le bucket Dépôts gcr.io hébergés sur Artifact Registry.
  • Désactive la copie au moment de la requête. Le dépôt gcr.io Artifact Registry ne dépend plus de Container Registry.

Si vous souhaitez uniquement copier les images extraites de Container Registry au cours des 30 derniers 150 jours, vous pouvez inclure l'indicateur --recent-images=DAYS. Remplacez DAYS par le nombre de jours, compris entre 30 et 150, durant lesquels le doit vérifier s'il y a des extractions à l'intérieur.

Si vous souhaitez copier un nombre spécifique de versions récemment importées de chaque image, vous pouvez inclure l'indicateur --last-uploaded-versions=VERSIONS. Remplacez VERSIONS par le nombre de versions que vous souhaitez copier. pour chaque image. Si de nouvelles images sont importées pendant la copie, le nombre de versions spécifié peut être dépassé.

L'option --recent-images et l'option --last-uploaded-versions sont mutuellement exclusives et ne peuvent pas être utilisées ensemble.

Si vous rencontrez des erreurs ou des expirations de délai, vous pouvez réexécuter la commande en toute sécurité. Les étapes terminées sont ignorées.

Migrer vers des dépôts Artifact Registry standards

  1. Pour migrer votre projet gcr.io vers un dépôt Artifact Registry, exécutez la la commande suivante.

    gcloud artifacts docker upgrade migrate \
    --from-gcr=GCR_HOSTNAME/GCR_PROJECT \
    --to-pkg-dev=AR_PROJECT/AR_REPOSITORY

    Remplacez les éléments suivants :

    • GCR_HOSTNAME par le nom d'hôte de Container Registry. Le nom d'hôte dépend de l'emplacement de stockage de vos images de conteneurs:

      • gcr.io héberge les images aux États-Unis.
      • us.gcr.io héberge les images aux États-Unis, dans un bucket de stockage distinct de celui utilisé pour les images hébergées par gcr.io.
      • eu.gcr.io héberge les images dans les États membres de l'Union européenne.
      • asia.gcr.io héberge les images en Asie.

    • GCR_PROJECT par l'ID de votre projet Google Cloud Container Registry. Si l'ID de votre projet contient le signe deux-points (:), consultez la section Projets à l'échelle du domaine.

    • AR_PROJECT par l'ID du projet Google Cloud dans lequel vous avez activé l'API Artifact Registry.

    • AR_REPOSITORY par le nom de votre dépôt Artifact Registry.

L'outil de migration effectue les étapes suivantes :

  • Crée le dépôt Artifact Registry s'il n'existe pas déjà.
  • Suggère une stratégie IAM pour le dépôt et applique la ou ignore l'application selon les préférences de l'utilisateur.
  • Copier les images dans la région Container Registry et le projet spécifiés dans votre dépôt Artifact Registry

Si vous souhaitez uniquement copier les images extraites de Container Registry au cours des 30 derniers 150 jours, vous pouvez inclure l'indicateur --recent-images=DAYS. Remplacez DAYS par le nombre de jours, compris entre 30 et 150, durant lesquels le doit vérifier s'il y a des extractions à l'intérieur.

Si vous rencontrez des erreurs ou des expirations de délai, vous pouvez réexécuter la commande en toute sécurité, et les étapes terminées sont ignorées.

Copier les images

L'outil de migration copie automatiquement vos images de conteneurs lorsque vous l'exécutez, Si vous souhaitez ignorer toutes les autres étapes de la migration automatique et utiliser pour copier des images vers Artifact Registry, vous pouvez transmettre le --copy-only .

Pour copier des images de Container Registry vers un dépôt gcr.io hébergé sur Dans Artifact Registry, exécutez la commande suivante:

gcloud artifacts docker upgrade migrate \
    --projects=PROJECTS \
    --copy-only

Où PROJECTS est l'ID d'un seul projet que vous souhaitez migrer vers des dépôts gcr.io hébergés sur Artifact Registry, ou une liste d'ID de projet séparés par une virgule que vous souhaitez migrer vers des dépôts gcr.io hébergés sur Artifact Registry.

L'outil ignore toutes les étapes de migration et copie les images des projets spécifiés depuis Container Registry vers les dépôts gcr.io hébergés sur Artifact Registry.

Pour copier des images de Container Registry dans un dépôt Artifact Registry standard, exécutez la commande suivante:

gcloud artifacts docker upgrade migrate \
    --from-gcr=GCR_HOSTNAME/GCR_PROJECT \
    --to-pkg-dev=AR_PROJECT/AR_REPOSITORY \
    --copy-only

Remplacez les éléments suivants :

  • GCR_HOSTNAME par le nom d'hôte de Container Registry. Le nom d'hôte dépend de l'emplacement de stockage de vos images de conteneurs:

    • gcr.io héberge les images aux États-Unis.
    • us.gcr.io héberge les images aux États-Unis, dans un bucket de stockage distinct de celui utilisé pour les images hébergées par gcr.io.
    • eu.gcr.io héberge les images dans les États membres de l'Union européenne.
    • asia.gcr.io héberge les images en Asie.

  • GCR_PROJECT par l'ID de votre projet Google Cloud Container Registry. Si l'ID de votre projet contient le signe deux-points (:), consultez la section Projets à l'échelle du domaine.

  • AR_PROJECT par l'ID du projet Google Cloud dans lequel vous avez activé l'API Artifact Registry.

  • AR_REPOSITORY par le nom de votre dépôt Artifact Registry.

L'outil ignore toutes les étapes de migration et copie les images des votre emplacement et votre projet Container Registry vers votre dépôt Artifact Registry.

Vous pouvez également utiliser l'option --copy-only pour recommencer la copie d'images si vous avez un ou a expiré pendant le processus.

Étape suivante