Cette page a été traduite par l'API Cloud Translation.

Configurer App Hub

Ce document explique comment configurer App Hub pour créer, exploiter et gérer des applications sur Google Cloud. Il est destiné aux personnes qui configurent et gèrent App Hub.

Si vous configurez App Hub, les tâches principales sont les suivantes : ce qui suit:

Déterminez si vous souhaitez créer un projet hôte App Hub ou utiliser un projet existant en tant que projet hôte.
- Si vous prévoyez d'avoir plusieurs projets hôte, nous vous recommandons vivement que vous les créez dans le même dossier.
- Les projets hôtes dans App Hub ne sont pas les mêmes que les projets hôtes de VPC partagés et n'ont pas les mêmes exigences. Par exemple, vous ne devez pas ont besoin d'un réseau VPC partagé pour utiliser App Hub. Dans ce document, toutes les références aux projets hôtes font référence aux projets hôtes de l'App Hub.
- Un projet hôte ne peut pas être un projet de service autre que lui-même.
Activer l'API App Hub dans le projet hôte
Ajoutez un ou plusieurs projets de service App Hub au projet hôte.
- Les projets de service dans App Hub sont différents de service VPC partagé et n'ont pas les mêmes exigences. Dans ce document, toutes les références aux projets de service Projets de service App Hub.
Désigner des utilisateurs App Hub comme App Hub Administrateurs, éditeurs App Hub ou App Hub Lecteurs
Créer des applications
Enregistre les services et les charges de travail dans l'application.

Services et charges de travail

Avec App Hub, les ressources des projets de service associés du projet hôte sont disponibles en tant que services et charges de travail. Enregistrement... vos services et charges de travail à une application, vous pouvez observer et surveiller les ressources. Vous pouvez désigner les ressources suivantes services App Hub et les enregistrer dans Applications App Hub:

Règles de transfert
Mappages d'URL
Services de backend

Vous pouvez désigner des groupes d'instances gérés (MIG), mais pas des VM individuelles, car charges de travail et les enregistrer dans les applications App Hub.

App Hub est compatible avec les API régionales et externes de couche 7 Équilibreurs de charge d'application avec trafic HTTP ou HTTPS

Les charges de travail et les services que vous enregistrez doivent se trouver dans la même région que le application; C'est pourquoi les instructions et les commandes qui suivent supposent que tous se trouvent dans la même région. Pour savoir dans quelles régions reportez-vous à la section Emplacements.

Processus de configuration global

La liste suivante récapitule les étapes à suivre pour configurer App Hub :

Déterminez les ressources existantes à inclure dans votre application et les projets auxquels elles appartiennent.
Créez un projet hôte App Hub et activez le API App Hub dans le projet. Éventuellement, en fonction de votre la structure organisationnelle de votre entreprise, créez plusieurs projets hôte. Si vous créez plusieurs projets, nous vous recommandons de les placer dans un nouveau dossier.
Associer les projets de service Après avoir configuré un projet hôte, associez-lui des projets de service avec les ressources sous-jacentes dont vos applications ont besoin. Veuillez noter les points suivants :
1. Les projets de service doivent appartenir à la même organisation que le projet hôte. Une fois que vous avez associé un projet de service à un projet hôte, vous ne pouvez plus le déplacer vers une autre organisation. Pour déplacer le projet de service vers une autre organisation, vous devez suivre les instructions de ce document pour supprimer ou dissocier l'association du projet de service au projet hôte. Vous pouvez ensuite joindre le projet de service vers une autre organisation.
2. Un projet de service ne peut pas être associé à plusieurs projets hôtes.
3. Un projet hôte peut être son propre projet de service, mais il ne peut pas s'agir projet de service pour tout autre projet hôte.
4. Après avoir associé des projets de service à un projet hôte, interroger l'hôte pour les services ou charges de travail renvoie automatiquement tous les services et charges de travail dans tous les projets de service.
Créez une application pour organiser plusieurs charges de travail et services. Veuillez noter les points suivants :
1. Assurez-vous que le nom de l'application est unique dans le projet hôte et l'emplacement.
2. Un projet de service peut être associé à un projet hôte avec plusieurs applications, mais ses ressources individuelles ne peuvent être enregistrées que dans une seule application.
Interroger des services et des charges de travail, et les enregistrer dans votre application Une fois l'application créée, vous interrogez le projet hôte pour obtenir des informations des services et des charges de travail. Les requêtes sont exécutées sur le projet hôte projets de service associés au projet hôte. Ils renvoient également tous et les charges de travail de ces projets. Veuillez noter les points suivants :
1. Vous ne pouvez enregistrer un service ou une charge de travail que dans une seule application.
2. Tous les services et charges de travail que vous enregistrez doivent se trouver dans la même région que l'application.
3. Les services et charges de travail enregistrés ne sont pas affectés par les mises à jour de la ressource d'infrastructure sous-jacente. En d'autres termes, si vous supprimez les ressources sous-jacentes qui servent de services et de charges de travail, App Hub ne supprime pas les charges de travail associées de votre application. Vous devez annuler l'enregistrement du charge de travail ou service.

