Configurer App Hub pour les dossiers compatibles avec les applications

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Console

1. Dans la console Google Cloud, accédez à la page IAM.

   Accéder à IAM

2. Assurez-vous que le sélecteur de projet de la barre de navigation supérieure affiche le dossier compatible avec les applications. Le sélecteur Purview vous indique dans quelle organisation, quel dossier ou quel projet vous travaillez. Si vous ne vous trouvez pas dans le dossier compatible avec les applications, procédez comme suit pour en sélectionner un:

   1. Dans l'outil de sélection Purview, cliquez sur l'option sélectionnée.
   2. Dans la boîte de dialogue Sélectionner une ressource, effectuez l'une des opérations suivantes :
      • Dans la liste des dossiers, sélectionnez le dossier FOLDER_DISPLAY_NAME.
      • Recherchez le dossier FOLDER_DISPLAY_NAME, puis sélectionnez-le.

3. Sur la page IAM, cliquez sur person_addAccorder l'accès. Le volet Accorder l'accès s'affiche.

4. Dans le champ Nouveaux comptes principaux, saisissez l'adresse e-mail de la personne chargée d'administrer App Hub, le rôle d'administrateur App Hub dans le dossier compatible avec les applications.

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

6. Sélectionnez le rôle Administrateur du hub d'applications, puis cliquez sur Enregistrer.

7. Répétez la procédure pour accorder le rôle Lecteur de la gestion des applications aux personnes afin qu'elles puissent afficher les données d'application et leurs attributs dans les servicesGoogle Cloud compatibles avec la gestion des applications. Ce rôle est accordé à la personne sur l'ensemble des projets et sous-dossiers du dossier compatible avec l'application.

8. Cliquez sur Enregistrer.

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. Exécutez la commande suivante à partir de Cloud Shell:

   gcloud components update

3. Accordez aux personnes qui administreront App Hub le rôle d'administrateur App Hub dans le dossier compatible avec les applications. Répétez la commande suivante pour chaque administrateur. Il doit disposer du rôle Administrateur App Hub pour créer des applications.

   gcloud projects add-iam-policy-binding MANAGEMENT_PROJECT_ID \
       --member='user:MANAGEMENT_PROJECT_ADMIN' \
       --role='roles/apphub.admin'
   

   Remplacez les éléments suivants :

   • MANAGEMENT_PROJECT_ID: ID du projet de gestion au format google-mpf-FOLDER_ID. Vous trouverez l'ID de votre projet de gestion sur la page Paramètres de la console Google Cloud, dans la section "Identity and Access Management (IAM) and Admin" (Gestion des identités et des accès (IAM) et administration). Si vous ne trouvez pas l'ID du projet de gestion, il est possible que vous ne vous trouviez pas dans un dossier compatible avec l'application. Dans le sélecteur de projets, sélectionnez votre dossier compatible avec les applications.
   • MANAGEMENT_PROJECT_ADMIN: l'utilisateur disposant du rôle Administrateur du hub d'applications dans le projet. Cette valeur a le format username@yourdomain (par exemple, robert.smith@example.com).

4. Accordez le rôle de lecteur de gestion des applications dans le dossier compatible avec les applications aux personnes autorisées à afficher les données d'application et leurs attributs dans les services Google Cloud compatibles avec la gestion des applications. Ce rôle est accordé à la personne sur l'ensemble des projets et sous-dossiers du dossier compatible avec l'application.

   gcloud resource-manager folders add-iam-policy-binding FOLDER_ID \
       --member='user:MANAGEMENT_PROJECT_ADMIN' \
       --role='roles/apphub.appManagementViewer'
   

   Remplacez FOLDER_ID par l'ID du projet. Vous trouverez l'ID de votre dossier activé par l'application sur la page Paramètres d'IAM et administration dans la console Google Cloud. Pour vous assurer que le dossier est compatible avec l'application, la page Settings (Paramètres) doit afficher l'ID du projet de gestion. Si vous ne trouvez pas l'ID du projet de gestion, il est possible que vous ne vous trouviez pas dans un dossier compatible avec l'application. Dans le sélecteur de projet, sélectionnez votre dossier compatible avec les applications.

