Créer une application App Hub à l'aide d'un seul projet

Console

1. Pour obtenir les autorisations nécessaires pour effectuer cette demandez à votre administrateur de vous accorder les autorisations Rôles IAM sur votre projet:

   1. Dans la console Google Cloud, accédez à la page IAM.

      Accéder à IAM

   2. Cliquez sur person_addAccorder 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 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.

gcloud

1. Pour attribuer les rôles aux personnes chargées d'administrer App Hub, répétez la commande suivante en remplaçant les les rôles IAM requis.

   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 a le rôle d'administrateur App Hub dans le projet hôte. Cette valeur comprend au format username@yourdomain, par exemple : [email protected]

2. Attribuez le rôle d'administrateur App Hub dans le projet 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. Au moins une personne doit disposer de ce rôle pour chaque service projet. Dans cet exemple, le projet hôte fait office de projet de service.

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
      --member='user:HOST_PROJECT_ADMIN' \
      --role='roles/apphub.admin'

   Remplacez SERVICE_PROJECT_ID par le nom du HOST_PROJECT_ID

Console

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

   Accéder aux paramètres

2. Sur la page Paramètres, cliquez sur Associer des projets.

3. Dans le volet qui s'affiche, recherchez des projets dans la liste affichée, puis cochez la case du projet hôte.

4. Cliquez sur Sélectionner. Le tableau Projet(s) de service associé(s) affiche l'hôte sélectionné en tant que projet de service.

5. Cliquez sur Fermer.

gcloud

Ajouter votre projet hôte en tant que projet de service à App Hub de votre projet hôte.

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

Console

1. Assurez-vous que vous vous trouvez dans le projet hôte.

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

   Accéder à la page Applications

3. Cliquez sur Créer une application.

4. Sur la page Créer une application, dans la section Choisir la région de l'application et nom, dans la liste Région, sélectionnez us-west1.

5. Dans le champ Nom de l'application, saisissez tutorial-application.

6. Saisissez un nom dans le champ Display name (Nom à afficher), sample-application, puis cliquez sur Continue (Continuer).

7. Dans le volet Ajouter des attributs, dans la liste Critique, sélectionnez Élevée : La criticité indique le degré d'importance d'une application, d'un service ou charge de travail de votre entreprise.

8. Dans le champ Environnement, pour indiquer l'étape du logiciel sélectionnez Production.

9. Cliquez sur Continuer.

10. Dans le volet Ajouter des propriétaires, ajoutez les informations suivantes : pour les propriétaires de développeurs, les propriétaires d'opérateurs et les propriétaires d'entreprise. Notez que vous devez saisir l'adresse e-mail du propriétaire si vous ajoutez un écran son nom.

    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, [email protected]).

11. Répétez ces étapes pour chaque développeur, opérateur et propriétaire d'établissement.

12. Cliquez sur Créer.

L'application est créée et répertoriée sur la page Applications.

gcloud

1. Sélectionnez le projet hôte que vous avez créé:

   gcloud config set project HOST_PROJECT_ID

2. Créer une application appelée tutorial-application dans la région us-west1et attribuez-lui un nom à afficher, Tutorial:

   gcloud apphub applications create tutorial-application \
       --display-name='Tutorial' \
       --scope-type=REGIONAL \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

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

   gcloud apphub applications list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Vous obtenez un résultat semblable à celui-ci :

   ID: tutorial-application
   DISPLAY_NAME: Tutorial
   CREATE_TIME: 2023-10-31T18:33:48
   

4. Mettez à jour votre application avec les criticality-type, environment-type, et de propriétaire:

   gcloud apphub applications update tutorial-application \
     --criticality-type='HIGH' \
     --environment-type='PRODUCTION' \
     --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=us-west1
   

   Remplacez les éléments suivants :

   • 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 au format username@yourdomain, par exemple : [email protected]

   Remarques :

   • criticality-type: indique le degré d'importance d'une application, ou charge de travail de votre entreprise concerne vos activités commerciales.
   • environment-type: indique les étapes du logiciel tout au long du cycle de vie.

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

   gcloud apphub applications describe tutorial-application \
     --project=HOST_PROJECT_ID \
     --location=us-west1
   

   La commande renvoie des informations au format YAML, semblables à celles-ci:

   attributes:
   businessOwners:
   – displayName: [DISPLAY-NAME-BUSINESS]
     email: [EMAIL-BUSINESS]
   criticality:
     type: HIGH
   developerOwners:
   – displayName: [DISPLAY-NAME-DEVELOPER]
     email: [EMAIL-DEVELOPER]
   environment:
     type: PRODUCTION
   operatorOwners:
   – displayName: [DISPLAY-NAME-OPERATOR]
     email: [EMAIL-OPERATOR]
   createTime: '2023-10-31T18:33:48.199394108Z'
   displayName: Tutorial
   name: projects/HOST_PROJECT_ID/locations/us-west1/applications/tutorial-application
   scope:
     type: REGIONAL
   state: ACTIVE
   uid: 9d991a9d-5d8a-4c0d-b5fd-85e39fb58c73
   updateTime: '2023-10-31T18:33:48.343303819Z'
   

Console

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

   Accéder à la page Applications

2. Cliquez sur le nom de votre application, sample-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.