Prérequis

Avant de configurer App Hub, effectuez les tâches suivantes.

Décidez du projet existant comme projet hôte ou créez-en un pour le projet hôte. Nous vous recommandons vivement de créer un projet.
Assurez-vous d'avoir choisi les personnes détenant Identity and Access Management (IAM) pour App Hub: administrateur App Hub, éditeur App Hub et lecteur App Hub.

Veuillez noter les points suivants :

Les projets hôtes peuvent être associés à un ou plusieurs projets de service.
Un projet de service ne peut pas être associé à plusieurs projets hôte.
La personne qui associe un projet de service à un projet hôte doit disposer Rôle IAM "Administrateur App Hub" dans le service et le projet hôte. Pour en savoir plus, consultez la section Rôles et autorisations dans App Hub.

Configurer App Hub

Dans cette section, vous allez créer un exemple d'architecture App Hub.

Dans cet exemple, une organisation dispose de trois projets de service, avec leur ressources d'infrastructure déployées dans les projets, comme suit:

Le projet de service 1 dispose de deux ressources d'infrastructure : le service 1 et le service 2.
Le projet de service 2 dispose de trois ressources d'infrastructure : le service 3, la charge de travail 1, et "Charge de travail 2".
Le projet de service 3 comporte trois ressources d'infrastructure : le service 4, la charge de travail 3 et la charge de travail 4.

Assurez-vous que les projets que vous choisissez pour créer l'exemple contiennent les ressources décrites dans cette section, ou soyez prêt à ajuster l'exemple au fur et à mesure que vous suivez les instructions.

Les sections suivantes contiennent les instructions pour créer un exemple de hub d'applications. Vous créez un projet hôte et ajoutez des services au projet hôte, puis créer une application et lui associer des services les charges de travail à l'application. Cet exemple comporte trois projets de service, pouvez en ajouter moins ou plus.

Cet exemple suppose que tous les projets de service que vous ajoutez existent déjà et qu'ils des services et des charges de travail que vous ajoutez à l'application. Avant de commencer créer l'exemple, déterminer quels projets de service contiennent les services et que vous voulez inclure dans l'application.

Activer App Hub

Dans cette section, vous allez sélectionner ou créer un projet hôte, activer le API App Hub, et accordez les rôles et les autorisations appropriés aux personnes de votre organisation. Vous associez également des projets de service à l'hôte projet.

Console

Dans Google Cloud Console, accédez à la page de sélection du projet.

Accéder au sélecteur de projet
Sélectionnez ou créez un projet Google Cloud. comme projet hôte App Hub.
Enable the required API.
Enable the API

Si vous êtes le créateur du projet, le rôle rôle de base "Owner" (Propriétaire) (roles/owner). Par défaut, cette stratégie IAM (Identity and Access Management) inclut les autorisations nécessaires pour bénéficier d'un accès complet à la plupart aux ressources Google Cloud.

Si vous n'êtes pas le créateur du projet, vous devez accorder les autorisations requises au compte principal approprié. Par exemple, un compte principal peut être un compte Google (pour les utilisateurs finaux) ou un compte de service (pour les applications et les charges de travail de calcul). Pour obtenir les autorisations nécessaires pour suivre ce tutoriel, demandez à votre administrateur de vous attribuer les rôles IAM suivants sur votre projet:
1. Dans la console Google Cloud, accédez à la page IAM.
  
  Accéder à IAM
