Configurer App Hub pour les dossiers compatibles avec les applications

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 permet de savoir dans quelle organisation, quel dossier ou quel projet vous travaillez. Si vous n'êtes pas dans un dossier compatible avec les applications, procédez comme suit pour en sélectionner un :

   1. Dans le sélecteur 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'ouvre.

4. Dans le champ Nouveaux comptes principaux, saisissez l'adresse e-mail de la personne responsable de l'administration d'App Hub, c'est-à-dire le rôle d'administrateur App Hub dans le dossier compatible avec les applications.

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

6. Sélectionnez le rôle Administrateur App Hub, puis cliquez sur Enregistrer.

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

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. Attribuez le rôle d'administrateur App Hub aux personnes qui administreront App Hub dans le dossier compatible avec les applications. Répétez la commande suivante pour chaque administrateur. Ils doivent 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 d'IAM (Identity and Access Management) et administration de la console Google Cloud . 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 les applications. Dans le sélecteur de projets, sélectionnez votre dossier compatible avec les applications.
   • MANAGEMENT_PROJECT_ADMIN : utilisateur qui dispose du rôle d'administrateur App Hub dans le projet. Cette valeur est au format username@yourdomain (par exemple, robert.smith@example.com).

4. Attribuez le rôle Lecteur de gestion des applications dans le dossier où les applications sont activées aux personnes qui doivent afficher les données et les attributs des applications dans les services Google Cloud compatibles avec la gestion des applications. Ce rôle est accordé à la personne pour tous les projets et sous-dossiers du dossier compatible avec les applications.

   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 du dossier compatible avec les applications sur la page Paramètres de la console Google Cloud . Pour vous assurer que le dossier est activé pour les applications, la page 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 les applications. 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 d'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 du champ d'application des services et des charges de travail que vous souhaitez enregistrer dans l'application, procédez comme suit :

   • 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 Criticité, sélectionnez l'une des options suivantes pour indiquer l'importance de l'application :

   • Mission critical
   • Élevée
   • Moyenne
   • Faible

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

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

9. Facultatif : Ajoutez les informations suivantes, selon les besoins, pour les propriétaires développeurs, les propriétaires opérateurs et les propriétaires d'entreprise. Notez que vous devez saisir l'adresse e-mail du propriétaire si vous ajoutez un nom à afficher.

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

10. Répétez ces étapes pour chaque développeur, opérateur et propriétaire de l'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 auxquels vous pouvez vous inscrire. Utilisez l'une des valeurs suivantes :
     • REGIONAL
     • GLOBAL
   • CRITICALITY_LEVEL : (facultatif) indique le degré de criticité 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 (facultatifs) du développeur, de l'opérateur et des propriétaires de l'entreprise, respectivement.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR et EMAIL-NAME-BUSINESS : adresses e-mail (facultatives) du développeur, de l'opérateur et des propriétaires de l'entreprise, 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. Affichez la liste des applications dans 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 d'App Hub.

   Accéder à la page Applications

2. Cliquez sur le nom de votre application. L'onglet Services et charges de travail affiche la liste des services et charges de travail enregistrés qui se trouvent 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 également 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 Criticité et Environnement qui sont différentes de celles que vous avez définies lorsque vous avez créé l'application.
   6. Cliquez sur Continuer.
   7. Facultativement, dans la section Ajouter des propriétaires, ajoutez des informations sur les propriétaires du service ou de la charge de travail dans les champs qui suivent. 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 les attributs d'App Hub.

gcloud

1. Répertorie les services découverts à partir d'un dossier compatible avec les applications. Dans la commande suivante, vous pouvez spécifier l'option filter pour renvoyer les services du projet spécifié qui peuvent ê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 du résultat 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 du 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 lorsque vous avez créé 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écouvertes à 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é qui peuvent ê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.

   Vous obtenez un résultat semblable à celui-ci, qui inclut 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 charge de travail à partir du résultat 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 issu du résultat de 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 lorsque vous avez créé 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

Create or select a Google Cloud project.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

Supprimer un projet d'un dossier compatible avec les applications

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

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