Gérer les services et les charges de travail

Lorsque vous configurez App Hub, vous créez une limite administrative pour vos applications. Cette limite correspond soit au projet de gestion, soit à l'ensemble des projets hôtes et de service que vous avez configurés pour la gestion des applications, en fonction de votre modèle de configuration. Les services et les charges de travail sont enregistrés en tant qu'applications à l'intérieur de cette limite administrative.

Pour éviter la dérive de configuration et maintenir une source de vérité claire, nous vous recommandons de gérer les ressources de votre application dans l'environnement où elles ont été définies à 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 dans App Hub : gérez l'application, ses services et ses charges de travail directement dans App Hub.

    Accéder au hub d'applications

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

Avant de commencer

Avant de pouvoir afficher, modifier et annuler l'enregistrement des services et des charges de travail dans App Hub, procédez comme suit :

  1. Configurez App Hub à l'aide de l'un des modèles de configuration compatibles.
  2. Enregistrez les ressources compatibles dans une application.

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 dans la limite administrative de l'application à partir de votre modèle de configuration (le projet de gestion ou les projets hôte et de service) :

  • Mettre à jour et annuler l'enregistrement des services et des charges de travail : Éditeur App Hub (roles/apphub.editor)
  • Afficher les services et les charges de travail : 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

Pour afficher les détails des services et des charges de travail, y compris leur emplacement et leur état d'enregistrement dans une application, dans votre limite administrative App Hub, procédez comme suit :

Console

Affichez les détails des services et des charges de travail enregistrés ou détachés d'une application :

  1. Sur la page Bienvenue de la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion ou votre projet hôte :

    Accéder à la page d'accueil

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

    Accéder à la page Applications

    La page affiche la liste de vos applications.

  3. Cliquez sur le nom de l'application à partir de laquelle vous souhaitez afficher les services ou les 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 afficher.

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

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

  1. Accédez à la page Services et charges de travail d'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 attributs tels que Environnement ou État de l'enregistrement.

gcloud

Affichez les détails des services et des charges de travail enregistrés ou détachés d'une application :

  1. Trouvez l'ID du projet de votre projet de gestion ou de votre projet hôte.

  2. Décrivez un service ou une charge de travail à partir d'une application pour examiner ses détails :

    • 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 hôte ou 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 hôte ou 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 de la ressource, tels que le nom à afficher, l'emplacement, l'état d'enregistrement et les attributs.

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

Ressources détectées

Les ressources détectées peuvent être enregistrées dans une application. Pour lister les ressources détectées, procédez comme suit :

  1. Répertoriez les services détectés :

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

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet hôte ou 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

Ressources enregistrées

Les ressources enregistrées font partie d'une application. Suivez ces étapes pour lister les ressources enregistrées 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 hôte ou de gestion.
    • LOCATION : emplacement de la ressource. Utilisez global pour les ressources mondiales ou une région spécifique, comme us-east1, pour les ressources régionales.
    • Facultatif : FILTER_EXPRESSION, expression de filtre permettant de spécifier des attributs. Par exemple, pour lister les ressources 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 d'une application peut passer à détaché si vous modifiez la structure organisationnelle de vos ressources Google Cloudou 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 en fonction de la hiérarchie des ressources de votre modèle de configuration.

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

Pour modifier les attributs définis par l'utilisateur des services et des charges de travail enregistrés dans une application, procédez comme suit :

Console

  1. Sur la page Bienvenue de la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion ou votre projet hôte :

    Accéder à la page d'accueil

  2. Accédez à la page Applications d'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 modifier 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 du projet de votre projet de gestion ou de votre projet hôte.

  2. Mettez à jour les attributs de service ou de 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 hôte ou de gestion.
      • Obligatoire : LOCATION : emplacement de votre ressource. Utilisez global pour les ressources globales ou une région spécifique, comme us-east1 pour les ressources régionales.
      • DISPLAY_NAME (facultatif) : nom à afficher de votre ressource.

      • CRITICALITY_LEVEL (facultatif) : niveau d'importance de la ressource. 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 propriétaire du développeur, 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, respectivement le nom à afficher et l'adresse e-mail du propriétaire de l'établissement.

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, il est supprimé d'une application. La ressource sous-jacente n'est pas supprimée et redevient une ressource découverte, disponible pour l'enregistrement dans une autre application.

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

Console

  1. Sur la page Bienvenue de la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion ou votre projet hôte :

    Accéder à la page d'accueil

  2. Accédez à la page Applications d'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 de la ressource, cliquez sur Annuler l'enregistrement.

gcloud

  1. Trouvez l'ID du projet de votre projet de gestion ou de votre projet hôte.

  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 hôte ou de gestion.
      • LOCATION : emplacement de la ressource. Utilisez global pour les ressources globales ou une région spécifique, comme us-east1 pour les ressources régionales.

    • 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