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 en 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 :

Console

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

  2. Accédez à la page Présentation depuis App Hub :

    Accéder à la page "Vue d'ensemble"

  3. Cliquez sur Configurer le hub d'applications.

    Si votre projet se trouve déjà dans un dossier compatible avec les applications, l'option Configurer App Hub ne s'affiche pas sur la page. Au lieu de cela, vous êtes invité à sélectionner le dossier compatible avec les applications ou à utiliser le projet actuel dans un menu. Sélectionnez le projet actuel pour continuer la configuration monoprojets. Pour en savoir plus sur les considérations relatives à la hiérarchie des ressources pour la gestion des applications, consultez Planifier la hiérarchie des ressources pour la gestion des applications.

  4. Sur la page Activer App Hub, sélectionnez l'une des options suivantes :

    • Configuration rapide : gérez une configuration par défaut pour les ressources de ce projet et définissez votre première application pour l'adoption initiale.
    • Configuration complète : gérez les configurations personnalisées de vos applications, y compris en configurant des contrôles d'accès initiaux et, éventuellement, en ajoutant d'autres projets pour les limites multiprojets.

  5. Notez le nom et l'ID du projet. Ces informations identifient le projet de gestion. Vous utiliserez ces valeurs pour accorder l'accès.

  6. Consultez la liste des API en cours d'activation. Certaines API entraînent des coûts. En savoir plus sur les coûts des API ou cliquez sur chaque API pour voir les coûts associés.

  7. Cliquez sur Continuer.

  8. Terminez la configuration en fonction de votre sélection :

    • Si vous avez sélectionné Configuration rapide, l'onglet Définir l'application vous permet de définir une application maintenant (facultatif) ou de terminer la configuration sans en créer une. Vous êtes maintenant prêt à créer des applications et à y enregistrer des ressources. Vous pouvez également vous lancer avec un guide de démarrage rapide pour les applications.

    • Si vous avez sélectionné Configuration complète, accordez un accès personnalisé axé sur les applications à vos administrateurs :

      1. Dans l'onglet Définir la limite, vérifiez les informations sur votre projet. Le tableau Projets dans votre limite n'affiche que le projet qui définit votre limite à projet unique. Pour la configuration de la limite à un seul projet, n'ajoutez aucun projet supplémentaire.

      2. Cliquez sur Continuer.

      3. Dans l'onglet Accorder l'accès, choisissez les rôles et autorisations IAM appropriés pour les administrateurs du projet. Pour obtenir la liste des rôles axés sur les applications recommandés pour les produitsGoogle Cloud , consultez Attribuer des rôles axés sur les applications à vos utilisateurs.

      4. Dans la zone Nouveaux comptes principaux, saisissez les utilisateurs, les groupes ou les comptes de service qui doivent disposer d'un accès administrateur aux tâches axées sur les applications dans le projet.

      5. Cliquez sur Attribuer des rôles, puis sur Terminer.

      Vous pouvez désormais enregistrer des ressources existantes dans une application ou créer un modèle d'application avec Application Design Center.

Vous pourrez attribuer des rôles IAM supplémentaires à vos comptes principaux ultérieurement sur la page IAM. Pour en savoir plus, consultez Attribuer un rôle IAM à l'aide de la console Google Cloud .

gcloud

  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 apphub boundary update \
    --crm-node=projects/PROJECT_ID \
    --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 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_ID
createTime: 2025-08-28T19:04:47Z
updateTime: 2025-08-28T19:04:47Z
type: AUTOMATIC

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 :

Console

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

    Accéder à la page d'accueil

  2. Accédez à la page Paramètres des limites depuis App Hub :

    Accéder aux paramètres de la limite

  3. Cochez la case du projet pour le dissocier de la limite et désactiver la gestion des applications.

  4. Cliquez sur Dissocier des projets.

    Le tableau Projets dans votre limite s'actualise et n'affiche plus les informations de votre projet.

gcloud

  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 apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --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 apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

    La sortie 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

Étapes suivantes