Configurer App Hub

Console

1. Dans Google Cloud Console, accédez à la page de sélection du projet.

   Accéder au sélecteur de projet

2. Sélectionnez ou créez un projet Google Cloud qui servira de projet hôte pour App Hub.

3. Enable the required API.

   Enable the API

4. Si vous êtes le créateur du projet, vous disposez du rôle de base Propriétaire (roles/owner). Par défaut, ce rôle IAM inclut les autorisations nécessaires pour accéder à la plupart des ressources Google Cloud.

   Si vous n'êtes pas le créateur du projet, les autorisations requises doivent être accordées au compte principal approprié sur le projet. Par exemple, un compte principal peut être un compte Google (pour les utilisateurs finaux) ou un compte de service (pour les applications et les charges de travail de calcul). Pour obtenir les autorisations nécessaires pour suivre ce tutoriel, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet:

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

      Accéder à IAM

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

   3. Dans le champ Nouveaux comptes principaux, saisissez l'adresse e-mail de la personne qui administrera App Hub, le rôle d'administrateur App Hub dans le projet hôte.

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

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

   6. Dans chacun des projets de service App Hub, attribuez le rôle Administrateur App Hub au même utilisateur.

5. Dans la console Google Cloud, accédez à la page Paramètres de l'App Hub.

   Accéder aux paramètres

6. Sur la page Paramètres, cliquez sur Associer des projets.

7. Effectuez l'une des opérations suivantes :

   • Dans la liste des projets, cochez les cases des projets que vous souhaitez ajouter en tant que projets de service.
   • Recherchez des projets, puis sélectionnez ceux à ajouter en tant que projets de service.

8. Cliquez sur Sélectionner. Le tableau Projets de service associés affiche les projets de service sélectionnés.

9. Cliquez sur Fermer.

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. Créez ou sélectionnez un projet, HOST_PROJECT_ID, qui servira de projet hôte pour App Hub.

   • Créez un projet Google Cloud :

     gcloud projects create HOST_PROJECT_ID

   • Sélectionnez le projet Google Cloud que vous avez créé :

     gcloud config set project HOST_PROJECT_ID

4. Activez l'API App Hub dans le projet hôte que vous venez de créer.

   gcloud services enable apphub.googleapis.com \
       --project=HOST_PROJECT_ID
   

5. Si vous êtes le créateur du projet, vous disposez du rôle de base Propriétaire (roles/owner). Par défaut, ce rôle IAM inclut les autorisations nécessaires pour accéder à la plupart des ressources Google Cloud.

   Si vous n'êtes pas le créateur du projet, les autorisations requises doivent être accordées au compte principal approprié sur le projet. Par exemple, un compte principal peut être un compte Google (pour les utilisateurs finaux) ou un compte de service (pour les applications et les charges de travail de calcul). Pour obtenir les autorisations nécessaires pour suivre ce tutoriel, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet:

   1. Si vous le souhaitez, attribuez aux personnes qui administreront App Hub le rôle d'administrateur App Hub dans le projet hôte. Répétez la commande suivante pour chaque administrateur.

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

      Remplacez HOST_PROJECT_ADMIN par l'utilisateur disposant du rôle Administrateur App Hub dans le projet hôte. Cette valeur a le format username@yourdomain (par exemple, robert.smith@example.com).

   2. Accordez le rôle Administrateur d'App Hub dans les projets de service aux personnes qui administrent App Hub. Il doit disposer du rôle Administrateur du hub d'applications pour ajouter des projets de service au projet hôte. Vous devez disposer d'au moins une personne disposant de ce rôle pour chaque projet de service. Une seule personne peut occuper ce rôle dans plusieurs projets de service.

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

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

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

      Remplacez les éléments suivants :

      • SERVICE_PROJECT_1: premier des trois projets de service de cet exemple.
      • SERVICE_PROJECT_2: deuxième des trois projets de service de cet exemple.
      • SERVICE_PROJECT_3: troisième des trois projets de service de cet exemple.

