Gérer les services et les charges de travail

Lorsque vous choisissez votre modèle de configuration d'application, vous définissez une limite de gestion des applications pour vos applications App Hub dans un projet de gestion. Vous pouvez ensuite enregistrer des services et des charges de travail dans les applications à l'intérieur de cette limite. Pour connaître les cas d'utilisation recommandés pour introduire des pratiques de gestion des applications, consultez Se préparer à la gestion du cycle de vie des applications.

Pour éviter la dérive de configuration et maintenir une source de vérité claire, nous vous recommandons de gérer les composants de votre application dans l'environnement où ils ont été définis à l'origine :

• Pour les applications déployées à partir d'un modèle App Design Center : utilisez App Design Center pour gérer et mettre à jour l'application. Vous pouvez modifier le modèle pour apporter des modifications à la conception de l'application ou créer une révision de l'application pour mettre à jour des paramètres tels que les détails de l'application et des composants.

  Accéder à App Design Center

• Pour les applications créées en enregistrant des ressources existantes dans App Hub : gérez les applications, les services et les charges de travail directement dans App Hub.

  Accéder à App Hub

Cette page explique comment gérer les services et les charges de travail découverts ou enregistrés directement dans App Hub. Vous pouvez effectuer ces actions à l'aide de la console Google Cloud ou de la Google Cloud CLI. Pour les applications déployées à partir d'un modèle, consultez la documentation Application Design Center.

Avant de commencer

Ce document suppose que vous disposez d'une application avec des ressources compatibles enregistrées.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les services et les charges de travail dans App Hub, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet de gestion qui définit la limite de gestion de votre application :

• Mettre à jour et annuler l'enregistrement des services et des charges de travail : Éditeur App Hub (roles/apphub.editor)
• Afficher les services, les charges de travail et leurs détails : Lecteur App Hub (roles/apphub.viewer)

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.

Pour en savoir plus sur les rôles App Hub, consultez Rôles et autorisations IAM pour App Hub.

Afficher les détails des services et des charges de travail

Suivez ces étapes pour afficher les détails des services et des charges de travail, y compris leur emplacement, leur état d'enregistrement dans une application, leurs attributs et leurs propriétés, dans les limites de gestion de votre application. Pour en savoir plus sur ces détails, consultez Concepts et modèle de données App Hub.

Console

Affichez les détails des services et des charges de travail d'une application dont l'état d'enregistrement est registered (enregistré) ou detached (détaché) :

1. Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion.

2. Accédez à la page Applications depuis App Hub :

   Accéder à la page Applications

   La page affiche la liste de vos applications.

3. Cliquez sur le nom de l'application dont vous souhaitez afficher les détails du service ou de la charge de travail.

4. Dans l'onglet Services et charges de travail, cliquez sur le nom du service ou de la charge de travail que vous souhaitez afficher.

5. Sur la page Détails du composant, vous pouvez consulter des informations telles que le nom à afficher, l'emplacement, l'état d'enregistrement, les propriétés et les attributs.

Vous pouvez également afficher la liste de tous les services et charges de travail dont l'état d'enregistrement est défini sur découvert ou enregistré :

1. Accédez à la page Services et charges de travail depuis App Hub :

   Accéder à Services et charges de travail

   La page affiche la liste de tous les services et charges de travail découverts et enregistrés.

2. Utilisez le champ Filtrer pour affiner les résultats par propriétés, attributs ou état, en utilisant des valeurs telles que Environnement, Propriétaires ou État de l'enregistrement.

gcloud

Affichez les détails des services et des charges de travail d'une application dont l'état d'enregistrement est registered (enregistré) ou detached (détaché) :

1. Trouvez l'ID de projet de votre projet de gestion.

2. Décrivez un service ou une charge de travail à partir d'une application pour examiner ses détails, y compris les propriétés et les attributs :

   • Décrivez un service :

     gcloud apphub applications services describe SERVICE \
         --project=PROJECT_ID \
         --application=APPLICATION \
         --location=LOCATION
     

     Remplacez les éléments suivants :

     • SERVICE : ID du service.
     • PROJECT_ID : ID de votre projet de gestion.
     • APPLICATION : ID de l'application à laquelle le service est enregistré.
     • LOCATION : emplacement du service. Utilisez global pour les ressources globales ou une région spécifique, telle que us-east1, pour les ressources régionales.

   • Décrivez une charge de travail :

     gcloud apphub applications workloads describe WORKLOAD \
         --project=PROJECT_ID \
         --application=APPLICATION \
         --location=LOCATION
     

     Remplacez les éléments suivants :

     • WORKLOAD : ID de la charge de travail.
     • PROJECT_ID : ID de votre projet de gestion.
     • APPLICATION : ID de l'application à laquelle la charge de travail est enregistrée.
     • LOCATION : emplacement de la charge de travail. Utilisez global pour les ressources globales ou une région spécifique, telle que us-east1, pour les ressources régionales.

