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

Console

Pour obtenir les autorisations nécessaires pour suivre ce tutoriel, demandez à votre administrateur de vous accorder les rôles IAM requis 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 de la personne qui administrera App Hub, c'est-à-dire le rôle Administrateur App Hub dans le projet hôte.

4. Cliquez sur Sélectionner un rôle, puis saisissez App Hub dans le champ Filtre.

5. Sélectionnez le rôle Administrateur App Hub.

6. Cliquez sur Ajouter un autre rôle, puis sélectionnez Lecteur Monitoring dans la liste Sélectionner un rôle.

7. Cliquez sur Enregistrer.

gcloud

1. Pour attribuer les rôles aux personnes qui utiliseront le hub d'applications, répétez la commande suivante en remplaçant les rôles IAM, si nécessaire. Pour en savoir plus, consultez Rôles et autorisations App Hub.

   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 d'administrateur App Hub dans le projet hôte. Cette valeur est au format username@yourdomain (par exemple, 222larabrown@gmail.com).

2. Attribuez le rôle "Administrateur App Hub" dans le projet de service aux personnes qui administrent App Hub. Ils doivent disposer du rôle "Administrateur App Hub" pour ajouter des projets de service au projet hôte. Vous avez besoin d'au moins une personne disposant de ce rôle pour chaque projet de service. 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.

3. Attribuez le rôle Lecteur Monitoring dans le projet hôte aux personnes qui administrent App Hub. Pour afficher les métriques, ils doivent disposer du rôle Lecteur Monitoring dans le projet hôte.

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

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'ouvre, recherchez les projets dans la liste affichée et cochez les cases correspondant aux projets de service App Hub.

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

5. Cliquez sur Fermer.

gcloud

Ajoutez votre projet hôte en tant que projet de service au projet hôte App Hub.

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

Console

1. Assurez-vous d'être dans le projet hôte App Hub.

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 le volet Choisir la région et le nom de l'application, sélectionnez Régionale.

5. Dans la liste Région, sélectionnez us-west1.

6. Dans le champ Nom de l'application, saisissez tutorial-application. Ce nom est un identifiant unique et ne peut pas être modifié après la création de l'application.

7. Saisissez un nom à afficher, Tutorial, puis cliquez sur Continuer. Il s'agit d'un nom descriptif que vous pouvez modifier. Pour en savoir plus, consultez Mettre à jour une application existante.

8. Dans le volet Ajouter des attributs, sélectionnez Élevée dans la liste Criticité. La criticité indique l'importance d'une application, d'un service ou d'une charge de travail pour vos opérations commerciales.

9. Dans le champ Environnement, sélectionnez Production pour indiquer l'étape du cycle de vie du logiciel.

10. Cliquez sur Continuer.

11. Dans le volet Ajouter des propriétaires, ajoutez les informations suivantes pour les propriétaires développeurs, les propriétaires opérateurs et les propriétaires d'entreprise. 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 être au format username@yourdomain, par exemple 222larabrown@gmail.com.

12. Répétez ces étapes pour chaque développeur, opérateur et propriétaire de l'entreprise.

13. Cliquez sur Créer.

La nouvelle application est créée et listée sur la page Applications. Notez que seuls la règle de transfert, le mappage d'URL, le service de backend et le groupe d'instances géré (MIG) deviennent disponibles en tant que ressources découvertes dans l'application App Hub. Pour en savoir plus, consultez les concepts et le modèle de données.

gcloud

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

   gcloud config set project HOST_PROJECT_ID

2. Créez une application nommée tutorial-application dans la région us-west1 et attribuez-lui un nom à afficher, Tutorial. Ce nom d'application,tutorial-application, est un identifiant unique et ne peut pas être modifié après la création de l'application. Le nom à afficher,Tutorial est un nom convivial que vous pouvez modifier. Pour en savoir plus, consultez Mettre à jour une application existante.

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

3. Répertoriez les applications dans votre projet hôte App Hub :

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

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

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

4. Mettez à jour votre application avec les attributs criticality-type, environment-type et owner :

   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 et DISPLAY-NAME-BUSINESS : noms à afficher du développeur, de l'opérateur et des propriétaires de l'entreprise, respectivement.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR et EMAIL-NAME-BUSINESS : adresses e-mail du développeur, de l'opérateur et des propriétaires de l'entreprise, respectivement. Ces valeurs doivent respecter le format username@yourdomain (par exemple, 222larabrown@gmail.com).

   Remarques :

   • criticality-type : indique le degré de criticité d'une application, d'un service ou d'une charge de travail pour vos opérations commerciales.
   • environment-type : indique les étapes du cycle de vie du logiciel.

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 à ce qui suit :

   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, Tutorial. L'onglet Services et charges de travail affiche la liste des services et charges de travail enregistrés dans vos projets de service App Hub.