6. Ajoutez vos projets de service au projet hôte App Hub.

   gcloud apphub service-projects add SERVICE_PROJECT_1 \
       --project=HOST_PROJECT_ID
   

   gcloud apphub service-projects add SERVICE_PROJECT_2 \
       --project=HOST_PROJECT_ID
   

   gcloud apphub service-projects add SERVICE_PROJECT_3 \
       --project=HOST_PROJECT_ID
   

Console

1. Accédez à la page settings Paramètres dans la console Google Cloud.

   Accéder aux paramètres

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

2. Sélectionnez Champ d'application de la métrique.

   L'onglet Champ d'application des métriques liste les ressources surveillées par le projet Google Cloud actuel. Il liste également les projets Google Cloud dont le champ d'application des métriques inclut le projet Google Cloud actuel.

3. Pour ajouter des projets Google Cloud au champ d'application des métriques:

   1. Dans le volet Projets Google Cloud, cliquez sur Ajouter des projets.
   2. Dans la boîte de dialogue Add Google Cloud projects (Ajouter des projets Google Cloud), cliquez sur Select Projects (Sélectionner des projets), puis cochez les cases correspondant aux projets de service requis que vous souhaitez surveiller.

   3. Pour enregistrer vos modifications, cliquez sur Ajouter des projets.

      La page Paramètres s'affiche, et le tableau de cette page est mis à jour pour afficher vos sélections.

Une fois que vous avez ajouté des projets à un champ d'application de métriques, la propagation des modifications dans tous les systèmes Monitoring prend environ 60 secondes.

Pour en savoir plus sur la configuration des champs d'application des métriques à l'aide de la console Google Cloud, consultez la section Configurer un champ d'application des métriques.

gcloud

Pour ajouter vos projets de service en tant que conteneur de ressources surveillé au projet hôte App Hub:

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

Pour en savoir plus sur la configuration des champs d'application des métriques à l'aide de la Google Cloud CLI, consultez la page Configurer un champ d'application de métriques à l'aide de l'API.

Console

1. Assurez-vous d'être dans le projet hôte.

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 (Preview, Bêta).

   • 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. Vous pouvez également ajouter des informations supplémentaires sur l'application dans les champs suivants. Pour en savoir plus, consultez la section Mettre à jour une application App Hub existante de ce document.

7. 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 \
     --scope-type=SCOPE_TYPE \
     --project=HOST_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.
   • 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 (bêta)
   • REGION: région de l'application. Selon --scope-type, attribuez la valeur us-east1 ou global (Preview).

2. Répertoriez les applications de votre projet hôte.

   gcloud apphub applications list \
     --project=HOST_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
   

3. Obtenez des informations sur l'application que vous avez créée.

   gcloud apphub applications describe APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   La commande renvoie des informations au format YAML, semblables à ce qui suit.

   createTime: '2023-10-31T18:33:48.199394108Z'
   displayName: APPLICATION_DISPLAY_NAME
   name: projects/HOST_PROJECT_ID/locations/REGION/applications/APPLICATION_NAME
   scope:
     type: SCOPE_TYPE
   state: ACTIVE
   uid: [APPLICATION_UID]
   updateTime: '2023-10-31T18:33:48.343303819Z'
   
   

Console

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

   Accéder à la page Applications

2. Dans la liste des applications, cliquez sur edit Modifier pour l'application que vous souhaitez mettre à jour.

3. Modifiez les champs selon vos besoins, puis cliquez sur Enregistrer.

4. 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

5. 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

6. 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.

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

8. Cliquez sur Enregistrer.

gcloud

1. Mettez à jour votre application avec les attributs criticality-type, environment-type et type de propriétaire:

   gcloud apphub applications update APPLICATION_NAME \
     --display-name='APPLICATION_DISPLAY_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=HOST_PROJECT_ID \
     --location=REGION
   

   Remplacez les éléments suivants :

   • APPLICATION_DISPLAY_NAME: nom à afficher de votre application.
   • CRITICALITY_LEVEL: indique le niveau 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: 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 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 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).