2. Cliquez sur Accorder l'accès. Le volet Accorder l'accès s'affiche.
3. Dans le champ Nouveaux comptes principaux, saisissez l'adresse e-mail du personne chargée d'administrer App Hub, le rôle d'administrateur App Hub dans le projet hôte.
4. Cliquez sur Sélectionner un rôle et, dans le champ Filtre, saisissez App Hub :
5. Sélectionnez le rôle "Administrateur App Hub", puis cliquez sur Enregistrer.
6. Dans chacun des projets de service App Hub, attribuez le rôle Administrateur App Hub au même utilisateur.
Dans la console Google Cloud, accédez à la page Paramètres d'App Hub. .

Accéder aux paramètres
Sur la page Paramètres, cliquez sur Associer des projets.
Effectuez l'une des opérations suivantes :
- Dans la liste des projets, cochez les cases correspondant aux projets pour lesquels que vous voulez ajouter en tant que projets de service.
- Recherchez des projets, puis sélectionnez ceux à ajouter en tant que projets de service.
Cliquez sur Sélectionner. Le tableau Projet(s) de service associé(s) affiche le service sélectionné projets.
Cliquez sur Fermer.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Assurez-vous que la version la plus récente de la Google Cloud CLI est installée. Exécuter la commande suivante à partir de Cloud Shell:
```
gcloud components update
```
créer ou sélectionner un projet ; HOST_PROJECT_ID, en tant que projet hôte pour App Hub.
- Créez un projet Google Cloud :
```
gcloud projects create HOST_PROJECT_ID
```
- Sélectionnez le projet Google Cloud que vous avez créé :
```
gcloud config set project HOST_PROJECT_ID
```

Activer l'API App Hub dans le projet hôte que vous venez de créer créé.

gcloud services enable apphub.googleapis.com \
    --project=HOST_PROJECT_ID

Si vous êtes le créateur du projet, le rôle rôle de base "Owner" (Propriétaire) (roles/owner). Par défaut, cette stratégie IAM (Identity and Access Management) inclut les autorisations nécessaires pour bénéficier d'un accès complet à la plupart aux ressources Google Cloud.

Si vous n'êtes pas le créateur du projet, les autorisations requises doivent être accordées au compte principal approprié sur le projet. Par exemple, un compte principal peut être un compte Google (pour les utilisateurs finaux) ou un compte de service (pour les applications et les charges de travail de calcul). Pour obtenir les autorisations nécessaires pour suivre ce tutoriel, demandez à votre administrateur de vous attribuer les rôles IAM suivants sur votre projet:
1. Vous pouvez aussi accorder aux personnes qui administreront App Hub, l'App Hub d'administrateur dans le projet hôte. Répétez la commande suivante pour chaque administrateur.
```
gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'
```
  Remplacez HOST_PROJECT_ADMIN par l'utilisateur qui dispose du rôle "Administrateur App Hub" dans le projet hôte. Ce au format username@yourdomain. Exemple : robert.smith@example.com
2. Attribuez le rôle d'administrateur App Hub dans les projets de service au personnes qui administrent App Hub. Ils doivent disposer Rôle d'administrateur App Hub permettant d'ajouter des projets de service à l'hôte projet. Vous devez disposer d'au moins une personne disposant de ce rôle pour chaque projet de service. Une seule personne peut occuper ce rôle dans plusieurs projets de service.
```
gcloud projects add-iam-policy-binding SERVICE_PROJECT_1 \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'
```
```
gcloud projects add-iam-policy-binding SERVICE_PROJECT_2 \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'
```
```
gcloud projects add-iam-policy-binding SERVICE_PROJECT_3 \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'
```
  Remplacez les éléments suivants :
  - SERVICE_PROJECT_1: premier sur trois projets de service dans cet exemple.
  - SERVICE_PROJECT_2: deuxième sur trois projets de service dans cet exemple.
  - SERVICE_PROJECT_3: troisième sur trois projets de service dans cet exemple.

Ajoutez vos projets de service au projet hôte App Hub.

gcloud apphub service-projects add SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID

gcloud apphub service-projects add SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID

gcloud apphub service-projects add SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

Créer une application

Si ce n'est pas déjà fait, créez une application qui servira de conteneur des services et des charges de travail.

Console

Assurez-vous que vous vous trouvez dans le projet hôte.
Dans la console Google Cloud, accédez à la page Applications d'App Hub.

Accéder à la page Applications
Cliquez sur Créer une application.
Sur la page Créer une application, dans la section Choisir la région de l'application et nom, sélectionnez une Région.
Saisissez le nom de l'application, puis cliquez sur Continuer.
Si vous le souhaitez, ajoutez d'autres informations sur l'application dans les champs. qui vont suivre. Pour en savoir plus, consultez la section Mettre à jour une application App Hub existante de ce document.
Cliquez sur Créer.

