Configurer un seul projet

Ce document explique comment configurer un seul projet Google Cloud pour gérer les applications. Cette configuration est également appelée limite d'un seul projet.

Dans cette configuration, le projet Google Cloud est configuré pour gérer ses propres applications et composants, agissant comme un projet de gestion autonome. Cette approche est le moyen le plus rapide de commencer à gérer les applications si tous les composants de votre application résident dans ce même projet. App Hub détecte automatiquement toutes les ressources compatibles du projet, ce qui permet de les organiser dans des applications.

Limites

La limite d'un seul projet offre une compatibilité différente avec les fonctionnalités par rapport à la limite au niveau du dossier. App Hub, Application Design Center et Application Monitoring sont entièrement compatibles avec les projets uniques, mais d'autres services Google Cloud axés sur les applications, comme Cloud Hub et Gemini Cloud Assist, nécessitent une limite au niveau du dossier.

Pour comparer les fonctionnalités compatibles entre les modèles au niveau du projet unique et au niveau du dossier, consultez Fonctionnalités compatibles par type de limite.

Avant de commencer

Choisissez le projet Google Cloud que vous souhaitez utiliser pour gérer vos applications. Ce projet servira de projet de gestion autonome. Vous pouvez utiliser un projet existant ou en créer un autre.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer un seul projet pour la gestion des applications, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet que vous souhaitez configurer en tant que projet de gestion autonome :

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

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

Activer la gestion des applications sur un projet

Cette action configure le projet en tant que projet de gestion autonome et active les API requises pour les métadonnées et les configurations des applications. Le projet est alors appelé projet compatible avec les applications.

Pour activer la gestion des applications sur un seul projet, procédez comme suit :

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Assurez-vous que la dernière version de Google Cloud CLI est installée :

    gcloud components update

  3. Trouvez l'ID du projet.

  4. Définissez le projet comme projet par défaut pour les commandes :

    gcloud config set project PROJECT_ID

    Remplacez PROJECT_ID par l'ID du projet.

  5. Activez l'API App Hub :

    gcloud services enable apphub.googleapis.com \
    --project PROJECT_ID

  6. Associez le projet à lui-même pour créer une limite de gestion des applications :

    gcloud alpha apphub boundary update \
    --crm-node="projects/$(gcloud projects describe PROJECT_ID --format='value(projectNumber)')" \
    --project=PROJECT_ID \
    --location=global

    Cette commande configure le projet comme son propre projet de gestion, ce qui permet à App Hub de découvrir automatiquement toutes les ressources compatibles qu'il contient.

  7. Vérifiez l'état de la pièce jointe :

    gcloud alpha apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

    Vous obtenez un résultat semblable à l'exemple suivant :

    name: projects/PROJECT_ID/locations/LOCATION/boundary
crmNode: projects/PROJECT_NUMBER
createTime: 2025-08-28T19:04:47Z
updateTime: 2025-08-28T19:04:47Z
type: AUTOMATIC

    PROJECT_NUMBER est le numéro de projet correspondant à votre ID de projet.

    8. Une fois la configuration du projet de gestion terminée, les API requises pour la gestion des applications sont activées. Vous pouvez alors commencer à utiliser App Hub pour regrouper les services et les charges de travail dans les applications. Si vous le souhaitez, consultez les API recommandées pour accéder aux fonctionnalités avancées.

    Attribuer des rôles et des autorisations App Hub

    Pour permettre aux utilisateurs de découvrir, d'enregistrer et de gérer les composants d'application dans ce projet à l'aide d'App Hub, vous devez leur accorder les rôles et autorisations App Hub appropriés.

    Procédez comme suit :

    Console

    1. Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner le projet de gestion.

    2. Accédez à la page IAM :

      Accéder à IAM

    3. Cliquez sur  Accorder l'accès. Le volet Accorder l'accès s'affiche.

    4. Dans le champ Nouveaux comptes principaux, saisissez l'adresse e-mail du compte principal auquel vous souhaitez accorder l'accès à App Hub.

    5. Cliquez sur Sélectionner un rôle, puis saisissez App Hub dans le champ Filtre.

    6. Sélectionnez le rôle IAM App Hub que vous souhaitez attribuer au compte principal, puis cliquez sur Enregistrer.

    gcloud

    1. Accordez l'accès aux comptes principaux dans le projet de gestion :

      gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='user:EMAIL_ADDRESS' \
    --role='ROLE_NAME'

      Remplacez les éléments suivants :

      • PROJECT_ID : ID du projet de gestion.
      • EMAIL_ADDRESS : adresse e-mail du compte principal qui doit obtenir l'accès à App Hub. Cette valeur doit être au format username@yourdomain, par exemple my.user@example.com.
      • ROLE_NAME : rôle IAM App Hub que vous souhaitez attribuer au compte principal, par exemple roles/apphub.admin.

    Modifier la limite de gestion des applications

    Si vous souhaitez modifier le projet qui définit votre limite de projet unique, désactivez la gestion des applications dans l'ancien projet et activez-la dans le nouveau. Les données de votre application ne sont pas migrées. Vous devez recréer vos applications dans le nouveau projet.

    Pour passer d'une limite à projet unique à une limite au niveau du dossier, configurez un dossier compatible avec les applications. Cette action configure un nouveau projet de gestion dans le dossier. Vous devrez recréer les applications dans ce nouveau projet de gestion.

    Désactiver la gestion des applications dans un projet

    Vous pouvez désactiver la gestion des applications dans un projet si vous ne souhaitez plus gérer ses ressources dans les applications App Hub.

    Lorsque vous désactivez la gestion des applications dans le projet, celui-ci est détaché de sa limite de gestion des applications. Les services et les charges de travail de vos applications continuent d'exister, mais leur état d'enregistrement passe à "Détaché". Si vous décidez de réactiver la gestion des applications dans le projet, App Hub peut redécouvrir vos applications, services et charges de travail, et mettre à jour l'état d'enregistrement si les ressources sous-jacentes existent toujours.

    Pour désactiver la gestion des applications sur un seul projet, procédez comme suit :

    1. In the Google Cloud console, activate Cloud Shell.

      Activate Cloud Shell

      At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

    2. Assurez-vous que la dernière version de Google Cloud CLI est installée :

      gcloud components update

    3. Trouvez l'ID du projet.

    4. Définissez le projet comme projet par défaut pour les commandes :

      gcloud config set project PROJECT_ID

      Remplacez PROJECT_ID par l'ID du projet.

    5. Détachez le projet de sa limite pour désactiver la gestion des applications :

      gcloud alpha apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --clear-crm-node

      Cette commande met à jour la ressource de limite et supprime la pièce jointe, ce qui désactive la gestion des applications pour le projet.

    6. Confirmez le détachement en décrivant la limite :

      gcloud alpha apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

      Le résultat ne contient pas de champ crmNode, ce qui confirme que la gestion des applications est désactivée dans le projet.

    7. Si vous n'avez plus besoin des fonctionnalités d'application dans ce projet, vous pouvez supprimer toutes les applications du projet, puis désactiver l'API App Hub :

      gcloud services disable apphub.googleapis.com \
    --project=PROJECT_ID

      8. Étapes suivantes