2. Répertoriez les applications pour lesquelles l'attribut environment-type a la valeur PRODUCTION.

   gcloud apphub applications list \
       --filter='attributes.environment.type=PRODUCTION' \
       --project=HOST_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 une liste des services et charges de travail enregistrés dans vos projets de service.

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 Mettre à jour une application App Hub existante 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 Mettre à jour une application App Hub existante 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. Ajoutez une personne disposant des autorisations d'éditeur de l'App Hub.

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
     --member='user:APP_HUB_EDITOR' \
     --role='roles/apphub.editor'
   

   Remplacez APP_HUB_EDITOR par l'utilisateur disposant du rôle "Éditeur du hub d'applications" dans le projet hôte. Cette valeur a le format username@yourdomain, par exemple robert.smith@example.com.

2. Répertoriez les charges de travail détectées à partir du projet de service 2, qui est associé au projet hôte. Cette commande renvoie les charges de travail pouvant être enregistrées dans une application.

   gcloud apphub discovered-workloads list \
     --filter='workload_properties.gcp_project=projects/SERVICE_PROJECT_2' \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   Le résultat ressemble à ce qui suit, y compris les MIG non enregistrés:

   ID                           WORKLOAD_REFERENCE                                                                                                      WORKLOAD_PROPERTIES
   [DISCOVERED_WORKLOAD_ID_1]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
   [DISCOVERED_WORKLOAD_ID_2]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
   

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

3. Enregistrez une charge de travail de l'étape précédente dans votre application.

   gcloud apphub applications workloads create WORKLOAD_NAME \
     --discovered-workload='projects/HOST_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID_2' \
     --display-name='mywebserver-deployment1' \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   Remplacez les éléments suivants :

   • WORKLOAD_NAME: nom sous lequel enregistrer la charge de travail.
   • DISCOVERED_WORKLOAD_ID_2: ID de la charge de travail obtenu à l'étape précédente

4. Répétez les deux étapes précédentes pour filtrer et enregistrer les charges de travail souhaitées à partir du projet de service 3.

5. Facultatif: vous pouvez mettre à jour les charges de travail avec les attributs criticality-type, environment-type et owner.

   gcloud apphub applications workloads update WORKLOAD_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=HOST_PROJECT_ID \
     --location=REGION
   

   Notez que vous devez fournir l'une des valeurs spécifiées pour criticality-type et environment-type, mais la valeur peut être différente de celles que vous avez définies lorsque vous créez l'application.

6. Répertoriez les charges de travail enregistrées dans l'application.

   gcloud apphub applications workloads list \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   Le résultat ressemble à ce qui suit :

   ID                DISPLAY_NAME                 WORKLOAD_REFERENCE                                                                                                    CREATE_TIME
   WORKLOAD_NAME     mywebserver-deployment1      {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}   2023-10-31T18:34:23
   

   Les charges de travail enregistrées, mais dissociées, sont indiquées par une valeur vide dans le champ WORKLOAD_REFERENCE. Pour en savoir plus sur les états d'enregistrement, consultez les propriétés et attributs d'App Hub.

7. Liste des services détectés avec des règles de transfert dans le projet de service 1 associé au projet hôte. Cette commande renvoie les services pouvant être enregistrés dans une application.

   gcloud apphub discovered-services list \
     --filter='service_properties.gcp_project=projects/SERVICE_PROJECT_1 AND service_reference.uri~"forwardingRules"' \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   Le résultat ressemble à ce qui suit :

   ID                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
   [DISCOVERED_SERVICE_ID_1]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
   [DISCOVERED_SERVICE_ID_2]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
   

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

8. Enregistrez la règle de transfert, testing-forwarding-rule-2, dans le projet de service 1 en tant que service.

   gcloud apphub applications services create SERVICE_NAME \
     --discovered-service='projects/HOST_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE_ID_2' \
     --display-name='mywebserver-service1' \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   Remplacez les éléments suivants :

   • SERVICE_NAME: nom sous lequel enregistrer le service.
   • DISCOVERED_SERVICE_ID_2: ID de service obtenu à l'étape précédente