La sortie affiche les détails du composant, tels que le nom à afficher, l'emplacement et l'état d'enregistrement. Il inclut également les propriétés et les attributs, s'ils sont présents sur la ressource.

Vous pouvez également afficher la liste de tous les services et charges de travail dont l'état d'enregistrement est défini sur découvert ou enregistré :

Découvert(e)

Les ressources Google Cloud découvertes dans la limite de gestion de votre application peuvent être enregistrées en tant que services ou charges de travail dans une application. Pour lister les ressources détectées, procédez comme suit :

1. Répertoriez les services découverts :

   gcloud apphub discovered-services list \
       --project=PROJECT_ID \
       --location=LOCATION
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet de gestion.
   • LOCATION : emplacement où vous souhaitez découvrir des ressources. Utilisez global pour les ressources globales ou une région spécifique, comme us-east1, pour les ressources régionales.

2. Répertoriez les charges de travail découvertes :

   gcloud apphub discovered-workloads list \
       --project=PROJECT_ID \
       --location=LOCATION
   

Inscrit

Les services et les charges de travail enregistrés font partie d'une application. Suivez ces étapes pour lister les composants enregistrés d'une application spécifique. Vous pouvez filtrer la liste en fonction des attributs à l'aide de l'indicateur --filter :

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

   gcloud apphub applications services list \
       --application=APPLICATION_NAME \
       --project=PROJECT_ID \
       --location=LOCATION \
       --filter=FILTER_EXPRESSION
   

   Remplacez les éléments suivants :

   • APPLICATION_NAME : nom de votre application. Vous spécifiez cette valeur lorsque vous créez une application.
   • PROJECT_ID : ID de votre projet de gestion.
   • LOCATION : emplacement du composant. Utilisez global pour les composants mondiaux ou une région spécifique, comme us-east1 pour les composants régionaux.
   • Facultatif : FILTER_EXPRESSION : expression de filtre permettant de spécifier des attributs. Par exemple, pour lister les composants avec un type d'environnement PRODUCTION, utilisez attributes.environment.type=PRODUCTION.

2. Répertorier les charges de travail enregistrées dans une application :

   gcloud apphub applications workloads list \
       --application=APPLICATION_NAME \
       --project=PROJECT_ID \
       --location=LOCATION \
       --filter=FILTER_EXPRESSION
   

L'état d'enregistrement des services et des charges de travail dans une application peut passer à détaché si vous déplacez un projet ou un dossier en dehors de la limite de gestion de votre application, ou si vous supprimez la ressource sous-jacente. Les services et les charges de travail dissociés restent dans l'application jusqu'à ce que vous les désenregistriez, mais App Hub ne peut plus les gérer ni les surveiller. Pour en savoir plus, consultez État d'enregistrement des services et des charges de travail.

Pour rattacher des services ou des charges de travail à une application, vous devez les enregistrer de nouveau.

Mettre à jour les attributs de service et de charge de travail

Pour modifier les attributs des services et des charges de travail enregistrés dans une application, procédez comme suit :

Console

1. Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion.

2. Accédez à la page Applications depuis App Hub :

   Accéder à la page Applications

   La page affiche la liste de vos applications.

3. Cliquez sur le nom de l'application pour laquelle vous souhaitez mettre à jour les attributs de service ou de charge de travail.

4. Dans l'onglet Services et charges de travail, recherchez le nom du service ou de la charge de travail que vous souhaitez mettre à jour.

5. Cliquez sur more_vert Plus, puis sur Modifier le service ou Modifier la charge de travail.

6. Dans le volet qui s'ouvre, modifiez les champs selon vos besoins, puis cliquez sur Enregistrer.

gcloud

1. Trouvez l'ID de projet de votre projet de gestion.