Console

1. Assurez-vous de vous trouver dans un dossier compatible avec les applications.

2. Dans la console Google Cloud, accédez à la page Applications de l'App Hub.

   Accéder à la page Applications

3. Cliquez sur Créer une application.

4. Sur la page Créer une application, dans le volet Choisir la région et le nom de l'application, en fonction de la portée des services et des charges de travail que vous souhaitez enregistrer dans l'application, effectuez l'une des opérations suivantes:

   • Pour créer une application qui vous permet d'enregistrer des services et des charges de travail à partir d'un emplacement mondial, sélectionnez Global.

   • Pour créer une application qui vous permet d'enregistrer des services et des charges de travail à partir d'un emplacement unique:

     1. Sélectionnez Régional.
     2. Sélectionnez une Région.

5. Saisissez le nom de l'application, puis cliquez sur Continuer.

6. Facultatif: Dans la section Ajouter des attributs, saisissez le nom à afficher.

7. Facultatif: Dans la liste Criticality (Importance), sélectionnez l'une des options suivantes pour indiquer l'importance de l'application:

   • Mission Critical
   • Élevé
   • Moyenne
   • Faible

8. Facultatif: dans la liste Environnement, pour indiquer l'étape du cycle de vie du logiciel, sélectionnez l'une des options suivantes:

   • Production
   • Préproduction
   • Développement
   • Tester

9. Facultatif: Ajoutez les informations suivantes si nécessaire pour les propriétaires développeurs, les propriétaires exploitants et les propriétaires d'établissements. Notez que vous devez saisir l'adresse e-mail du propriétaire si vous ajoutez un nom à afficher.

   1. Saisissez le nom à afficher d'un propriétaire.
   2. Saisissez l'adresse e-mail du propriétaire. Cette valeur doit avoir le format username@yourdomain, par exemple 222larabrown@gmail.com.

10. Répétez ces étapes pour chaque développeur, opérateur et propriétaire d'entreprise.

11. Cliquez sur Créer.

gcloud

1. Créez une application appelée APPLICATION_NAME et attribuez-lui un nom à afficher, APPLICATION_DISPLAY_NAME.

   gcloud apphub applications create APPLICATION_NAME \
       --display-name='APPLICATION_DISPLAY_NAME' \
       --scope-type=SCOPE_TYPE \
       --criticality-type='CRITICALITY_LEVEL' \
       --environment-type='ENVIRONMENT' \
       --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
       --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
       --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Remplacez les éléments suivants :

   • APPLICATION_NAME : nom de votre application. Le nom ne doit contenir que des caractères alphanumériques en minuscules, sans espaces.
   • APPLICATION_DISPLAY_NAME: nom à afficher de votre application.
   • SCOPE_TYPE: champ d'application de votre application qui définit les services et les charges de travail que vous pouvez enregistrer dans l'application. Utilisez l'une des valeurs suivantes :
     • REGIONAL
     • GLOBAL
   • CRITICALITY_LEVEL: (facultatif) indique l'importance d'une application, d'un service ou d'une charge de travail pour vos opérations commerciales. Indiquez l'une des valeurs suivantes :
     • MISSION_CRITICAL
     • HIGH
     • MEDIUM
     • LOW
   • ENVIRONMENT (facultatif) : indique les étapes du cycle de vie du logiciel. Indiquez l'une des valeurs suivantes :
     • PRODUCTION
     • STAGING
     • DEVELOPMENT
     • TEST
   • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR et DISPLAY-NAME-BUSINESS : noms à afficher (facultatif) du développeur, de l'opérateur et des propriétaires d'établissements, respectivement.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR et EMAIL-NAME-BUSINESS : adresses e-mail (facultatif) du développeur, de l'opérateur et des propriétaires d'établissements, respectivement. Ces valeurs doivent être au format username@yourdomain (par exemple, 222larabrown@gmail.com).
   • MANAGEMENT_PROJECT_ID: ID du projet de gestion au format google-mpf-FOLDER_ID.
   • REGION: région de l'application. En fonction de --scope-type, attribuez-lui la valeur us-east1 ou global.

   Exemple :

   gcloud apphub applications create my-application \
       --display-name='application-display-name' \
       --scope-type=REGIONAL \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --project=host-project \
       --location=us-east1
   

