Pour gérer les applications lorsque tous les composants se trouvent dans un seul projetGoogle Cloud , vous pouvez configurer un projet de gestion autonome dans App Hub. Cette limite de projet unique permet à App Hub de découvrir automatiquement les ressources compatibles du projet afin que vous puissiez les organiser en applications.
Limites
La limite d'un seul projet est compatible avec des fonctionnalités différentes de celles de 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 la compatibilité des fonctionnalités entre les modèles de projet unique et de niveau dossier, consultez Compatibilité des fonctionnalités par type de limite.
Avant de commencer
Choisissez le projet Google Cloud que vous souhaitez utiliser pour gérer vos applications. Ce projet fonctionnera comme un projet de gestion autonome. Vous pouvez utiliser un projet existant ou en créer un.
Rôles requis
Pour obtenir les autorisations nécessaires pour configurer un projet unique 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 :
-
Gérer les ressources, les autorisations et la facturation sur le projet : Propriétaire du projet (
roles/owner) -
Gérer tous les composants d'application du projet : Administrateur App Hub (
roles/apphub.admin)
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 de l'application. 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
Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet.
Accédez à la page Présentation depuis App Hub :
Cliquez sur Configurer App Hub.
Si votre projet se trouve déjà dans un dossier compatible avec les applications, la page n'affiche pas l'option Configurer App Hub. À la place, 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 d'un projet unique. Pour en savoir plus sur les considérations liées à la hiérarchie des ressources pour la gestion des applications, consultez Planifier la hiérarchie des ressources pour la gestion des applications.
Sur la page Activer App Hub, choisissez 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 la configuration des contrôles d'accès initiaux et, éventuellement, l'ajout de projets supplémentaires pour les limites de plusieurs projets.
Notez le nom et l'ID du projet. Ces informations identifient le projet de gestion. Vous utiliserez ces valeurs pour accorder l'accès.
Consultez la liste des API en cours d'activation. Certaines API entraînent des coûts. Obtenez des infos sur les coûts des API ou cliquez sur chaque API pour voir les coûts associés.
Cliquez sur Continuer.
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 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 commencer par un guide de démarrage rapide pour les applications.
Si vous avez sélectionné Configuration complète, accordez à vos administrateurs un accès personnalisé centré sur l'application :
Dans l'onglet Définir la limite, vérifiez les informations de 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 d'un seul projet, n'ajoutez aucun projet supplémentaire.
Cliquez sur Continuer.
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.
Dans le champ Nouveaux comptes principaux, saisissez les utilisateurs, groupes ou comptes de service qui doivent disposer d'un accès administrateur aux tâches centrées sur l'application dans le projet.
Cliquez sur Attribuer des rôles, puis sur Terminer.
Vous pouvez maintenant enregistrer des ressources existantes dans une application ou créer un modèle d'application avec Application Design Center.
Vous pourrez ensuite attribuer des rôles IAM supplémentaires à vos comptes principaux depuis la page IAM. Pour en savoir plus, consultez Attribuer un rôle IAM à l'aide de la console Google Cloud .
gcloud
-
Dans la console Google Cloud , activez Cloud Shell.
En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement de shell dans lequel la Google Cloud CLI est déjà installée, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.
Assurez-vous que la version la plus récente de la Google Cloud CLI est installée :
gcloud components updateDéfinissez le projet comme projet par défaut pour les commandes :
gcloud config set project PROJECT_IDRemplacez
PROJECT_IDpar l'ID du projet.Activez l'API App Hub :
gcloud services enable apphub.googleapis.com \ --project PROJECT_IDAssociez le projet à lui-même pour créer un périmètre de gestion des applications :
gcloud apphub boundary update \ --crm-node=projects/PROJECT_ID \ --project=PROJECT_ID \ --location=globalCette commande configure le projet en tant que son propre projet de gestion, ce qui permet à App Hub de découvrir automatiquement toutes les ressources compatibles qu'il contient.
Vérifiez l'état du rattachement :
gcloud apphub boundary describe \ --project=PROJECT_ID \ --location=globalUn résultat semblable à l'exemple suivant doit s'afficher :
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 d'administration terminée, les API requises pour la gestion des applications sont activées, et vous pouvez commencer à utiliser App Hub pour regrouper les services et les charges de travail dans des applications. Vous pouvez également consulter 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 de ce projet à l'aide d'App Hub, vous devez leur attribuer les rôles et autorisations App Hub appropriés.
Procédez comme suit :
Console
Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner le projet de gestion.
Accédez à la page IAM :
Cliquez sur Accorder l'accès. Le volet Accorder l'accès s'affiche.
Dans le champ Nouveaux comptes principaux, saisissez l'adresse e-mail du compte principal auquel vous souhaitez accorder l'accès à App Hub.
Cliquez sur Sélectionner un rôle, puis saisissez App Hub dans le champ Filtre.
Sélectionnez le rôle IAM App Hub que vous souhaitez attribuer au compte principal, puis cliquez sur Enregistrer.
gcloud
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 respecter le formatusername@yourdomain, par exemplemy.user@example.com.ROLE_NAME: rôle IAM App Hub que vous souhaitez attribuer au compte principal, par exempleroles/apphub.admin.
Modifier le périmètre de gestion des applications
Si vous souhaitez modifier le projet qui définit votre limite de projet unique, désactivez la gestion des applications sur l'ancien projet et activez-la sur le nouveau. Les données de votre application ne sont pas migrées, et vous devez recréer vos applications dans le nouveau projet.
Pour passer d'une limite de 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 sur un projet
Vous pouvez désactiver la gestion des applications sur un projet si vous ne souhaitez plus gérer ses ressources dans les applications App Hub.
Lorsque vous désactivez la gestion des applications sur le projet, celui-ci est dissocié de son périmètre de gestion des applications. Les services et les charges de travail de vos applications continuent d'exister, mais leur état d'enregistrement passe à "dissocié". Si vous décidez de réactiver la gestion des applications sur 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
Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner le projet de gestion.
Accédez à la page Paramètres de limite depuis App Hub :
Cochez la case du projet pour le dissocier de la limite et désactiver la gestion des applications.
Cliquez sur Dissocier des projets.
La table Projets dans votre périmètre s'actualise et n'affiche plus les informations de votre projet.
gcloud
-
Dans la console Google Cloud , activez Cloud Shell.
En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement de shell dans lequel la Google Cloud CLI est déjà installée, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.
Assurez-vous que la version la plus récente de la Google Cloud CLI est installée :
gcloud components updateDéfinissez le projet comme projet par défaut pour les commandes :
gcloud config set project PROJECT_IDRemplacez
PROJECT_IDpar l'ID du projet.Dissociez 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 le rattachement, ce qui désactive la gestion des applications pour le projet.
Confirmez la dissociation en décrivant la limite :
gcloud apphub boundary describe \ --project=PROJECT_ID \ --location=globalLa sortie ne contient pas de champ
crmNode, ce qui confirme que la gestion des applications est désactivée sur le projet.Si vous ne comptez plus utiliser les 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
- Guide de démarrage rapide : créer une application à partir de ressources existantes
- Enregistrer des ressources dans une application
- Configurer la surveillance des applications
- Rôles et autorisations IAM App Hub
- Présentation d'App Hub