gcloud

Créez une application appelée APPLICATION_NAME et lui attribuer un nom à afficher, APPLICATION_DISPLAY_NAME L'option --scope-type définit les services et charges de travail peuvent être enregistrées dans une application. Seul REGIONAL est accepté, ce qui signifie que seuls les services et charges de travail situés dans la même région application peut être enregistrée.
```
gcloud apphub applications create APPLICATION_NAME \
  --scope-type=REGIONAL \
  --project=HOST_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 les espaces.
- REGION : région de l'application. Attribuer la valeur us-east1.

Répertoriez les applications de votre projet hôte.

gcloud apphub applications list \
  --project=HOST_PROJECT_ID \
  --location=REGION

Le résultat ressemble à ce qui suit :

ID: APPLICATION_NAME
DISPLAY_NAME: APPLICATION_DISPLAY_NAME
CREATE_TIME: 2023-10-31T18:33:48

Obtenez des informations sur l'application que vous avez créée.

gcloud apphub applications describe APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

La commande renvoie des informations au format YAML, semblables à ce qui suit.

createTime: '2023-10-31T18:33:48.199394108Z'
displayName: APPLICATION_DISPLAY_NAME
name: projects/HOST_PROJECT_ID/locations/REGION/applications/APPLICATION_NAME
scope:
  type: REGIONAL
state: ACTIVE
uid: [APPLICATION_UID]
updateTime: '2023-10-31T18:33:48.343303819Z'

Mettre à jour une application App Hub existante

Vous pouvez également mettre à jour les attributs de votre application une fois qu'elle a été créé.

Console

Dans la console Google Cloud, accédez à la page Applications d'App Hub.

Accéder à la page Applications
Dans la liste des applications, cliquez sur . Cliquez sur Modifier pour l'application à mettre à jour.
Modifiez les champs selon vos besoins, puis cliquez sur Enregistrer.
Facultatif: Dans la liste Critique, pour indiquer l'importance de la sélectionnez l'une des options suivantes:
- Mission essentielle
- Élevé
- Moyenne
- Faible
Facultatif : dans la liste Environnement, pour indiquer l'étape du cycle de vie du logiciel, sélectionnez l'une des options suivantes :
- Production
- Préproduction
- Développement
- Tester
Facultatif: Ajoutez les informations suivantes pour les propriétaires développeurs. Propriétaires d'opérateurs et Propriétaires d'établissements Notez que vous devez saisir l'adresse e-mail du propriétaire si vous ajoutez un nom à afficher.
1. Saisissez le nom à afficher d'un propriétaire.
2. Saisissez l'adresse e-mail du propriétaire. Cette valeur doit comporter au format username@yourdomain (par exemple, 222larabrown@gmail.com).
Répétez ces étapes pour chaque développeur, opérateur et propriétaire d'entreprise.
Cliquez sur Enregistrer.

gcloud

Mettez à jour votre application avec les criticality-type, environment-type, et le 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=HOST_PROJECT_ID \
  --location=REGION
```
Remplacez les éléments suivants :
- APPLICATION_DISPLAY_NAME : nom à afficher de votre application.
- CRITICALITY_LEVEL: indique le degré d'importance application, service ou charge de travail concerne vos activités commerciales. Indiquez l'une des valeurs suivantes:
  - MISSION_CRITICAL
  - HIGH
  - MEDIUM
  - LOW
- ENVIRONMENT: indique les étapes du cycle de vie des logiciels. Indiquez l'une des valeurs suivantes:
  - PRODUCTION
  - STAGING
  - DEVELOPMENT
  - TEST
- DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR DISPLAY-NAME-BUSINESS: noms à afficher du le développeur, l'opérateur et les propriétaires d'établissement, respectivement.
- EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR EMAIL-NAME-BUSINESS: adresses e-mail des le développeur, l'opérateur et les propriétaires d'établissement, respectivement. Ces valeurs doivent être au format username@yourdomain (par exemple, 222larabrown@gmail.com).

Listez les applications pour lesquelles l'attribut environment-type a le la valeur PRODUCTION.

gcloud apphub applications list \
    --filter='attributes.environment.type=PRODUCTION' \
    --project=HOST_PROJECT_ID \
    --location=REGION

Le résultat ressemble à ce qui suit :