2. Répertoriez les applications de votre dossier compatible avec les applications.

   gcloud apphub applications list \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Le résultat ressemble à ce qui suit :

   ID                DISPLAY_NAME              CREATE_TIME
   APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48
   

Console

1. Dans la console Google Cloud, accédez à la page Applications de l'App Hub.

   Accéder à la page Applications

2. Cliquez sur le nom de votre application. L'onglet Services et charges de travail s'affiche avec la liste des services et des charges de travail enregistrés dans votre dossier compatible avec les applications.

3. Pour chaque service ou charge de travail que vous souhaitez enregistrer, procédez comme suit:

   1. Dans l'onglet Services et charges de travail, cliquez sur Enregistrer un service/une charge de travail.
   2. Sur la page Enregistrer un service ou une charge de travail, dans le volet Sélectionner une ressource, cliquez sur Parcourir pour sélectionner le service ou la charge de travail en tant que Ressource.
   3. Dans le volet Sélectionner une ressource, choisissez un service ou une charge de travail, puis cliquez sur Sélectionner.
   4. Dans le volet Sélectionner une ressource, saisissez un nom pour le service ou la charge de travail, puis cliquez sur Continuer.
   5. Vous pouvez éventuellement ajouter des informations supplémentaires sur le service ou la charge de travail dans les champs suivants du volet Ajouter des attributs. Pour en savoir plus, consultez la section Créer une application de ce document. Notez que vous pouvez sélectionner des valeurs pour les champs Criticality (Criticité) et Environment (Environnement) qui sont différentes de celles que vous avez définies lorsque vous avez créé l'application.
   6. Cliquez sur Continuer.
   7. Facultatif : dans la section Ajouter des propriétaires, ajoutez des informations supplémentaires sur les propriétaires du service ou de la charge de travail dans les champs suivants. Pour en savoir plus, consultez la section Créer une application de ce document.
   8. Cliquez sur S'inscrire.

L'onglet Services et charges de travail affiche le service ou la charge de travail enregistrés. Pour en savoir plus sur les états d'enregistrement, consultez les propriétés et attributs d'App Hub.

gcloud

1. Répertorier les services détectés à partir d'un dossier compatible avec les applications Dans la commande suivante, vous pouvez spécifier l'indicateur filter pour renvoyer les services du projet spécifié pouvant être enregistrés dans une application.

   gcloud apphub discovered-services list \
       --filter='FILTER_RESOURCES' \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Remplacez FILTER_RESOURCES par des filtres tels que:

   • service_properties.gcp_project=projects/PROJECT_ID
   • service_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules" Le résultat ressemble à ce qui suit:

   ID                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
   [DISCOVERED_SERVICE_ID]    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/forwarding-rule'}     {'gcpProject': 'projects/PROJECT_1', 'location': 'REGION'}
   

   Copiez l'ID de service, DISCOVERED_SERVICE_ID, à partir de la sortie pour l'utiliser à l'étape suivante.

