Prérequis
Avant de modifier les ressources de l'App Hub, effectuez les tâches suivantes:
- Suivez les conditions préalables pour configurer App Hub.
- Selon le type de ressource que vous souhaitez modifier, assurez-vous d'avoir suivi la procédure de configuration d'App Hub. Pour en savoir plus, consultez Configurer App Hub.
Rôles requis
Pour obtenir les autorisations nécessaires pour modifier les ressources de l'App Hub, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le dossier compatible avec les applications:
-
Pour créer et mettre à jour des applications, enregistrer et annuler l'enregistrement de services et de charges de travail, et mettre à jour les attributs associés :
-
Administrateur App Hub (
roles/apphub.admin
) -
Éditeur App Hub (
roles/apphub.editor
)
-
Administrateur App Hub (
-
Pour afficher les applications, les services et les charges de travail, ainsi que leurs attributs :
Lecteur App Hub (
roles/apphub.viewer
) -
Pour afficher les applications, les services et les charges de travail, ainsi que leurs attributs dans les Google Cloud services compatibles avec la gestion des applications :
Lecteur de gestion App Hub (
roles/apphub.appManagementViewer
)
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Répertorier les applications
Vous pouvez lister et filtrer les applications dans un dossier compatible avec les applications.
Console
Pour afficher les applications d'un dossier compatible avec les applications, accédez à la page Applications du hub des applications dans la console Google Cloud.
Pour filtrer les applications:
- Dans le champ Filtre, sélectionnez un filtre tel que Criticité.
- Spécifiez une valeur pour le filtre. Par exemple, pour afficher les applications à criticité élevée, sélectionnez Élevée comme valeur.
Une liste des applications correspondant au filtre spécifié s'affiche.
gcloud
Pour afficher les applications d'un dossier compatible avec les applications:
gcloud apphub applications list \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Remplacez les éléments suivants :
MANAGEMENT_PROJECT_ID
: ID de votre projet de gestion. Vous trouverez l'ID de votre projet de gestion sur la page Paramètres de la console Google Cloud, sous "Identity and Access Management (IAM) and Admin" (Gestion des identités et des accès (IAM) et administration). Si vous ne trouvez pas l'ID du projet de gestion, il est possible que vous ne vous trouviez pas dans un dossier compatible avec l'application. Dans le sélecteur de portée (ou sélecteur de projet), sélectionnez votre dossier compatible avec les applications. Pour en savoir plus sur l'activation d'un dossier pour la gestion des applications, consultez Activer la gestion des applications.REGION
: région de l'application. En fonction du--scope-type
de l'application, attribuez la valeurglobal
ou la région de l'application, par exempleus-east1
. Pour en savoir plus sur la configuration de--scope-type
pour l'application, consultez Créer une application.
Pour filtrer les applications en fonction des attributs de variable, utilisez l'indicateur
--filter
. Par exemple, pour lister toutes les applications où l'attributenvironment-type
est défini surPRODUCTION
:gcloud apphub applications list \ --filter='attributes.environment.type=PRODUCTION' \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Afficher une application
Vous pouvez décrire une application dans un dossier compatible avec les applications.
Console
Dans la console Google Cloud, accédez à la page Applications du hub d'applications.
Dans la liste des applications, cliquez sur celle dont vous souhaitez connaître les détails.
Cliquez sur l'onglet Détails pour afficher les informations sur l'application.
gcloud
gcloud apphub applications describe APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Remplacez APPLICATION_NAME
par le nom de votre application. Le nom ne doit contenir que des caractères alphanumériques minuscules sans espaces.
Mettre à jour une application App Hub
Vous pouvez mettre à jour les attributs de votre application après sa création.
Console
Dans la console Google Cloud, accédez à la page Applications du hub d'applications.
Dans la liste des applications, cliquez sur
Modifier pour l'application que vous souhaitez mettre à jour.Modifiez les champs si nécessaire.
Cliquez sur Enregistrer.
gcloud
Mettez à jour votre application avec les attributs
criticality-type
,environment-type
et type de propriétaire:gcloud apphub applications update APPLICATION_NAME \ --display-name='APPLICATION_DISPLAY_NAME' \ --criticality-type='CRITICALITY_LEVEL' \ --environment-type='ENVIRONMENT' \ --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \ --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \ --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Remplacez les éléments suivants :
APPLICATION_NAME
: nom de votre application. Le nom ne doit contenir que des caractères alphanumériques en minuscules, sans espaces.REGION
: région de l'application.
Vous pouvez mettre à jour les informations suivantes :
APPLICATION_DISPLAY_NAME
: indique le nom à afficher de l'application.CRITICALITY_LEVEL
: indique le niveau de criticité d'une application, d'un service ou d'une charge de travail pour vos opérations commerciales. Indiquez l'une des valeurs suivantes :MISSION_CRITICAL
HIGH
MEDIUM
LOW
ENVIRONMENT
: indique les étapes du cycle de vie du logiciel. Indiquez l'une des valeurs suivantes :PRODUCTION
STAGING
DEVELOPMENT
TEST
DISPLAY-NAME-DEVELOPER
,DISPLAY-NAME-OPERATOR
etDISPLAY-NAME-BUSINESS
: noms à afficher du développeur, de l'opérateur et des propriétaires d'établissements, respectivement.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
etEMAIL-NAME-BUSINESS
: adresses e-mail du développeur, de l'opérateur et des propriétaires d'établissements, respectivement. Ces valeurs doivent être au formatusername@yourdomain
(par exemple,222larabrown@gmail.com
).
Exemple :
gcloud apphub applications update my-application \ --criticality-type='MEDIUM' \ --environment-type='STAGING' \ --developer-owners=display-name=developer-name,email=username@yourdomain \ --project=google-mpf-FOLDER-ID \ --location=us-east1
Afficher les services et les charges de travail
Vous pouvez afficher, lister et filtrer les services et les charges de travail d'une application.
Console
Pour afficher la liste des services et des charges de travail:
Dans la console Google Cloud, accédez à la page Services et charges de travail de l'App Hub.
Dans la liste Région, sélectionnez les régions à partir desquelles vous souhaitez afficher les services et les charges de travail. Par exemple, sélectionnez us-east1.
La page Services et charges de travail affiche tous les services et charges de travail des projets de service associés à us-east1.
Pour filtrer les services ou les charges de travail:
- Dans le champ Filtre, sélectionnez un filtre tel que Environnement.
- Spécifiez une valeur pour le filtre. Par exemple, pour afficher les services et les charges de travail en production, sélectionnez Production comme valeur.
Une liste des services et des charges de travail correspondant au filtre spécifié s'affiche.
gcloud
Répertorier les services détectés
Les services détectés peuvent être enregistrés dans une application.
Pour afficher la liste des services détectés:
gcloud apphub discovered-services list \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Vous obtenez un résultat semblable à celui-ci :
ID SERVICE_REFERENCE SERVICE_PROPERTIES [DISCOVERED_SERVICE_ID] {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'} {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
(Facultatif) Filtrez la liste des services détectés. Par exemple, pour filtrer les services découverts avec des règles de transfert dans le dossier activé par l'application:
gcloud apphub discovered-services list \ --filter='service_reference.uri~"forwardingRules"' \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Répertorier les services enregistrés
Lister et filtrer les services App Hub enregistrés à partir d'une application
Pour afficher la liste des services enregistrés dans une application:
gcloud apphub applications services list \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Vous obtenez un résultat semblable à celui-ci :
ID DISPLAY_NAME SERVICE_REFERENCE CREATE_TIME SERVICE_NAME mywebserver-service1 {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule'} 2023-11-01T21:38:08
Les services enregistrés, mais dissociés, sont indiqués par une valeur vide dans le champ
SERVICE_REFERENCE
.(Facultatif) Filtrez la liste des services enregistrés. Par exemple, pour filtrer les services enregistrés dans une application où l'attribut
environment-type
est défini surPRODUCTION
:gcloud apphub applications services list \ --filter='attributes.environment.type=PRODUCTION' \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Répertorier les charges de travail détectées
Les charges de travail détectées peuvent être enregistrées dans une application.
Pour lister les charges de travail détectées:
gcloud apphub discovered-workloads list \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Un résultat semblable à celui-ci s'affiche, y compris les MIG non enregistrés:
ID WORKLOAD_REFERENCE WORKLOAD_PROPERTIES [DISCOVERED_WORKLOAD_ID] {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'} {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
Facultatif: Filtrez la liste des charges de travail détectées. Par exemple, pour filtrer la liste des charges de travail détectées avec des ressources de calcul dans un dossier compatible avec les applications:
gcloud apphub discovered-workloads list \ --filter='workload_reference.uri~"compute"' --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Répertorier les charges de travail enregistrées
Répertoriez et filtrez les charges de travail App Hub enregistrées à partir d'une application.
Pour lister les charges de travail enregistrées dans une application:
gcloud apphub applications workloads list \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Vous obtenez un résultat semblable à celui-ci :
ID DISPLAY_NAME WORKLOAD_REFERENCE CREATE_TIME WORKLOAD_NAME mywebserver-deployment1 {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'} 2023-10-31T18:34:23
Les charges de travail enregistrées, mais dissociées, sont indiquées par une valeur vide dans le champ
WORKLOAD_REFERENCE
. Pour en savoir plus sur les états d'enregistrement, consultez les propriétés et attributs d'App Hub.(Facultatif) Filtrez la liste des charges de travail enregistrées. Par exemple, pour filtrer les charges de travail d'une application où l'attribut
environment-type
est défini surPRODUCTION
:gcloud apphub applications workloads list \ --filter='attributes.environment.type=PRODUCTION' \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Mettre à jour des services et des charges de travail
Vous pouvez mettre à jour les services et les charges de travail enregistrés dans une application.
Console
Dans la console Google Cloud, accédez à la page Applications de l'App Hub.
Cliquez sur le nom de votre application.
L'onglet Services et charges de travail s'affiche avec la liste des services et charges de travail enregistrés dans vos projets de service.Pour chaque service ou charge de travail que vous souhaitez mettre à jour, procédez comme suit:
- Dans l'onglet Services et charges de travail, cliquez sur more_vert pour le service ou la charge de travail que vous souhaitez mettre à jour, puis sur Modifier le service ou Modifier la charge de travail.
- Dans le volet Modifier le service ou Modifier la charge de travail, modifiez les champs si nécessaire, puis cliquez sur Enregistrer.
gcloud
Mettez à jour votre service avec les attributs
criticality-type
,environment-type
et type de propriétaire:gcloud apphub applications services update SERVICE_NAME \ --application=APPLICATION_NAME \ --display-name='SERVICE_DISPLAY_NAME' \ --criticality-type='CRITICALITY_LEVEL' \ --environment-type='ENVIRONMENT' \ --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \ --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \ --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Remplacez
SERVICE_NAME
par le nom du service App Hub.Vous pouvez mettre à jour les informations suivantes :
SERVICE_DISPLAY_NAME
: indique un nom à afficher pour le service.CRITICALITY_LEVEL
: indique le niveau de criticité d'une application, d'un service ou d'une charge de travail pour vos opérations commerciales. Indiquez l'une des valeurs suivantes :MISSION_CRITICAL
HIGH
MEDIUM
LOW
ENVIRONMENT
: indique les étapes du cycle de vie du logiciel. Indiquez l'une des valeurs suivantes :PRODUCTION
STAGING
DEVELOPMENT
TEST
DISPLAY-NAME-DEVELOPER
,DISPLAY-NAME-OPERATOR
etDISPLAY-NAME-BUSINESS
: noms à afficher du développeur, de l'opérateur et des propriétaires d'établissements, respectivement.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
etEMAIL-NAME-BUSINESS
: adresses e-mail du développeur, de l'opérateur et des propriétaires d'établissements, respectivement. Ces valeurs doivent être au formatusername@yourdomain
(par exemple,222larabrown@gmail.com
).
Exemple :
gcloud apphub applications workloads update my-application \ --criticality-type='MEDIUM' \ --environment-type='STAGING' \ --developer-owners=display-name=developer-name,email=username@yourdomain \ --project=google-mpf-FOLDER-ID \ --location=us-east1
Mettez à jour votre charge de travail avec les attributs
criticality-type
,environment-type
et type de propriétaire:gcloud apphub applications workloads update WORKLOAD_NAME \ --application=APPLICATION_NAME \ --display-name='WORKLOAD_DISPLAY_NAME' \ --criticality-type='CRITICALITY_LEVEL' \ --environment-type='ENVIRONMENT' \ --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \ --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \ --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Remplacez
WORKLOAD_NAME
par le nom de la charge de travail du hub d'applications.Vous pouvez mettre à jour les informations suivantes :
WORKLOAD_DISPLAY_NAME
: indique un nom à afficher pour le service.CRITICALITY_LEVEL
: indique le niveau de criticité d'une application, d'un service ou d'une charge de travail pour vos opérations commerciales. Indiquez l'une des valeurs suivantes :MISSION_CRITICAL
HIGH
MEDIUM
LOW
ENVIRONMENT
: indique les étapes du cycle de vie du logiciel. Indiquez l'une des valeurs suivantes :PRODUCTION
STAGING
DEVELOPMENT
TEST
DISPLAY-NAME-DEVELOPER
,DISPLAY-NAME-OPERATOR
etDISPLAY-NAME-BUSINESS
: noms à afficher du développeur, de l'opérateur et des propriétaires d'établissements, respectivement.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
etEMAIL-NAME-BUSINESS
: adresses e-mail du développeur, de l'opérateur et des propriétaires d'établissements, respectivement. Ces valeurs doivent être au formatusername@yourdomain
(par exemple,222larabrown@gmail.com
).
Exemple :
gcloud apphub applications workloads update my-application \ --criticality-type='MEDIUM' \ --environment-type='STAGING' \ --developer-owners=display-name=developer-name,email=username@yourdomain \ --project=google-mpf-FOLDER-ID \ --location=us-east1
Supprimer des applications, des services et des charges de travail
Supprimez une application existante pour supprimer les ressources enregistrées associées au dossier compatible avec les applications. Pour ce faire, vous devez d'abord annuler l'enregistrement des charges de travail et des services enregistrés dans l'application.
Console
Dans la console Google Cloud, accédez à la page Applications du hub d'applications.
Cliquez sur le nom d'une application. La liste des services et des charges de travail enregistrés dans l'application s'affiche.
Désenregistrer un service ou une charge de travail
- Dans l'onglet Services et charges de travail, dans la section Services et charges de travail enregistrés, cliquez sur le nom du service ou de la charge de travail que vous souhaitez annuler.
- Sur la page du service ou de la charge de travail enregistrés qui s'ouvre, cliquez sur Désenregistrer pour mettre à jour le service ou la charge de travail en tant que ressource découverte. Dans l'onglet Services et charges de travail, une alerte indique que la charge de travail n'est pas enregistrée.
- Répétez ces instructions pour chaque service et chaque charge de travail.
Accédez à la page Applications d'App Hub.
Cliquez sur le nom d'une application.
Sur la page des détails de l'application, cliquez sur Supprimer.
gcloud
Répertoriez les services enregistrés dans l'application:
gcloud apphub applications services list \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Désinscrivez le service de l'application:
gcloud apphub applications services delete SERVICE_NAME \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Le service est désormais un service détecté qui peut être enregistré dans l'application.
Répétez la commande précédente pour annuler l'enregistrement des services enregistrés restants dans l'application.
Répertoriez les charges de travail enregistrées dans l'application:
gcloud apphub applications workloads list \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Annulez l'enregistrement de la charge de travail dans l'application:
gcloud apphub applications workloads delete WORKLOAD_NAME \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
La charge de travail est désormais une charge de travail découverte qui peut être enregistrée dans l'application.
Répétez la commande précédente pour supprimer les charges de travail enregistrées restantes de l'application.
Supprimez l'application:
gcloud apphub applications delete APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Étape suivante
- Configurer la surveillance des applications
- Rôles et autorisations IAM dans App Hub
- Présentation d'App Hub
- Résoudre les problèmes