Gérer les applications App Hub

App Hub vous permet d'afficher vos applications enregistrées, de mettre à jour leurs attributs et de supprimer des applications afin de maintenir l'exactitude de votre inventaire d'applications. Pour éviter toute dérive de configuration, n'utilisez App Hub que pour mettre à jour ou supprimer les applications que vous avez enregistrées directement, et gérez les applications basées sur des modèles 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 découvrir les cas d'utilisation recommandés pour introduire des pratiques de gestion des applications, consultez Se préparer à la gestion des applications. Pour créer une application et enregistrer des ressources, consultez Enregistrer des ressources existantes dans une application.

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

Dans App Hub, vous pouvez effectuer ces actions à l'aide de la consoleGoogle Cloud ou de la Google Cloud CLI. Pour les applications déployées à partir d'un modèle, consultez la documentation d'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 applications 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 :

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.

Lister les applications

Pour lister et filtrer toutes les applications de votre périmètre de gestion des applications, 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. Pour filtrer la liste, utilisez le champ Filtre. Vous pouvez filtrer par attributs tels que Criticité ou Environnement.

gcloud

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

  2. Affichez la liste de vos applications à l'aide de l'une des options suivantes :

    • Répertoriez toutes les applications :

      gcloud apphub applications list \
          --project=PROJECT_ID \
          --location=LOCATION
      

      Remplacez les éléments suivants :

      • PROJECT_ID : ID de votre projet de gestion.
      • LOCATION : emplacement de vos applications. Utilisez global pour les applications mondiales, un emplacement multirégional (us ou eu) pour les applications multirégionales ou une région spécifique, telle que us-east1, pour les applications régionales.
    • Filtrez la liste des applications en fonction des attributs à l'aide de l'option --filter :

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

      Remplacez les éléments suivants :

      • PROJECT_ID : ID de votre projet de gestion.
      • LOCATION : emplacement de vos applications. Utilisez global pour les applications mondiales, un emplacement multirégional (us ou eu) pour les applications multirégionales ou une région spécifique, telle que us-east1, pour les applications régionales.
      • FILTER_EXPRESSION : expression de filtre permettant de spécifier des attributs. Par exemple, pour lister toutes les applications avec un type d'environnement PRODUCTION, utilisez attributes.environment.type=PRODUCTION.

Afficher les détails de l'application

Pour afficher les informations détaillées d'une application spécifique, y compris ses attributs et ses métadonnées, 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 que vous souhaitez afficher.

    L'onglet Détails de l'application s'affiche.

gcloud

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

  2. Décrivez une application :

    gcloud apphub applications describe APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION
    

    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 de votre application. Utilisez global pour les applications mondiales, un emplacement multirégional (us ou eu) pour les applications multirégionales, ou une région spécifique, telle que us-east1, pour les applications régionales.

Mettre à jour les attributs de l'application

Pour modifier les attributs d'une application après sa création, procédez comme suit. Les services et les charges de travail peuvent également utiliser les mêmes attributs d'application lors de l'enregistrement.

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. Pour l'application que vous souhaitez modifier, cliquez sur Modifier.

  4. Dans le volet Modifier l'application, modifiez les champs si nécessaire.

  5. Cliquez sur Enregistrer.

gcloud

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

  2. Mettre à jour les attributs de l'application. Vous pouvez mettre à jour n'importe quel attribut modifiable, tel que display-name, criticality-type, environment-type et les propriétaires :

    gcloud apphub applications update 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 les éléments suivants :

    • 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 application. Utilisez global pour les applications mondiales, un emplacement multirégional (us ou eu) pour les applications multirégionales, ou une région spécifique, telle que us-east1, pour les applications régionales.
    • Facultatif : DISPLAY_NAME : nom à afficher de votre application.
    • CRITICALITY_LEVEL (facultatif) : niveau d'importance de l'application. Appliquez 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 : respectivement le nom à afficher et l'adresse e-mail du propriétaire de l'établissement.

Terraform

Pour mettre à jour les attributs d'une application avec Terraform, modifiez les arguments du bloc de la ressource google_apphub_application dans votre fichier de configuration. Lorsque vous appliquez les modifications, Terraform met à jour l'application pour qu'elle corresponde à la nouvelle configuration.

L'exemple suivant met à jour les attributs de criticité et d'environnement d'une application régionale dans us-central1 :

resource "google_apphub_application" "example" {
    project        = "my-project-id"
    location       = "us-central1"
    application_id = "my-application"
    display_name   = "My Application"
    description    = "This application represents our platform."
    attributes {
        criticality {
            type = "HIGH" # Updated criticality
        }
        environment {
            type = "PRODUCTION"
        }
        # ... other attributes
    }
}

Supprimer une application

Avant de pouvoir supprimer une application, vous devez d'abord annuler l'enregistrement de tous ses services et charges de travail. Ensuite, procédez comme suit pour supprimer l'application :

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 que vous souhaitez supprimer.

  4. Accédez à l'onglet Services et charges de travail et assurez-vous d'avoir désenregistré tous les composants d'application. Pour en savoir plus, consultez Annuler l'enregistrement de services et de charges de travail.

  5. Une fois que tous les services et charges de travail ont été désenregistrés, revenez aux détails de l'application et cliquez sur Supprimer.

gcloud

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

  2. Assurez-vous d'avoir désenregistré tous les composants d'application. Pour en savoir plus, consultez Annuler l'enregistrement des services et des charges de travail.

  3. Une fois que l'application n'a plus de composants enregistrés, supprimez-la :

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

    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 de votre application. Utilisez global pour les applications mondiales, un emplacement multirégional (us ou eu) pour les applications multirégionales, ou une région spécifique, telle que us-east1, pour les applications régionales.

Terraform

Pour supprimer une application gérée par Terraform, vous disposez des options suivantes :

  • Supprimez la ressource de votre configuration : supprimez le bloc de ressource google_apphub_application de votre fichier Terraform, puis exécutez terraform apply. Terraform reconnaît que la ressource n'est plus dans la configuration et la supprime de votre projet.
  • Arrêter toutes les ressources : exécutez la commande terraform destroy pour arrêter toutes les ressources gérées par votre configuration Terraform, y compris l'application.

Étapes suivantes