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, 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 du hub d'applications.

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

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 la section Rôles et autorisations dans 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 disposant du rôle Administrateur App Hub dans le projet hôte. Cette valeur a le format username@yourdomain (par exemple, 222larabrown@gmail.com).

2. Accordez le rôle Administrateur du hub d'applications dans le projet de service aux personnes qui administrent le hub d'applications. Il doit disposer du rôle Administrateur du hub d'applications pour ajouter des projets de service au projet hôte. Vous devez disposer d'au moins une personne disposant de ce rôle pour chaque projet de service. Dans cet exemple, le projet hôte joue le rôle 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. Accordez le rôle "Lecteur de surveillance" dans le projet hôte aux personnes qui administrent App Hub. Pour afficher les métriques, il doit disposer du rôle "Lecteur de surveillance" sur 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 de l'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 des projets dans la liste affichée et cochez les cases pour les projets de service App Hub.

4. Cliquez sur Sélectionner. Le tableau Projets de service associés affiche le projet hôte sélectionné comme projet de service.

5. Cliquez sur Fermer.

gcloud

Ajoutez votre projet hôte en tant que projet de service au projet hôte de l'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 de l'App Hub.

2. Dans la console Google Cloud, accédez à la page Applications de l'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égional.

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 est immuable une fois l'application créée.

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

8. Dans le volet Ajouter des attributs, dans la liste Criticité, sélectionnez Élevée. La criticité indique dans quelle mesure une application, un service ou une charge de travail est critique 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 du développeur, les propriétaires de l'opérateur et les propriétaires de l'établissement. 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 avoir le format username@yourdomain, par exemple 222larabrown@gmail.com.

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

13. Cliquez sur Créer.

La nouvelle application est créée et apparaît sur la page Applications.

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 appelé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é une fois l'application créée. Le nom à afficher,Tutorial, est un nom convivial que vous pouvez modifier. Pour en savoir plus, consultez la section 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 de 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 d'établissements, 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 d'établissements, respectivement. Ces valeurs doivent avoir le format username@yourdomain, par exemple 222larabrown@gmail.com.

   Remarques :

   • criticality-type: indique l'importance 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 de l'App Hub.

   Accéder à la page Applications

2. Cliquez sur le nom de votre application, Tutoriel. L'onglet Services et charges de travail s'affiche avec une liste des services et charges de travail enregistrés dans vos projets de service App Hub.

3. Enregistrez 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 suivantes si nécessaire pour les propriétaires du développeur, les propriétaires de l'opérateur et les propriétaires de l'établissement. 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 avoir le format username@yourdomain, par exemple 222larabrown@gmail.com.
   10. Répétez ces étapes pour chaque développeur, opérateur et propriétaire d'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, avec les exceptions suivantes:

   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 de l'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 "Éditeur App Hub" dans le projet hôte App Hub. Cette valeur a le format username@yourdomain (par exemple, 222larabrown@gmail.com).

2. Répertoriez tous les services détectés dans le projet hôte de l'App Hub. Cette commande renvoie les services pouvant ê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 du service, par exemple BACKEND_SERVICE_SP2_ID, à partir de la sortie 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 dissocié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 attributs d'App Hub.

5. Répertoriez toutes les charges de travail détectées dans le projet hôte de l'App Hub. Cette commande renvoie les charges de travail pouvant ê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 la charge de travail à partir de la sortie pour l'utiliser à l'étape suivante.

6. Enregistrez la charge de travail de l'étape précédente dans votre application en tant que tutorial-workload-mig. Copiez l'ID de la 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 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.