Modifier les ressources App Hub dans les dossiers compatibles avec les applications

Vous pouvez lister, afficher, mettre à jour et supprimer des 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 de l'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 la procédure 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 de l'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 de services et de charges de travail, et mettre à jour les attributs associés :
  • Pour afficher les applications, les services et les charges de travail, ainsi que leurs attributs : Lecteur App Hub (roles/apphub.viewer)
  • Pour afficher les applications, les services et les charges de travail, ainsi que leurs attributs dans les Google Cloud services compatibles avec la gestion des applications : Lecteur de gestion App Hub (roles/apphub.appManagementViewer)

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Répertorier les applications

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

Console

  1. Pour afficher les applications d'un dossier compatible avec les applications, accédez à la page Applications du hub des applications dans la console Google 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 d'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 de la console Google Cloud, sous "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 portée (ou sélecteur de projet), sélectionnez votre dossier compatible avec les applications. Pour en savoir plus sur l'activation d'un dossier pour la gestion des applications, consultez Activer la gestion des applications.
    • REGION: région de l'application. En fonction du --scope-type de l'application, attribuez la valeur global ou la région de l'application, par exemple us-east1. Pour en savoir plus sur la configuration de --scope-type pour l'application, consultez Créer une application.
  2. Pour filtrer les applications en fonction des attributs de variable, utilisez l'indicateur --filter. Par exemple, pour lister toutes les applications où 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 minuscules sans espaces.

Mettre à jour une application App Hub

Vous pouvez mettre à jour les attributs de votre application après sa création.

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 si nécessaire.

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

    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 d'une application.

Console

  1. Pour afficher la liste des services et des 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.

  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

Répertorier les services détectés

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

  1. Pour afficher la liste des 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écouverts avec des règles de transfert dans le dossier activé par l'application:

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

Répertorier les services enregistrés

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

  1. Pour afficher la liste des 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 dissocié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
    

Répertorier les charges de travail détectées

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

  1. Pour lister les charges de travail détectées:

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

    Un résultat semblable à celui-ci s'affiche, y compris 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étectées. Par exemple, pour filtrer la liste des charges de travail détectées 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
    

Répertorier les charges de travail enregistrées

Répertoriez et filtrez 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 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.

  2. (Facultatif) Filtrez la liste des charges de travail enregistrées. Par exemple, pour filtrer les charges de travail d'une application où 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 des services et des charges de travail

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

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 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 mettre à jour, 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 si nécessaire, 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 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).

    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 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 du hub d'applications.

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

    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. 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. 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 chaque 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 des détails de 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. Désinscrivez le service de 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 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
    

Étape suivante