ID: APPLICATION_NAME
DISPLAY_NAME: APPLICATION_DISPLAY_NAME
CREATE_TIME: 2023-10-31T18:33:48

Enregistrer des services et des charges de travail

Lorsque vous enregistrez des services d'infrastructure et des charges de travail dans une application, ils sont enregistrés en tant que ressources App Hub. Si vous utilisez les espaces réservés pour créer l'application gcloud CLI, les services et les charges de travail des trois projets de service sont les suivantes:

Le projet de service 1 dispose de deux ressources d'infrastructure : le service 1 et le service 2.
Le projet de service 2 dispose de trois ressources d'infrastructure : le service 3, la charge de travail 1, et "Charge de travail 2".
Le projet de service 3 dispose de trois ressources d'infrastructure : le service 4, la charge de travail 3, et "Charge de travail 4".

Console

Dans la console Google Cloud, accédez à la page Applications de l'App Hub.

Accéder à la page Applications
Cliquez sur le nom de votre application. L'onglet Services et charges de travail qui s'affiche contient la liste des et les charges de travail figurant dans vos projets de service.
Pour chaque service ou charge de travail que vous souhaitez enregistrer, procédez comme suit:
1. Dans l'onglet Services et charges de travail, cliquez sur Enregistrez un service ou une charge de travail.
2. Sur la page Enregistrer un service ou une charge de travail, dans le fichier Dans le volet Sélectionner une ressource, cliquez sur Parcourir pour sélectionner le service ou charge de travail en tant que ressource.
3. Dans le volet Sélectionner une ressource, choisissez un service ou une charge de travail, puis cliquez sur Sélectionner.
4. Dans le volet Sélectionner une ressource, saisissez un nom pour le service ou charge de travail, puis cliquez sur Continuer.
5. Dans le volet Ajouter des attributs, vous pouvez ajouter des détails pour le paramètre service ou charge de travail dans les champs suivants. Pour plus d'informations, dans ce document, consultez Mettre à jour une application App Hub Notez que vous pouvez sélectionner des valeurs pour Criticité et des champs Environment différents des valeurs que vous définissez lorsque vous créez l'application.
6. Cliquez sur Continuer.
7. Dans la section Ajouter des propriétaires, vous pouvez ajouter d'autres détails concernant les propriétaires du service ou de la charge de travail dans les champs suivants. Pour en savoir plus, consultez la section Mettre à jour une application App Hub existante de ce document.
8. Cliquez sur S'inscrire.

L'onglet Services et charges de travail affiche le service ou charge de travail spécifique. Pour en savoir plus sur les états d'enregistrement, consultez la les propriétés et les attributs d'App Hub.

gcloud

Ajoutez une personne disposant des autorisations d'éditeur App Hub.
```
gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
  --member='user:APP_HUB_EDITOR' \
  --role='roles/apphub.editor'
```
Remplacez APP_HUB_EDITOR par l'utilisateur disposant du Rôle d'éditeur App Hub dans le projet hôte. Cette valeur a la valeur au format username@yourdomain (par exemple, robert.smith@example.com).

Répertorier les charges de travail détectées du projet de service 2, qui est associé au le projet hôte. Cette commande renvoie les charges de travail enregistré dans une application.

gcloud apphub discovered-workloads list \
  --filter='workload_properties.gcp_project=projects/SERVICE_PROJECT_2' \
  --project=HOST_PROJECT_ID \
  --location=REGION

Le résultat ressemble à ce qui suit, avec des MIG non enregistrés:

ID: [DISCOVERED_WORKLOAD_ID_1]
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}
WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}

ID: [DISCOVERED_WORKLOAD_ID_2]
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}
WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}

Copiez l'ID de la charge de travail du résultat pour l'utiliser dans l'étape suivante.

Enregistrez une charge de travail de l'étape précédente dans votre application.

gcloud apphub applications workloads create WORKLOAD_NAME \
  --discovered-workload='projects/HOST_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID_2' \
  --display-name='mywebserver-deployment1' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

Remplacez les éléments suivants :

WORKLOAD_NAME: nom pour enregistrer le charge de travail.
DISCOVERED_WORKLOAD_ID_2: ID de la charge de travail de le résultat de l'étape précédente.

Répétez les deux étapes précédentes pour filtrer et enregistrer les charges de travail souhaitées à partir du projet de service 3.

Facultatif : vous pouvez mettre à jour les charges de travail avec les attributs criticality-type, environment-type et owner.