9. Répétez les étapes précédentes qui listent les services, les filtre et les enregistre dans les projets de service 1, 2 et 3.

10. Mettez à jour un service avec les attributs criticality-type et environment-type.

    gcloud apphub applications services update SERVICE_NAME \
      --criticality-type='CRITICALITY_LEVEL' \
      --environment-type='ENVIRONMENT' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID  \
      --location=REGION
    

11. Répertoriez les services enregistrés dans l'application APPLICATION_NAME et le projet hôte HOST_PROJECT_ID.

    gcloud apphub applications services list \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Le résultat ressemble à ce qui suit pour chaque service:

    ID                DISPLAY_NAME                 SERVICE_REFERENCE                                                                                                                  CREATE_TIME
    SERVICE_NAME      mywebserver-service1         {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}   2023-11-01T21:38:08
    

    Les services enregistrés, mais dissociés, sont indiqués par une valeur vide dans le champ SERVICE_REFERENCE.

12. Filtrez les services de l'application APPLICATION_NAME et du projet hôte HOST_PROJECT_ID sur ceux pour lesquels l'attribut environment-type est défini sur PRODUCTION.

    gcloud apphub applications services list \
      --filter='attributes.environment.type=PRODUCTION' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

Console

Pour ajouter un projet de service à un projet hôte:

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

   Accéder aux paramètres

2. Sur la page Paramètres, cliquez sur Associer des projets.

3. Dans le volet qui s'ouvre, recherchez des projets dans la liste affichée, puis cochez les cases correspondant aux projets que vous souhaitez ajouter en tant que projets de service.

4. Cliquez sur Sélectionner. Le tableau Projets de service associés affiche les projets sélectionnés en tant que projets de service pour le projet hôte.

5. Cliquez sur Fermer.

Pour supprimer un projet de service d'un projet hôte:

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

   Accéder aux paramètres

2. Sur la page Settings (Paramètres), cochez les cases correspondant aux projets que vous souhaitez supprimer en tant que projets de service.

3. Cliquez sur Dissocier des projets. Le tableau Projets de service associés s'actualise pour n'afficher que les projets qui restent associés au projet hôte.

gcloud

Pour ajouter un projet de service à un projet hôte:

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Console

• Pour afficher les applications d'un projet:

  1. Dans la console Google Cloud, accédez à la page Applications du hub d'applications.

     Accéder à la page Applications

  2. Facultatif: Pour filtrer l'application:

     1. Dans le champ Filtre, sélectionnez un filtre tel que Criticité.
     2. Sélectionnez Élevé comme valeur.
        Une liste des applications de haute criticité créées sur le projet hôte s'affiche.

• Pour afficher la liste des services et des charges de travail:

  Applications

  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 d'une application. Une page contenant la liste des services et des charges de travail enregistrés dans votre application s'affiche.

  3. Facultatif: Pour filtrer les services ou les charges de travail:

     1. Dans le champ Filtre, sélectionnez un filtre tel que Criticité.
     2. Sélectionnez Élevé comme valeur.
        Une liste des services et des charges de travail à criticité élevée enregistrés dans l'application s'affiche.

  Services et charges de travail

  1. Dans la console Google Cloud, accédez à la page Services et charges de travail de l'App Hub.

     Accéder à "Services et charges de travail"

  2. Dans la liste Région, sélectionnez les régions à partir desquelles vous souhaitez afficher les services et les charges de travail. Par exemple, sélectionnez us-east1.
     La page Services et charges de travail affiche tous les services et charges de travail des projets de service associés à us-east1.

  3. Facultatif: Pour filtrer les services ou les charges de travail:

     1. Dans le champ Filtre, sélectionnez un filtre tel que Environnement.
     2. Sélectionnez Production comme valeur.
        Une liste des services et des charges de travail de l'environnement de production enregistrés dans une application s'affiche.