2. Mettez à jour les attributs du service ou de la charge de travail :

   • Mettez à jour les attributs du service :

     gcloud apphub applications services update SERVICE_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION \
         --display-name=DISPLAY_NAME \
         --criticality-type=CRITICALITY_LEVEL \
         --environment-type=ENVIRONMENT \
         --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
         --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
         --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
     

     Remplacez SERVICE_NAME par le nom du service que vous souhaitez mettre à jour.

   • Mettez à jour les attributs de la charge de travail :

     gcloud apphub applications workloads update WORKLOAD_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION \
         --display-name=DISPLAY_NAME \
         --criticality-type=CRITICALITY_LEVEL \
         --environment-type=ENVIRONMENT \
         --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
         --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
         --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
     

     Remplacez WORKLOAD_NAME par le nom de la charge de travail que vous souhaitez mettre à jour.

     Remplacez les indicateurs obligatoires et facultatifs suivants :

     • Obligatoire : APPLICATION_NAME, le nom de votre application. Vous spécifiez cette valeur lorsque vous créez une application.
     • Obligatoire : PROJECT_ID : ID de votre projet de gestion.
     • Obligatoire : LOCATION : emplacement de votre composant. Utilisez global pour les composants mondiaux ou une région spécifique, comme us-east1, pour les composants régionaux.
     • Facultatif : DISPLAY_NAME : nom à afficher de votre composant.

     • Facultatif : CRITICALITY_LEVEL : niveau d'importance du composant. Utilisez l'une des valeurs suivantes :

       • MISSION_CRITICAL
       • HIGH
       • MEDIUM
       • LOW

     • ENVIRONMENT (facultatif) : étape du cycle de vie du logiciel. Appliquez l'une des valeurs suivantes :

       • PRODUCTION
       • STAGING
       • DEVELOPMENT
       • TEST

     • Facultatif : DEV_NAME et DEV_EMAIL, respectivement le nom à afficher et l'adresse e-mail du propriétaire du compte de développeur.

     • Facultatif : OPERATOR_NAME et OPERATOR_EMAIL, respectivement le nom à afficher et l'adresse e-mail du propriétaire de l'opérateur.

     • Facultatif : BUSINESS_NAME et BUSINESS_EMAIL, respectivement le nom à afficher et l'adresse e-mail du propriétaire de l'établissement.

     Remarque : Les adresses e-mail doivent respecter le format username@yourdomain, par exemple [e-mail].

Terraform

Pour mettre à jour les attributs de service ou de charge de travail avec Terraform, modifiez les arguments dans le bloc de ressources google_apphub_service ou google_apphub_workload correspondant de votre fichier de configuration. Lorsque vous appliquez les modifications, Terraform met à jour la ressource pour qu'elle corresponde à la nouvelle configuration.

Les exemples suivants mettent à jour les attributs de criticité et d'environnement des services et des charges de travail d'une application régionale :

• Mettez à jour les attributs du service :

  resource "google_apphub_service" "example" {
      # ... other arguments
      attributes {
          criticality {
              type = "HIGH" # Updated criticality
          }
          environment {
              type = "PRODUCTION"
          }
          # ... other attributes
      }
  }
  

• Mettez à jour les attributs de la charge de travail :

  resource "google_apphub_workload" "example" {
      # ... other arguments
      attributes {
          criticality {
              type = "HIGH" # Updated criticality
          }
          environment {
              type = "PRODUCTION"
          }
          # ... other attributes
      }
  }
  

Annuler l'enregistrement des services et des charges de travail

Si vous annulez l'enregistrement d'un service ou d'une charge de travail, ils sont supprimés d'une application. La ressource sous-jacente n'est pas supprimée. S'il se trouve toujours dans les limites de gestion de votre application, il devient une ressource dont la valeur de l'état d'enregistrement est discovered (découverte), disponible pour l'enregistrement dans une autre application.

Pour annuler l'enregistrement des services et des charges de travail :

Console

1. Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion.

2. Accédez à la page Applications depuis App Hub :

   Accéder à la page Applications

   La page affiche la liste de vos applications.

3. Cliquez sur le nom de l'application dont vous souhaitez annuler l'enregistrement des services ou des charges de travail.

4. Dans l'onglet Services et charges de travail, cliquez sur le nom du service ou de la charge de travail que vous souhaitez annuler.

5. Sur la page d'informations du composant, cliquez sur Annuler l'enregistrement.

gcloud

1. Trouvez l'ID de projet de votre projet de gestion.

2. Annuler l'enregistrement d'un service ou d'une charge de travail :

   • Annuler l'enregistrement d'un service :

     gcloud apphub applications services delete SERVICE_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION
     

     Remplacez les éléments suivants :

     • SERVICE_NAME : nom du service que vous souhaitez annuler.
     • APPLICATION_NAME : nom de votre application. Vous spécifiez cette valeur lorsque vous créez une application.
     • PROJECT_ID : ID de votre projet de gestion.
     • LOCATION : emplacement du composant. Utilisez global pour les composants mondiaux ou une région spécifique, telle que us-east1, pour les composants régionaux.

   • Annuler l'enregistrement d'une charge de travail :

     gcloud apphub applications workloads delete WORKLOAD_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION
     

     Remplacez WORKLOAD_NAME par le nom de la charge de travail que vous souhaitez annuler.

Terraform

Pour annuler l'enregistrement d'un service ou d'une charge de travail gérés par Terraform, supprimez le bloc de ressources google_apphub_service ou google_apphub_workload correspondant de votre fichier de configuration, puis exécutez terraform apply. Lorsque vous appliquez les modifications, Terraform supprime l'enregistrement d'App Hub.

Après avoir annulé l'enregistrement de tous les services et charges de travail, vous pouvez supprimer l'application.

Étapes suivantes

• Gérer vos applications
• Optimiser une application avec des recommandations de conception
• Surveiller vos applications