2. Enregistrez la règle de transfert, forwarding-rule-name, dans un projet en tant que service pour votre application.

   gcloud apphub applications services create SERVICE_NAME \
       --discovered-service='projects/MANAGEMENT_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE' \
       --display-name='SERVICE_DISPLAY_NAME' \
       --application=APPLICATION_NAME \
       --criticality-type='CRITICALITY_LEVEL' \
       --environment-type='ENVIRONMENT' \
       --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
       --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
       --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Remplacez les éléments suivants :

   • SERVICE_NAME: nom sous lequel enregistrer le service.
   • DISCOVERED_SERVICE_ID: ID de service obtenu à l'étape précédente
   • SERVICE_DISPLAY_NAME: nom à afficher de votre application.

   Remarques :

   • criticality-type et environment-type: (facultatif) vous devez fournir l'une des valeurs spécifiées, mais ces valeurs peuvent être différentes de celles que vous avez définies lors de la création de l'application. Pour en savoir plus, consultez la section Créer une application de ce document.
   • developer-owners,operator-owners et business-owners: (facultatif) Pour en savoir plus, consultez la section Créer une application de ce document.

   Exemple :

   gcloud apphub applications services create my-service \
       --display-name='mywebserver-service' \
       --application=my-application \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --folder=folder-ID \
       --location=us-east1
   

3. Répertoriez les charges de travail détectées à partir d'un dossier compatible avec les applications. Dans la commande suivante, vous pouvez spécifier l'option filter pour renvoyer les charges de travail du projet spécifié pouvant être enregistrées dans une application.

   gcloud apphub discovered-workloads list \
       --filter='FILTER_RESOURCES' \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Remplacez FILTER_RESOURCES par un filtre tel que workload_properties.gcp_project=projects/PROJECT_ID.

   Un résultat semblable à celui-ci s'affiche, y compris un MIG non enregistré:

   ID                           WORKLOAD_REFERENCE                                                                                                      WORKLOAD_PROPERTIES
   [DISCOVERED_WORKLOAD]   {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/mig-name'}     {'gcpProject': 'projects/PROJECT', 'location': 'REGION'}
   

   Copiez l'ID de la charge de travail à partir de la sortie pour l'utiliser à l'étape suivante.

4. Enregistrez le MIG, mig-name, du projet en tant que charge de travail dans votre application.

   gcloud apphub applications workloads create WORKLOAD_NAME \
       --discovered-workload='projects/MANAGEMENT_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID' \
       --display-name=WORKLOAD_DISPLAY_NAME' \
       --application=APPLICATION_NAME \
       --criticality-type='CRITICALITY_LEVEL' \
       --environment-type='ENVIRONMENT' \
       --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
       --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
       --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Remplacez les éléments suivants :

   • WORKLOAD_NAME: nom sous lequel enregistrer la charge de travail.
   • DISCOVERED_WORKLOAD_ID: ID de la charge de travail obtenu à l'étape précédente
   • WORKLOAD_DISPLAY_NAME: nom à afficher de votre application.

   Remarques :

   • criticality-type et environment-type: (facultatif) vous devez fournir l'une des valeurs spécifiées, mais ces valeurs peuvent être différentes de celles que vous avez définies lors de la création de l'application. Pour en savoir plus, consultez la section Créer une application de ce document.
   • developer-owners,operator-owners et business-owners: (facultatif) Pour en savoir plus, consultez la section Créer une application de ce document.

   Exemple :

   gcloud apphub applications workloads create my-workload \
       --display-name='mywebserver-deployment1' \
       --application=my-application \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --folder=folder-ID \
       --location=us-east1
   

Console

Ajouter un projet à un dossier compatible avec les applications

1. In the Google Cloud console, go to the project selector page.

   Go to project selector

2. Click Create project.

3. Name your project. Make a note of your generated project ID.

4. Edit the other fields as needed.

5. Click Create.

Supprimer un projet d'un dossier compatible avec les applications

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

gcloud

Ajouter un projet à un dossier compatible avec les applications

gcloud projects create PROJECT_ID \
    --folder FOLDER_ID

Supprimer un projet d'un dossier compatible avec les applications

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID