Modifier les ressources App Hub

Preview — App-enabled folders and Management projects

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez lister, afficher, mettre à jour et supprimer les ressources App Hub dans un dossier compatible avec les applications à l'aide de la console Google Cloud ou de Google Cloud CLI dans votre terminal ou Cloud Shell.

Prérequis

Avant de modifier les ressources App Hub, effectuez les tâches suivantes :

1. Suivez les conditions préalables pour configurer App Hub.
2. Selon le type de ressource que vous souhaitez modifier, assurez-vous d'avoir suivi les étapes de configuration d'App Hub. Pour en savoir plus, consultez Configurer App Hub.

Rôles requis

Pour obtenir les autorisations nécessaires pour modifier les ressources App Hub, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le dossier compatible avec les applications :

• Pour créer et mettre à jour des applications, enregistrer et annuler l'enregistrement des services et des charges de travail, et mettre à jour les attributs associés :
  • Administrateur App Hub (roles/apphub.admin)
  • Éditeur App Hub (roles/apphub.editor)
• Pour afficher les applications, les services et les charges de travail, ainsi que leurs attributs : Lecteur App Hub (roles/apphub.viewer)
• Pour afficher les données au niveau de l'application et du projet dans Cloud Hub : Opérateur Cloud Hub (roles/cloudhub.operator)

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.

Lister les applications

Vous pouvez lister et filtrer les applications dans un dossier compatible avec les applications.

Console

1. Pour afficher les applications dans un dossier compatible avec les applications, accédez à la page Applications d'App Hub dans la consoleGoogle Cloud .

   Accéder à la page Applications

   Une liste d'applications s'affiche.

2. Pour filtrer les applications :

   1. Dans le champ Filtre, sélectionnez un filtre tel que Criticité.
   2. Spécifiez une valeur pour le filtre. Par exemple, pour afficher les applications à criticité élevée, sélectionnez Élevée comme valeur.
       Une liste des applications correspondant au filtre spécifié s'affiche.

gcloud

1. Pour afficher les applications dans un dossier compatible avec les applications :

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

   Remplacez les éléments suivants :

   • MANAGEMENT_PROJECT_ID : ID de votre projet de gestion. Vous trouverez l'ID de votre projet de gestion sur la page Paramètres du Identity and Access Managementquot;IAM 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 Purview (ou sélecteur de projet), sélectionnez votre dossier compatible avec les applications. Pour savoir comment activer la gestion des applications pour un dossier, consultez Activer la gestion des applications.
   • REGION : région de l'application. En fonction de la --scope-type de l'application, attribuez-lui la valeur global ou la région de l'application, par exemple us-east1. Pour en savoir plus sur la définition de --scope-type pour l'application, consultez Créer une application.

2. Pour filtrer les applications en fonction des attributs de variables, utilisez l'indicateur --filter. Par exemple, pour lister toutes les applications dont l'attribut environment-type est défini sur PRODUCTION :

   gcloud apphub applications list \
       --filter='attributes.environment.type=PRODUCTION' \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

Afficher une application

Vous pouvez décrire une application dans un dossier compatible avec les applications.

Console

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

   Accéder à la page Applications

2. Dans la liste des applications, cliquez sur celle dont vous souhaitez connaître les détails.

3. Cliquez sur l'onglet Détails pour afficher les informations sur l'application.

gcloud

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

Remplacez APPLICATION_NAME par le nom de votre application. Le nom ne doit contenir que des caractères alphanumériques en minuscules, sans espaces.

Mettre à jour une application App Hub

Vous pouvez mettre à jour les attributs de votre application une fois celle-ci créée.

Console

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

   Accéder à la page Applications

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

3. Modifiez les champs selon vos besoins.

4. Cliquez sur Enregistrer.

gcloud

1. Mettez à jour votre application avec les attributs criticality-type, environment-type et de 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=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.
   • REGION : région de l'application.

   Vous pouvez mettre à jour les informations suivantes :

   • APPLICATION_DISPLAY_NAME : indique le nom à afficher de l'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 de l'entreprise, 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 de l'entreprise, respectivement. Ces valeurs doivent être au format username@yourdomain (par exemple, [e-mail]).

   Exemple :

   gcloud apphub applications update my-application \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --project=google-mpf-FOLDER-ID \
       --location=us-east1
   

Afficher les services et les charges de travail

Vous pouvez afficher, lister et filtrer les services et les charges de travail dans une application.

Console

1. Pour lister les services et les charges de travail :

   1. Dans la console Google Cloud , accédez à la page Services et charges de travail du hub d'applications.

      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.

2. Pour filtrer les services ou les charges de travail :

   1. Dans le champ Filtre, sélectionnez un filtre tel que Environnement.
   2. Spécifiez une valeur pour le filtre. Par exemple, pour afficher les services et les charges de travail en production, sélectionnez Production comme valeur.
      Une liste des services et des charges de travail correspondant au filtre spécifié s'affiche.

gcloud

Lister les services détectés

Les services détectés peuvent être enregistrés dans une application.

1. Pour lister les services détectés :

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

   Vous obtenez un résultat semblable à celui-ci :

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

2. Facultatif : Filtrez la liste des services détectés. Par exemple, pour filtrer les services détectés avec des règles de transfert dans le dossier compatible avec les applications :

   gcloud apphub discovered-services list \
       --filter='service_reference.uri~"forwardingRules"' \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION

Lister les services enregistrés

Lister et filtrer les services App Hub enregistrés à partir d'une application.

1. Pour lister les services enregistrés dans une application :

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

   Vous obtenez un résultat semblable à celui-ci :

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

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

2. Facultatif : Filtrez la liste des services enregistrés. Par exemple, pour filtrer les services enregistrés dans une application où l'attribut environment-type est défini sur PRODUCTION :

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

Lister les charges de travail découvertes

Les charges de travail découvertes peuvent être enregistrées dans une application.

1. Pour lister les charges de travail découvertes :

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

   Vous obtenez un résultat semblable à celui-ci, qui inclut les MIG non enregistrés :

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

2. Facultatif : Filtrez la liste des charges de travail découvertes. Par exemple, pour filtrer la liste des charges de travail découvertes avec des ressources de calcul dans un dossier compatible avec les applications :

   gcloud apphub discovered-workloads list \
       --filter='workload_reference.uri~"compute"'
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

Lister les charges de travail enregistrées

Lister et filtrer les charges de travail App Hub enregistrées à partir d'une application.

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

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

   Vous obtenez un résultat semblable à celui-ci :

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

   Les charges de travail enregistrées, mais détaché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.

2. (Facultatif) Filtrez la liste des charges de travail enregistrées. Par exemple, pour filtrer les charges de travail d'une application dont l'attribut environment-type est défini sur PRODUCTION :

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

Mettre à jour les services et les charges de travail

Vous pouvez mettre à jour les services et les charges de travail enregistrés dans une application.

Remarque : Les valeurs que vous fournissez pour les champs Criticité et Environnement peuvent être différentes de celles que vous avez définies lorsque vous avez créé l'application.

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 des charges de travail enregistrés dans vos projets de service.

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

   1. Dans l'onglet Services et charges de travail, cliquez sur more_vert pour le service ou la charge de travail que vous souhaitez modifier, puis sur Modifier le service ou Modifier la charge de travail.
   2. Dans le volet Modifier le service ou Modifier la charge de travail, modifiez les champs selon vos besoins, puis cliquez sur Enregistrer.

gcloud

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

   gcloud apphub applications services update SERVICE_NAME \
       --application=APPLICATION_NAME \
       --display-name='SERVICE_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=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Remplacez SERVICE_NAME par le nom du service App Hub.

   Vous pouvez mettre à jour les informations suivantes :

   • SERVICE_DISPLAY_NAME : indique un nom à afficher pour le service.
   • 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 de l'entreprise, 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 de l'entreprise, respectivement. Ces valeurs doivent être au format username@yourdomain (par exemple, [e-mail]).

   Exemple :

   gcloud apphub applications workloads update my-application \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --project=google-mpf-FOLDER-ID \
       --location=us-east1
   

2. Mettez à jour votre charge de travail avec les attributs criticality-type, environment-type et de type de propriétaire :

   gcloud apphub applications workloads update WORKLOAD_NAME \
       --application=APPLICATION_NAME \
       --display-name='WORKLOAD_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=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Remplacez WORKLOAD_NAME par le nom de la charge de travail App Hub.

   Vous pouvez mettre à jour les informations suivantes :

   • WORKLOAD_DISPLAY_NAME : indique un nom à afficher pour le service.
   • 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 de l'entreprise, 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 de l'entreprise, respectivement. Ces valeurs doivent être au format username@yourdomain (par exemple, [e-mail]).

   Exemple :

   gcloud apphub applications workloads update my-application \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --project=google-mpf-FOLDER-ID \
       --location=us-east1
   

Supprimer des applications, des services et des charges de travail

Supprimez une application existante pour supprimer les ressources enregistrées associées au dossier compatible avec les applications. Pour ce faire, vous devez d'abord annuler l'enregistrement des charges de travail et des services enregistrés dans l'application.

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. Annuler l'enregistrement d'un service ou d'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 désenregistrer.
   2. Sur la page du service ou de la charge de travail enregistrés qui s'ouvre, cliquez sur Désenregistrer 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 charge de travail.

4. Accédez à la page Applications d'App Hub.

   Accéder à la page Applications

5. Cliquez sur le nom d'une application.

6. Sur la page contenant les informations sur l'application, cliquez sur Supprimer.

gcloud

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

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

2. Annulez l'enregistrement du service dans l'application :

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

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

3. Répétez la commande précédente pour annuler l'enregistrement des services enregistrés restants dans l'application.

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

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

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

   gcloud apphub applications workloads delete WORKLOAD_NAME \
       --application=APPLICATION_NAME \
       --project=MANAGEMENT_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.

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

7. Supprimez l'application :

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

Étapes suivantes

• Configurer la surveillance des applications
• Rôles et autorisations IAM App Hub
• Présentation d'App Hub
• Résoudre les problèmes