gcloud apphub applications workloads update WORKLOAD_NAME \
  --application=APPLICATION_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=HOST_PROJECT_ID \
  --location=REGION

Notez que vous devez fournir l'une des valeurs spécifiées pour criticality-type et environment-type, mais la valeur peut être différente de celles que vous définissez lorsque vous créez l'application.

Répertorier les charges de travail enregistrées dans l'application.

gcloud apphub applications workloads list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

Le résultat ressemble à ce qui suit :

ID: WORKLOAD_NAME
DISPLAY_NAME: mywebserver-deployment1
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}
CREATE_TIME: 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.

Répertorier les services détectés avec des règles de transfert dans le projet de service 1 associé au projet hôte. Cette commande renvoie les services peuvent être enregistrées dans une application.

gcloud apphub discovered-services list \
  --filter='service_properties.gcp_project=projects/SERVICE_PROJECT_1 AND service_reference.uri~"forwardingRules"' \
  --project=HOST_PROJECT_ID \
  --location=REGION

Le résultat ressemble à ce qui suit :

ID: [DISCOVERED_SERVICE_ID_1]
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

ID: [DISCOVERED_SERVICE_ID_2]
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

Copiez l'ID de service DISCOVERED_SERVICE_ID_2 indiqué dans la sortie pour l'utiliser dans l'étape suivante.

Enregistrer la règle de transfert testing-forwarding-rule-2 dans le service le projet 1 en tant que service.

gcloud apphub applications services create SERVICE_NAME \
  --discovered-service='projects/HOST_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE_ID_2' \
  --display-name='mywebserver-service1' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

Remplacez les éléments suivants :

SERVICE_NAME : nom sous lequel enregistrer le service.
DISCOVERED_SERVICE_ID_2: ID de service de le résultat de l'étape précédente.

Répétez les étapes précédentes pour lister les services, les filtrer et enregistrer les services dans les projets de service 1, 2 et 3.

Mettez à jour un service avec les attributs criticality-type et environment-type.

gcloud apphub applications services update SERVICE_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID  \
  --location=REGION

Listez les services enregistrés dans APPLICATION_NAME application et HOST_PROJECT_ID de votre projet hôte.

gcloud apphub applications services list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

Le résultat ressemble à ce qui suit pour chaque service:

ID: SERVICE_NAME
DISPLAY_NAME: mywebserver-service1
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}
CREATE_TIME: 2023-11-01T21:38:08

Les services enregistrés, mais dissociés, sont indiqués par une valeur vide dans le champ SERVICE_REFERENCE.

Filtrez les services dans APPLICATION_NAME application et HOST_PROJECT_ID projet hôte sur ceux où l'attribut environment-type est défini sur PRODUCTION

gcloud apphub applications services list \
  --filter='attributes.environment.type=PRODUCTION' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

Le processus de configuration d'App Hub est terminé.

Ajouter ou supprimer des projets de service

Vous pouvez modifier les rattachements de projets de service pour créer des infrastructures ressources pouvant être regroupées dans une application.

Console

Pour ajouter un projet de service à un projet hôte, procédez comme suit:

Dans la console Google Cloud, accédez à la page Paramètres d'App Hub.

Accéder aux paramètres
Sur la page Paramètres, cliquez sur Associer des projets.
Dans le volet qui s'affiche, recherchez des projets dans la liste affichée, puis cochez les cases correspondant aux projets que vous souhaitez ajouter en tant que service projets.
Cliquez sur Sélectionner. Le tableau Projets de service associés affiche les projets sélectionnés comme projets de service du projet hôte.
Cliquez sur Fermer.

Pour supprimer un projet de service d'un projet hôte:

Dans la console Google Cloud, accédez à la page Paramètres d'App Hub.

Accéder aux paramètres
Sur la page Paramètres, cochez les cases des projets de votre choix. les supprimer en tant que projets de service.
Cliquez sur Dissocier des projets. Le tableau Projet(s) de service associé(s) s'actualise pour n'afficher que les projets qui restent associés au projet hôte.

gcloud

Pour ajouter un projet de service à un projet hôte, procédez comme suit:

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Remplacez SERVICE_PROJECT_ID par le nom du projet de service que vous souhaitez ajouter au projet hôte. Pour supprimer un projet de service du projet hôte:

gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Afficher les applications, services et charges de travail existants

Vous pouvez afficher les applications d'un projet, et répertorier les services et les charges de travail dans un application.

Console

Pour afficher les applications d'un projet, dans la console Google Cloud, accédez à la Page Applications d'App Hub

Accéder à la page Applications
Pour répertorier les services et les charges de travail:
Applications
1. Dans la console Google Cloud, accédez à la page Applications d'App Hub.
  Accéder à la page Applications
2. Cliquez sur le nom d'une application. Une page contenant la liste des services et des charges de travail enregistrés dans votre s'affiche.
3. Facultatif: Pour filtrer les services ou les charges de travail:
  1. Dans le champ Filtre, sélectionnez un filtre tel que Critique.
  2. Sélectionnez Élevé comme valeur.
    Une liste de services et de charges de travail à haute criticité enregistré dans l'application apparaît.
Services et charges de travail
1. Dans la console Google Cloud, accédez à App Hub. Services et charges de travail.
  Accéder à la page "Services et charges de travail"
2. Dans la liste Région, sélectionnez les régions dans lesquelles vous souhaitez d'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 des projets de service associés et associés us-east1
3. Facultatif : Pour filtrer les services ou les charges de travail :
  1. Dans le champ Filtre, sélectionnez un filtre (par exemple, Environnement).
  2. Sélectionnez la valeur Production.
    Une liste des services et des charges de travail dans l'environnement de production qui est enregistré dans une application, s'affiche.

gcloud

Pour afficher les applications d'un projet:

gcloud apphub applications list \
    --project=HOST_PROJECT_ID \
    --location=REGION

Pour répertorier les services enregistrés dans une application:

gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION

Pour répertorier les charges de travail enregistrées dans une application:

gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION

Effectuer un nettoyage

Nettoyer une application existante et supprimer un rattachement de projet de service de pour supprimer les ressources associées au projet hôte. Cela interrompt la la découverte automatique des ressources dans le projet de service.

Pour ce faire, vous devez d'abord supprimer les charges de travail et les services enregistrés application.

Console

Dans la console Google Cloud, accédez à Page Applications d'App Hub

Accéder à la page Applications
Cliquez sur le nom d'une application. La liste des services et des charges de travail enregistrés pour l'application s'affiche.
Annuler l'enregistrement d'un service ou d'une charge de travail
1. Dans l'onglet Services et charges de travail, Services et charges de travail enregistrés, cliquez sur le nom du service ou charge de travail dont vous souhaitez annuler l'enregistrement.
2. Dans l'onglet Détails, cliquez sur Annuler l'enregistrement pour mettre à jour le service ou charge de travail en tant que ressource Discovered.
  Dans l'onglet Services et charges de travail, une alerte indique que charge de travail non enregistrée.
3. Répétez ces instructions pour chaque service et charge de travail.
Accédez à la page Applications d'App Hub.

Accéder à la page Applications
Cliquez sur le nom d'une application.
Sur la page contenant les détails de l'application, cliquez sur Supprimer.
Dans ce document, suivez les instructions Ajoutez ou supprimez des projets de service. les projets de service de votre projet hôte.

gcloud

Listez les charges de travail enregistrées dans l'application:

gcloud apphub applications workloads list \
  --application=APPLICATION_NAME --project=HOST_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=HOST_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. depuis l'application.

Listez les services enregistrés dans l'application:

gcloud apphub applications services list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

Annulez l'enregistrement du service dans l'application:
```
gcloud apphub applications services delete SERVICE_NAME \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION
```
Le service est à présent un service détecté qui peut être enregistré auprès du application.
Répétez la commande précédente pour désenregistrer les services enregistrés restants de l'application.

Supprimez l'application:

gcloud apphub applications delete APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

Supprimez un projet de service du projet hôte :

gcloud apphub service-projects remove SERVICE_PROJECT_ID \
  --project=HOST_PROJECT_ID

Répétez la commande précédente pour supprimer tous les projets de service de l'hôte. projet.

Configurer App Hub

Services et charges de travail

Processus de configuration global

Prérequis

Configurer App Hub

Activer App Hub

Console

gcloud

Créer une application

Console

gcloud

Mettre à jour une application App Hub existante

Console

gcloud

Enregistrer des services et des charges de travail

Console

gcloud

Ajouter ou supprimer des projets de service

Console

gcloud

Afficher les applications, services et charges de travail existants

Console

Applications

Services et charges de travail

gcloud

Effectuer un nettoyage

Console

gcloud

Étape suivante