gcloud

• Pour afficher les applications d'un projet:

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

• Pour lister les services enregistrés dans une application:

  gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION
  

• Pour lister les charges de travail enregistrées dans une application:

  gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION
  

• Facultatif: Pour filtrer les ressources en fonction d'attributs variables, ajoutez un indicateur de commande filter aux commandes précédentes. Par exemple, pour répertorier toutes les charges de travail enregistrées où l'attribut criticality-type est défini sur HIGH:

  gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --filter='attributes.criticality.type=HIGH' \
    --project=HOST_PROJECT_ID \
    --location=REGION
  

  Pour en savoir plus sur les attributs avec lesquels vous pouvez filtrer cette page, consultez Mettre à jour une application App Hub existante.

Console

1. Dans la console Google Cloud, accédez à la page Applications du hub d'applications.

   Accéder à la page Applications

2. Cliquez sur le nom d'une application. La liste des services et des charges de travail enregistrés dans l'application s'affiche.

3. Désenregistrer un service ou une charge de travail

   1. Dans l'onglet Services et charges de travail, dans la section Services et charges de travail enregistrés, cliquez sur le nom du service ou de la charge de travail que vous souhaitez annuler.
   2. Dans l'onglet Détails, cliquez sur Annuler l'enregistrement pour mettre à jour le service ou la charge de travail en tant que ressource découverte.
      Dans l'onglet Services et charges de travail, une alerte indique que la charge de travail n'est pas enregistrée.
   3. Répétez ces instructions pour chaque service et chaque charge de travail.

4. Accédez à la page Applications du hub des applications.

   Accéder à la page Applications

5. Cliquez sur le nom d'une application.

6. Sur la page des détails de l'application, cliquez sur Supprimer.

7. Pour supprimer les projets de service de votre projet hôte, consultez la section Ajouter ou supprimer des projets de service de ce document.

8. Pour supprimer les projets de service du champ d'application des métriques du projet hôte:

   1. Accédez à la page settings Paramètres dans la console Google Cloud.

      Accéder aux paramètres

      Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

   2. Sélectionnez Champ d'application de la métrique.
   3. Dans le volet Google Cloud Projects (Projets Google Cloud), cliquez sur Remove project (Supprimer le projet), puis renseignez la boîte de dialogue de confirmation.

gcloud

1. Répertoriez les charges de travail enregistrées dans l'application:

   gcloud apphub applications workloads list \
     --application=APPLICATION_NAME --project=HOST_PROJECT_ID \
     --location=REGION
   

2. Annulez l'enregistrement de la charge de travail dans l'application:

   gcloud apphub applications workloads delete WORKLOAD_NAME \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   La charge de travail est désormais une charge de travail découverte qui peut être enregistrée dans l'application.

3. Répétez la commande précédente pour supprimer les charges de travail enregistrées restantes de l'application.

4. Répertoriez les services enregistrés dans l'application:

   gcloud apphub applications services list \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

5. Désinscrivez le service de l'application:

   gcloud apphub applications services delete SERVICE_NAME \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   Le service est désormais un service détecté qui peut être enregistré dans l'application.

6. Répétez la commande précédente pour désenregistrer les services enregistrés restants de l'application.

7. Supprimez l'application:

   gcloud apphub applications delete APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

8. Supprimez un projet de service du projet hôte:

   gcloud apphub service-projects remove SERVICE_PROJECT_ID \
     --project=HOST_PROJECT_ID
   

9. Répétez la commande précédente pour supprimer tous les projets de service du projet hôte.

10. Supprimez les projets de service du champ d'application des métriques du projet hôte (preview):

    gcloud beta monitoring metrics-scopes delete projects/SERVICE_PROJECT_ID \
      --project=HOST_PROJECT_ID
    

11. Répétez la commande précédente pour supprimer tous les projets de service du projet hôte de la portée des métriques.