3. Enregistrez un service:

   1. Dans l'onglet Services et charges de travail, cliquez sur Enregistrez un service ou une charge de travail.
   2. Dans le volet Enregistrer un service ou une charge de travail, dans la section Dans la section Sélectionner un service ou une charge de travail, sélectionnez le nom l7-xlb-backend-service, puis cliquez sur Continuer.
   3. Dans le volet Ajouter des attributs, saisissez le nom de l'attribut. sample-service-backend
   4. Dans le champ Nom à afficher, saisissez service-backend.
   5. Dans la liste Critique, pour indiquer l'importance de la sélectionnez Élevée.
   6. Dans le champ Environnement, pour indiquer l'étape du logiciel sélectionnez Production.
   7. Cliquez sur Continuer.
   8. Dans le volet Ajouter des propriétaires, ajoutez les informations suivantes, si nécessaire pour Propriétaires de développeurs, Propriétaires d'opérateurs et Propriétaires d'entreprises. Notez que vous devez saisir l'adresse e-mail du propriétaire si vous ajoutez un nom à afficher.
      1. Saisissez le nom à afficher du propriétaire.
      2. Saisissez l'adresse e-mail du propriétaire. Cette valeur doit comporter au format username@yourdomain (par exemple, [email protected]).
   9. Répétez ces étapes pour chaque développeur, opérateur et propriétaire d'établissement.
   10. Cliquez sur S'inscrire.

   Dans l'onglet Services et charges de travail, dans la Services et charges de travail enregistrés, vous pouvez voir service ajouté.

4. Répétez les étapes précédentes pour enregistrer les autres services en tant que sample-service-forwarding-rule et sample-service-url-map respectivement.

5. Enregistrez une charge de travail en répétant les étapes précédentes pour enregistrer un service à quelques exceptions près:

   1. Dans le volet Enregistrer un service ou une charge de travail, dans la section Dans la section Sélectionner un service ou une charge de travail, sélectionnez le nom l7-xlb-backend-example. Cliquez ensuite sur Continuer.
   2. Dans le volet Ajouter des attributs, saisissez le nom de l'attribut. sample-workload
   3. Dans le champ Nom à afficher, saisissez workload-instance-group.

   Dans l'onglet Services et charges de travail, dans la Services et charges de travail enregistrés, vous pouvez voir charge de travail ajoutée.

gcloud

1. 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, [email protected]).

2. Répertoriez tous les services détectés dans le projet hôte. Cette commande renvoie qui peuvent être enregistrés dans une application.

   gcloud apphub discovered-services list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Vous obtenez un résultat semblable à celui-ci :

   ID: 71dd6fa4-5644-43ee-918f-c5fda03ffe24
   SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}
   SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   
   ID: fe831ba4-ec16-4eb8-9ea4-b394fd30f561
   SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}
   SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   
   ID: 637a3216-c6cc-410e-8bf9-83b7ef66a62f
   SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}
   SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   

   Copiez le service ID (par exemple, 71dd6fa4-5644-43ee-918f-c5fda03ffe24). de la sortie pour l'utiliser à l'étape suivante.

3. Enregistrez les services de l'étape précédente dans votre application. Copier les ID de service du champ de sortie à l'étape précédente.

   gcloud apphub applications services create sample-service-backend \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/BACKEND_SERVICE_ID' \
       --display-name='service-backend' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   gcloud apphub applications services create sample-service-forwarding-rule \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/FORWARDING_RULE_SERVICE_ID' \
       --display-name='service-forwarding-rule' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   gcloud apphub applications services create sample-service-url-map \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/URL_MAP_SERVICE_ID' \
       --display-name='url-map' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Remplacez les éléments suivants :

   • BACKEND_SERVICE_ID: le ID de service du de service de backend que vous souhaitez enregistrer.
   • FORWARDING_RULE_SERVICE_ID: le service ID de la règle de transfert que vous souhaitez enregistrer.
   • URL_MAP_SERVICE_ID: le ID de service de l'URL carte que vous souhaitez enregistrer.

4. Répertorier tous les services enregistrés dans l'application.

   gcloud apphub applications services list \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Vous obtenez un résultat semblable à celui-ci :

   ID: sample-service-backend
   DISPLAY_NAME: service-backend
   SERVICE_REFERENCE:  {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}
   CREATE_TIME: 2024-02-13T00:31:45
   
   ID: sample-service-forwarding-rule
   DISPLAY_NAME: service-forwarding-rule
   SERVICE_REFERENCE:  {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}
   CREATE_TIME: 2024-02-13T00:31:45
   
   ID: sample-service-url-map
   DISPLAY_NAME: url-map
   SERVICE_REFERENCE:  {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}
   CREATE_TIME: 2024-02-13T00:31:45
   

   Les services enregistrés, mais dissociés, sont indiqués par une valeur vide dans le champ SERVICE_REFERENCE. Pour en savoir plus sur les d'inscription, consultez les les propriétés et les attributs d'App Hub.

5. Répertoriez toutes les charges de travail détectées dans le projet hôte. Cette commande renvoie charges de travail disponibles pour l'enregistrement auprès d'une application.

   gcloud apphub discovered-workloads list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Vous obtenez un résultat semblable à celui-ci :

   ID: c9c08669-0fd2-4f7c-b2b1-2cf3c57662c2
   WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}
   WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1', 'zone': 'us-west1-a'}
   

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

6. Enregistrer la charge de travail de l'étape précédente dans votre application en tant que sample-workload. Copiez l'ID de la charge de travail à partir du de sortie à l'étape précédente.

   gcloud apphub applications workloads create sample-workload \
       --discovered-workload='projects/HOST_PROJECT_ID/locations/us-west1/discoveredWorkloads/WORKLOAD_ID' \
       --display-name='workload-instance-group' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Remplacez WORKLOAD_ID par l'ID de charge de travail que vous souhaitez enregistrer.

7. Répertoriez toutes les charges de travail enregistrées dans l'application.

   gcloud apphub applications workloads list \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Vous obtenez un résultat semblable à celui-ci :

   ID: sample-workload
   DISPLAY_NAME: workload-instance-group
   WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}
   CREATE_TIME: 2024-02-13T00:31:45
   

   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 d'inscription, consultez les les propriétés et les attributs d'App Hub.