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.
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.
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 :
-
Mettre à jour et supprimer des applications : Éditeur App Hub (
roles/apphub.editor) -
Afficher les applications : 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.
Lister les applications
Pour lister et filtrer toutes les applications de votre périmètre de gestion des applications, procédez comme suit :
Console
Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion.
Accédez à la page Applications depuis App Hub :
Accéder à la page Applications
La page affiche la liste de vos applications.
Pour filtrer la liste, utilisez le champ Filtre. Vous pouvez filtrer par attributs tels que Criticité ou Environnement.
gcloud
Recherchez l'ID du projet de votre projet de gestion.
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=LOCATIONRemplacez les éléments suivants :
PROJECT_ID: ID de votre projet de gestion.LOCATION: emplacement de vos applications. Utilisezglobalpour les applications mondiales, un emplacement multirégional (usoueu) pour les applications multirégionales ou une région spécifique, telle queus-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. Utilisezglobalpour les applications mondiales, un emplacement multirégional (usoueu) pour les applications multirégionales ou une région spécifique, telle queus-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'environnementPRODUCTION, utilisezattributes.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
Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion.
Accédez à la page Applications depuis App Hub :
Accéder à la page Applications
La page affiche la liste de vos applications.
Cliquez sur le nom de l'application que vous souhaitez afficher.
L'onglet Détails de l'application s'affiche.
gcloud
Recherchez l'ID du projet de votre projet de gestion.
Décrivez une application :
gcloud apphub applications describe APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATIONRemplacez 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. Utilisezglobalpour les applications mondiales, un emplacement multirégional (usoueu) pour les applications multirégionales, ou une région spécifique, telle queus-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
Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion.
Accédez à la page Applications depuis App Hub :
Accéder à la page Applications
La page affiche la liste de vos applications.
Pour l'application que vous souhaitez modifier, cliquez sur Modifier.
Dans le volet Modifier l'application, modifiez les champs si nécessaire.
Cliquez sur Enregistrer.
gcloud
Recherchez l'ID du projet de votre projet de gestion.
Mettre à jour les attributs de l'application. Vous pouvez mettre à jour n'importe quel attribut modifiable, tel que
display-name,criticality-type,environment-typeet 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_EMAILRemplacez 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. Utilisezglobalpour les applications mondiales, un emplacement multirégional (usoueu) pour les applications multirégionales, ou une région spécifique, telle queus-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_CRITICALHIGHMEDIUMLOW
ENVIRONMENT(facultatif) : étape du cycle de vie du logiciel. Appliquez l'une des valeurs suivantes :PRODUCTIONSTAGINGDEVELOPMENTTEST
Facultatif :
DEV_NAMEetDEV_EMAIL: nom à afficher et adresse e-mail du développeur propriétaire, respectivement.Facultatif :
OPERATOR_NAMEetOPERATOR_EMAIL: nom à afficher et adresse e-mail du propriétaire de l'opérateur, respectivement.Facultatif :
BUSINESS_NAMEetBUSINESS_EMAIL: respectivement le nom à afficher et l'adresse e-mail du propriétaire de l'établissement.
- Obligatoire :
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
Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion.
Accédez à la page Applications depuis App Hub :
Accéder à la page Applications
La page affiche la liste de vos applications.
Cliquez sur le nom de l'application que vous souhaitez supprimer.
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.
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
Recherchez l'ID du projet de votre projet de gestion.
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.
Une fois que l'application n'a plus de composants enregistrés, supprimez-la :
gcloud apphub applications delete APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATIONRemplacez 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. Utilisezglobalpour les applications mondiales, un emplacement multirégional (usoueu) pour les applications multirégionales, ou une région spécifique, telle queus-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_applicationde votre fichier Terraform, puis exécutezterraform 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 destroypour arrêter toutes les ressources gérées par votre configuration Terraform, y compris l'application.