Effectuer la migration de projets dans une organisation

Dès lors qu'une ressource Organisation Google Cloud a été créée pour votre domaine, vous pouvez transférer vos projets existants dans cette organisation. Pour ce faire, vous devez être propriétaire ou éditeur des projets à déplacer, et détenir le rôle de Créateur de projet au sein de l'organisation.

Tous les projets créés après la création de la ressource Organisation appartiendront automatiquement à cette ressource. Vous pouvez transférer un projet dans une organisation à l'aide de Cloud Console, de l'API Resource Manager ou de l'outil de ligne de commande gcloud.

Effectuer la migration de projets associés à une organisation

Si un projet est associé à une organisation, vous ne pouvez pas redéfinir la sélection sur Aucune organisation ni transférer ce projet à une autre organisation sans faire intervenir l'assistance Google Cloud. Si vous devez effectuer la migration d'un projet après l'avoir associé à une organisation, consultez la page Migrer des projets vers une autre organisation.

Effectuer la migration de projets non associés à une organisation

Pour effectuer la migration d'un projet, vous devez disposer du rôle de créateur de projet (roles/resourcemanager.projectCreator) dans l'organisation vers laquelle vous souhaitez transférer votre projet. Vous devez également détenir le rôle de déplaceur de projet (roles/resourcemanager.projectMover) pour le projet que vous souhaitez transférer. Si vous ne possédez pas ces rôles, l'organisation cible n'apparaîtra pas dans Google Cloud Console parmi les options possibles pour la migration.

La migration de projet est irréversible. Une fois qu'un projet est associé à une organisation, vous ne pouvez plus le retirer de celle-ci ni le déplacer vers une autre organisation. Si vous souhaitez déplacer un projet après l'avoir associé à une organisation, contactez l'assistance Google Cloud.

Console

Pour effectuer la migration d'un projet vers une organisation, procédez comme suit :

  1. Ouvrez la page IAM et administration > Paramètres dans Cloud Console :

    Ouvrir la page "Paramètres"

  2. Sélectionnez l'outil de sélection de projets en haut de la page.

  3. Dans l'outil de sélection d'organisations, sélectionnez Aucune organisation. Si vous n'êtes associé à aucune organisation, l'outil de sélection d'organisations ne s'affiche pas et vous pouvez ignorer cette étape.

  4. Sélectionnez le projet que vous souhaitez transférer.

    Capture d'écran de l'outil de sélection de projets

  5. En haut de la page, cliquez sur Effectuer la migration.

  6. Dans la liste déroulante Organisation, sélectionnez l'organisation vers laquelle vous souhaitez migrer votre projet.

Après l'ajout d'un projet à une organisation, vous ne pouvez pas annuler la sélection par vous-même.

gcloud

Pour migrer un projet dans une organisation, exécutez la commande suivante :

gcloud alpha projects move PROJECT_ID /
    --organization ORGANIZATION_ID

Où :

  • PROJECT_ID est l'identifiant du projet que vous souhaitez transférer dans l'organisation.
  • ORGANIZATION_ID est l'identifiant de l'organisation vers laquelle vous souhaitez déplacer le projet.

Après l'ajout d'un projet à une organisation, vous ne pouvez pas annuler la sélection par vous-même.

API

À l'aide de l'API Resource Manager, vous pouvez transférer un projet dans la ressource Organisation en définissant son champ parent sur l'ID de l'organisation.

Pour effectuer la migration d'un projet vers l'organisation, procédez comme suit :

  • Récupérez l'objet project à l'aide de la méthode projects.get().
  • Définissez son champ parent sur l'ID de l'organisation.
  • Mettez à jour l'objet project à l'aide de la méthode projects.update().

Vous ne pouvez pas modifier le champ parent après l'avoir défini.

L'extrait de code suivant illustre les étapes ci-dessus :

    project = crm.projects().get(projectId=flags.projectId).execute()
    project['parent'] = {
        'type': 'organization',
        'id': flags.organizationId
    }

    project = crm.projects().update(
    projectId=flags.projectId, body=project).execute()

Remarque sur les règles d'administration et IAM

Les règles de Cloud IAM déjà définies pour un projet sont importées avec celui-ci. Cela signifie que les utilisateurs disposant d'autorisations sur un projet avant son déplacement conservent les autorisations après sa migration dans l'organisation.

Les autorisations Cloud IAM sont héritées et s'ajoutent les unes aux autres. Les projets reçoivent les rôles existants définis au niveau de l'organisation lorsqu'ils sont déplacés dans l'organisation. Si, par exemple, bob@myorganization.com dispose du rôle d'éditeur de projet défini au niveau de l'organisation, il aura également ce rôle dans tout autre projet migré vers l'organisation. Cela n'a pas d'incidence sur les autorisations dans les projets existants, mais a pour conséquence que davantage d'utilisateurs peuvent y accéder.

De même, les règles d'administration sont également héritées. Par défaut, aucune règle d'administration n'est définie pour une organisation lors de sa création. Si vous définissez par la suite des règles d'administration, vous devez vous assurer que les projets que vous déplacez dans l'organisation sont en accord avec celles-ci.

Effectuer la migration de comptes de facturation existants

Si vous êtes un client G Suite ou Cloud Identity et que vous possédez déjà des comptes de facturation, vous pouvez effectuer leur migration vers votre organisation. Pour procéder à la migration de comptes de facturation, vous devez disposer des rôles de Créateur de compte de facturation et d'Administrateur de la facturation pour l'organisation vers laquelle vous souhaitez transférer votre projet. Pour savoir comment attribuer ces rôles, consultez la page Gérer les rôles d'organisation par défaut. La migration d'un compte de facturation vers une organisation n'a aucune incidence sur les services du projet.

Pour effectuer la migration de vos comptes de facturation existants vers une organisation, procédez comme suit :

  1. Accédez à la page Facturation de Cloud Console :
    ACCÉDER À LA PAGE "FACTURATION"
  2. Dans la liste déroulante située en haut de la page, sélectionnez Aucune organisation pour afficher les comptes de facturation qui ne sont pas associés à une organisation.
  3. Dans la section Nom du compte de facturation, cliquez sur le nom du compte de facturation dont vous souhaitez effectuer la migration. La page "Vue d'ensemble du compte de facturation" s'affiche.
  4. Sur la droite, à côté de Compte de facturation, cliquez sur Gérer.
  5. Sur la page de gestion du compte qui s'affiche, cliquez sur Modifier l'organisation, puis sélectionnez l'organisation vers laquelle vous souhaitez effectuer la migration du compte de facturation.