Gérer les applications App Hub

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

Cette page explique comment gérer les applications enregistrées directement dans App Hub. Vous pouvez effectuer ces actions à l'aide de la consoleGoogle 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

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 la limite de gestion de vos 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 pour App Hub.

Lister les applications

Pour lister et filtrer toutes les applications dans 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 Criticalité ou Environnement.

gcloud

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

  2. Affichez la liste de vos applications en utilisant 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 ou une région spécifique, comme us-east1, pour les applications régionales.

    • Filtrez la liste des applications en fonction des attributs à l'aide de l'indicateur --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 ou une région spécifique, comme 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 la demande

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. Trouvez l'ID de 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 ou une région spécifique, comme 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 :

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 selon vos besoins.

  5. Cliquez sur Enregistrer.

gcloud

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

  2. Mettez à jour les attributs de l'application. Vous pouvez mettre à jour n'importe quel attribut mutable, 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 ou une région spécifique, comme 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, respectivement le nom à afficher et l'adresse e-mail du propriétaire du compte de développeur.

    • 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'entreprise.

Terraform

Pour mettre à jour les attributs d'application avec Terraform, modifiez les arguments dans le bloc de ressource google_apphub_application de 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, puis assurez-vous d'avoir désenregistré tous les composants de l'application. Pour en savoir plus, consultez Désenregistrer des services et des charges de travail.

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

gcloud

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

  2. Assurez-vous d'avoir désenregistré tous les composants de l'application. Pour en savoir plus, consultez Désenregistrer 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 ou une région spécifique, comme us-east1, pour les applications régionales.

Terraform

Pour supprimer une application gérée par Terraform, vous avez les options suivantes :

  • Supprimez la ressource de votre configuration : supprimez le bloc de la ressource google_apphub_application de votre fichier Terraform, puis exécutez terraform apply. Terraform reconnaît que la ressource ne se trouve plus dans la configuration et la supprime de votre projet.
  • Arrêtez 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