3. Enregistrer un service :

   1. Dans l'onglet Services et charges de travail, cliquez sur Enregistrer un service/une charge de travail.
   2. Sur la page Enregistrer un service ou une charge de travail, dans le volet Sélectionner une ressource, cliquez sur Parcourir pour sélectionner le service ou la charge de travail en tant que Ressource.
   3. Dans le volet Sélectionner une ressource, choisissez le Nom du service, l7-xlb-backend-service, puis cliquez sur Sélectionner.
   4. Dans le volet Sélectionner une ressource, saisissez le nom de la ressource, tutorial-service-backend.
   5. Saisissez un nom à afficher, Backend service, puis cliquez sur Continuer.
   6. Dans le volet Ajouter des attributs, dans la liste Criticité, sélectionnez Élevée pour indiquer l'importance de l'application.
   7. Dans le champ Environnement, sélectionnez Production pour indiquer l'étape du cycle de vie du logiciel.
   8. Cliquez sur Continuer.
   9. Dans le volet Ajouter des propriétaires, ajoutez les informations requises pour les propriétaires développeurs, les propriétaires opérateurs et les propriétaires d'entreprise. 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 être au format username@yourdomain, par exemple 222larabrown@gmail.com.
   10. Répétez ces étapes pour chaque développeur, opérateur et propriétaire de l'entreprise.
   11. Cliquez sur S'inscrire.

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

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

5. Enregistrez une charge de travail en répétant les étapes précédentes pour enregistrer un service, à l'exception des points suivants :

   1. Dans le volet Enregistrer un service ou une charge de travail, dans la section Choisir un service ou une charge de travail, sélectionnez le nom de la charge de travail, l7-xlb-backend-example, puis cliquez sur Continuer.
   2. Dans le volet Sélectionner une ressource, saisissez le nom de la ressource, tutorial-workload-mig.
   3. Saisissez un nom à afficher, Workload instance group, puis cliquez sur Continuer. Dans l'onglet Services et charges de travail, dans la section Services et charges de travail enregistrés, vous pouvez voir la nouvelle 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 qui dispose du rôle d'éditeur App Hub dans le projet hôte App Hub. Cette valeur est au format username@yourdomain (par exemple, 222larabrown@gmail.com).

2. Répertoriez tous les services découverts dans le projet hôte App Hub. Cette commande renvoie les services 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                             SERVICE_REFERENCE                                                                                                              SERVICE_PROPERTIES
   BACKEND_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   FORWARDING_RULE_SERVICE_ID" {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   URL_MAP_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}             {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   

   Copiez les ID de service (par exemple, BACKEND_SERVICE_SP2_ID) à partir du résultat pour les utiliser à l'étape suivante.

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

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

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

   gcloud apphub applications services create tutorial-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 : service ID du service de backend que vous souhaitez enregistrer.
   • FORWARDING_RULE_SERVICE_ID : service ID de la règle de transfert que vous souhaitez enregistrer.
   • URL_MAP_SERVICE_ID : service ID du mappage d'URL que vous souhaitez enregistrer.

4. Répertoriez 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                               DISPLAY_NAME      SERVICE_REFERENCE                                                                                                              CREATE_TIME
   tutorial-service-backend         Backend service   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}  2024-02-13T00:31:45
   tutorial-service-forwarding-rule Forwarding rule   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}  2024-02-13T00:31:45
   tutorial-service-url-map         URL map           {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}             2024-02-13T00:31:45
   

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

5. Répertoriez toutes les charges de travail découvertes dans le projet hôte App Hub. Cette commande renvoie les charges de travail qui peuvent être enregistrées dans une application.

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

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

   ID                            WORKLOAD_REFERENCE                                                                                                            WORKLOAD_PROPERTIES
   INSTANCE_GROUP_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1', 'zone': 'us-west1-a'}
   

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

6. Enregistrez les charges de travail de l'étape précédente dans votre application. Copiez l'ID de charge de travail à partir du champ de sortie de l'étape précédente.

   gcloud apphub applications workloads create tutorial-workload-mig \
       --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 la 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                        DISPLAY_NAME              WORKLOAD_REFERENCE                                                                                                            CREATE_TIME
   tutorial-workload-mig     Workload instance group   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}  2024-02-13T00:31:45
   

   Les charges de travail enregistrées, mais détaché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 les attributs d'App Hub.