Migrer des projets dans une organisation

Dès lors qu'une ressource Organisation Google Cloud a été créée pour votre domaine, vous pouvez y transférer vos projets existants. Pour ce faire, vous devez être propriétaire du projet à déplacer et détenir le rôle Créateur de projets 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.

Migrer des projets associés à une organisation

Si un projet est associé à une organisation, vous ne pouvez plus le retirer de celle-ci ni le déplacer vers 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.

Migrer des projets non associés à une organisation

Pour migrer un projet à l'aide de l'API ou de l'outil gcloud, vous devez disposer des autorisations suivantes :

  • resourcemanager.projects.create sur l'organisation de destination, généralement accordée par le rôle Créateur de projets

  • resourcemanager.projects.update et resourcemanager.projects.setIAMPolicy sur le projet que vous migrez, généralement accordées par le rôle Propriétaire

Pour migrer un projet à l'aide de Google Cloud Console, vous devez également disposer de l'autorisation resourcemanager.organizations.get sur l'organisation de destination. S'il vous manque une de ces autorisations, l'organisation de destination ne s'affiche pas dans Google Cloud Console.

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 No Organization (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 migrer.

    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 déplacer 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 stratégies IAM et les règles d'administration

Les stratégies 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 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 Éditeur de projet défini au niveau de l'organisation, il aura également ce rôle pour tout projet migré dans 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.

Migrer des comptes de facturation existants

Si vous êtes un client Google Workspace ou Cloud Identity et que vous possédez déjà des comptes de facturation Cloud, vous pouvez les migrer vers votre organisation. La migration d'un compte de facturation Cloud vers une organisation n'a pas d'incidence sur les services du projet.

Pour migrer des comptes de facturation, vous devez disposer des rôles suivants :

  • Vous devez disposer du rôle Administrateur de compte de facturation pour le compte de facturation Cloud que vous souhaitez migrer.
  • Vous devez disposer du rôle Créateur de compte de facturation au sein de l'organisation vers laquelle vous souhaitez migrer votre compte de facturation Cloud.
  • Si vous souhaitez migrer un compte de facturation Cloud à partir d'une organisation existante, vous devez disposer du rôle Administrateur de compte de facturation pour l'organisation à partir de laquelle vous effectuez la migration du compte de facturation Cloud.

Pour savoir comment attribuer ces rôles, consultez la page Présentation du contrôle des accès à Cloud Billing.

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 le menu "Sélectionner une organisation", sélectionnez une organisation pour afficher les comptes de facturation Cloud qui lui sont associés, ou sélectionnez Aucune organisation pour afficher les comptes de facturation qui ne sont associés à aucune organisation.
  3. Dans la section Nom du compte de facturation, cliquez sur le nom du compte de facturation Cloud que vous souhaitez migrer. La page de présentation du compte de facturation s'ouvre.
  4. Dans le menu de navigation "Facturation", cliquez sur Gestion des comptes.
  5. En haut de la page "Gestion des comptes", cliquez sur Modifier l'organisation, puis sélectionnez l'organisation vers laquelle vous souhaitez migrer le compte de facturation Cloud.