Gérer les services et les charges de travail

App Hub vous permet de gérer les services et les charges de travail directement enregistrés et découverts afin de garantir l'exactitude des métadonnées de votre application. À mesure que votre infrastructure évolue, vous pouvez afficher les détails des composants, mettre à jour les attributs ou annuler l'enregistrement des composants d'une application.

Pour les applications déployées à partir d'un modèle, mettez à jour les composants dans Application Design Center.

Présentation

Lorsque vous choisissez votre modèle de configuration d'application, vous définissez un périmètre 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 des applications situées dans 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 toute dérive de configuration et conserver une source de vérité claire, nous vous recommandons de gérer vos composants d'application dans l'environnement où ils ont été initialement définis :

  • Pour les applications déployées à partir d'un modèle Application Design Center : utilisez Application Design Center pour gérer et mettre à jour l'application. Vous pouvez modifier le modèle pour modifier la conception de l'application ou créer une révision d'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

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 gérés 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 votre périmètre de gestion des applications :

  • 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 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 dans votre périmètre de gestion des applications, y compris les éléments suivants :

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 ou detached :

  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écouvert ou enregistré :

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

    Accéder à la page "Services et charges de travail"

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

  2. Utilisez le champ Filtre pour affiner les résultats par propriétés, attributs ou état, à l'aide de valeurs telles que Environnement, Propriétaires ou État d'enregistrement.

gcloud

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

  1. Recherchez l'ID du projet de votre projet de gestion.

  2. Décrivez un service ou une charge de travail d'une application pour examiner ses détails, y compris ses propriétés et ses 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 auprès de 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 auprès de 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 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écouvert ou enregistré :

Découvert(e)

Les ressources Google Cloud découvertes dans votre périmètre de gestion des applications peuvent être enregistrées en tant que services ou charges de travail dans une application. Pour lister les ressources découvertes, 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, telle que 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'option --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 globaux ou une région spécifique, telle que 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épertoriez 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 d'une application peut passer à dissocié si vous déplacez un projet ou un dossier hors de votre périmètre de gestion des applications, ou si vous supprimez la ressource sous-jacente. Les services et charges de travail dissociés restent dans l'application jusqu'à ce que vous les désinscriviez, 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 à nouveau.

Afficher les schémas de métadonnées étendus

App Hub enrichit vos services et vos charges de travail avec des métadonnées pour améliorer la visibilité, la gouvernance et l'intégration avec d'autres systèmes. Vous pouvez rechercher les schémas de métadonnées disponibles et afficher leurs définitions à l'aide de l'API App Hub.

Suivez ces étapes pour afficher la définition de schéma de la propriété de métadonnées étendue, lister tous les schémas disponibles ou obtenir les détails d'un schéma spécifique, le cas échéant.

Pour en savoir plus sur la propriété de métadonnées étendue, consultez Propriétés et attributs. Pour obtenir la liste des types de métadonnées compatibles et de leurs schémas, consultez Schémas de métadonnées étendus.

gcloud

  • Répertoriez tous les schémas de métadonnées étendues disponibles dans un projet et un emplacement :

    gcloud alpha apphub extended-metadata-schemas list \
    --project=PROJECT_ID \
    --location=LOCATION \

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet de gestion.
    • LOCATION : emplacement du composant. Utilisez global pour les composants globaux ou une région spécifique, telle que us-east1, pour les composants régionaux.

  • Affichez les détails d'un schéma spécifique :

    gcloud alpha apphub extended-metadata-schemas describe SCHEMA_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \

    Remplacez SCHEMA_NAME par le nom complet du schéma, par exemple apphub.googleapis.com/AgentProperties.

Terraform

Vous pouvez utiliser une source de données dans Terraform pour récupérer les détails d'un schéma spécifique. L'exemple suivant vous permet d'afficher les détails du schéma apphub.googleapis.com/AgentProperties pour une charge de travail de type fonctionnel AGENT dans le projet my-project-id à l'emplacement us-central1.

data "google_apphub_extended_metadata_schema" "agent_properties" {
  project  = "my-project-id"
  location = "us-central1"
  name     = "apphub.googleapis.com/AgentProperties"
}

Mettre à jour les attributs des services et des charges 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. Recherchez l'ID du 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 options obligatoires et facultatives suivantes :

      • Obligatoire : APPLICATION_NAME : 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 globaux ou une région spécifique, telle que us-east1, pour les composants régionaux.
      • DISPLAY_NAME (facultatif) : 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 : nom à afficher et adresse e-mail du développeur propriétaire, respectivement.

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

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

Terraform

Pour mettre à jour les attributs d'un service ou d'une 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 de services et de 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. Si elle se trouve toujours dans votre périmètre de gestion des applications, elle devient une ressource dont l'état d'enregistrement est découvert, disponible pour l'enregistrement dans une autre application.

Pour annuler l'enregistrement de services et de charges de travail, 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 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 dont vous souhaitez annuler l'enregistrement.

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

gcloud

  1. Recherchez l'ID du 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 dont vous souhaitez annuler l'enregistrement.
      • 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 globaux 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 dont vous souhaitez annuler l'enregistrement.

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 de App Hub.

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

Étapes suivantes