App Hub-Anwendung mit einem einzelnen Projekt erstellen

Console

Bitten Sie Ihren Administrator, Ihnen die erforderlichen IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen dieser Anleitung benötigen:

1. Öffnen Sie in der Google Cloud Console die Seite IAM.

   IAM aufrufen

2. Klicken Sie auf person_addZugriff gewähren. Der Bereich Zugriff gewähren wird geöffnet.

3. Geben Sie im Feld Neue Hauptkonten die E-Mail-Adresse der Person ein, die den App Hub verwalten soll, also die Rolle App Hub Admin im Hostprojekt.

4. Klicken Sie auf Rolle auswählen und geben Sie im Feld Filter App Hub ein.

5. Wählen Sie die Rolle App Hub-Administrator aus.

6. Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie in der Liste Rolle auswählen die Option Monitoring-Betrachter aus.

7. Klicken Sie auf Speichern.

gcloud

1. Wenn Sie die Rollen Personen zuweisen möchten, die den App Hub verwenden, wiederholen Sie den folgenden Befehl und ersetzen Sie die IAM-Rollen nach Bedarf. Weitere Informationen finden Sie unter App Hub-Rollen und ‑Berechtigungen.

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

   Ersetzen Sie HOST_PROJECT_ADMIN durch den Nutzer, der im Hostprojekt die Rolle „App Hub-Administrator“ hat. Dieser Wert hat das Format username@yourdomain, z. B. 222larabrown@gmail.com.

2. Weisen Sie den Personen, die den App Hub verwalten, die Rolle „App Hub Admin“ im Dienstprojekt zu. Sie müssen die Rolle „App Hub Admin“ haben, um dem Hostprojekt Dienstprojekte hinzuzufügen. Für jedes Dienstleistungsprojekt ist mindestens eine Person mit dieser Rolle erforderlich. In diesem Beispiel dient das Hostprojekt als Dienstprojekt.

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

   Ersetzen Sie SERVICE_PROJECT_ID durch den Namen des HOST_PROJECT_ID.

3. Weisen Sie den Personen, die den App Hub verwalten, die Rolle „Monitoring-Betrachter“ im Hostprojekt zu. Sie benötigen die Rolle „Monitoring Viewer“ für das Hostprojekt, um Messwerte aufzurufen.

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

Console

1. Rufen Sie in der Google Cloud Console die Seite Einstellungen des App Hubs auf.

   Einstellungen aufrufen

2. Klicken Sie auf der Seite Einstellungen auf Projekte anhängen.

3. Suchen Sie im angezeigten Bereich nach Projekten in der Liste und setzen Sie ein Häkchen in die Kästchen für die App Hub-Dienstprojekte.

4. Klicken Sie auf Auswählen. In der Tabelle Angehängte Dienstprojekte wird das ausgewählte Hostprojekt als Dienstprojekt angezeigt.

5. Klicken Sie auf Schließen.

gcloud

Fügen Sie Ihr Hostprojekt als Dienstprojekt zum App Hub-Hostprojekt hinzu.

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

Console

1. Achten Sie darauf, dass Sie sich im App Hub-Hostprojekt befinden.

2. Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.

   Wechseln Sie zu „Anwendungen“

3. Klicken Sie auf Anwendung erstellen.

4. Wählen Sie auf der Seite Anwendung erstellen im Bereich Region und Name der Anwendung auswählen die Option Regional aus.

5. Wählen Sie in der Liste Region die Option us-west1 aus.

6. Geben Sie im Feld Name der Anwendung den Namen tutorial-application ein. Dieser Name ist eine eindeutige Kennung und kann nach dem Erstellen der Anwendung nicht mehr geändert werden.

7. Geben Sie einen Anzeigenamen, Tutorial, ein und klicken Sie auf Weiter. Dies ist ein nutzerfreundlicher Name, den Sie aktualisieren können. Weitere Informationen finden Sie unter Vorhandene Anwendung aktualisieren.

8. Wählen Sie im Bereich Attribute hinzufügen in der Liste Kritisch die Option Hoch aus. Die Kritischkeit gibt an, wie wichtig eine Anwendung, ein Dienst oder eine Arbeitslast für Ihren Geschäftsbetrieb ist.

9. Wählen Sie im Feld Umgebung die Option Produktion aus, um die Phase des Softwarelebenszyklus anzugeben.

10. Klicken Sie auf Weiter.

11. Fügen Sie im Bereich Inhaber hinzufügen die folgenden Details für Entwicklerinhaber, Betreiberinhaber und Inhaber von Unternehmen hinzu. Wenn Sie einen Anzeigenamen hinzufügen, müssen Sie die E-Mail-Adresse des Inhabers eingeben.

    1. Geben Sie den Anzeigenamen eines Eigentümers ein.
    2. Geben Sie die E-Mail-Adresse des Inhabers ein. Dieser Wert muss das Format username@yourdomain haben, z. B. 222larabrown@gmail.com.

12. Wiederholen Sie diese Schritte für jeden Entwickler, Betreiber und Geschäftsinhaber.

13. Klicken Sie auf Erstellen.

Die neue Anwendung wird erstellt und auf der Seite Anwendungen aufgeführt.

gcloud

1. Wählen Sie das von Ihnen erstellte App Hub-Hostprojekt aus:

   gcloud config set project HOST_PROJECT_ID

2. Erstellen Sie in der Region us-west1 eine neue Anwendung namens tutorial-application und geben Sie ihr den Anzeigenamen Tutorial. Dieser Anwendungsname, tutorial-application, ist eine eindeutige Kennung und kann nach dem Erstellen der Anwendung nicht mehr geändert werden. Der AnzeigenameTutorial ist ein nutzerfreundlicher Name,den Sie aktualisieren können. Weitere Informationen finden Sie unter Vorhandene Anwendung aktualisieren.

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

3. Listen Sie die Anwendungen in Ihrem App Hub-Hostprojekt auf:

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

   Die Ausgabe sollte in etwa so aussehen:

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

4. Aktualisieren Sie Ihre Anwendung mit den Attributen criticality-type, environment-type und „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
   

   Ersetzen Sie Folgendes:

   • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR und DISPLAY-NAME-BUSINESS: Anzeigenamen des Entwicklers, Betreibers und Inhabers des Unternehmens.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR und EMAIL-NAME-BUSINESS: E-Mail-Adressen des Entwicklers, Betreibers und des Unternehmensinhabers. Diese Werte müssen das Format username@yourdomain haben, z. B. 222larabrown@gmail.com.

   Hinweise:

   • criticality-type: Gibt an, wie wichtig eine Anwendung, ein Dienst oder eine Arbeitslast für Ihr Unternehmen ist.
   • environment-type: gibt die Phasen des Softwarelebenszyklus an.

5. Rufen Sie Details zur von Ihnen erstellten Anwendung ab:

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

   Der Befehl gibt Informationen im YAML-Format zurück, die in etwa so aussehen:

   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. Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.

   Wechseln Sie zu „Anwendungen“

2. Klicken Sie auf den Namen Ihrer Anwendung, Tutorial. Auf dem Tab Dienste und Arbeitslasten wird eine Liste der registrierten Dienste und Arbeitslasten angezeigt, die sich in Ihren App Hub-Dienstprojekten befinden.

3. So registrieren Sie einen Dienst:

   1. Klicken Sie auf dem Tab Dienste und Arbeitslasten auf Dienst/Arbeitslast registrieren.
   2. Klicken Sie auf der Seite Dienst oder Arbeitslast registrieren im Bereich Ressource auswählen auf Durchsuchen, um den Dienst oder die Arbeitslast als Ressource auszuwählen.
   3. Wählen Sie im Bereich Ressource auswählen den Namen des Dienstes, l7-xlb-backend-service, aus und klicken Sie auf Auswählen.
   4. Geben Sie im Bereich Ressource auswählen den Namen der Ressource ein, tutorial-service-backend.
   5. Geben Sie einen Anzeigenamen, Backend service, ein und klicken Sie auf Weiter.
   6. Wählen Sie im Bereich Attribute hinzufügen in der Liste Kritisch die Option Hoch aus, um die Wichtigkeit der Anwendung anzugeben.
   7. Wählen Sie im Feld Umgebung die Option Produktion aus, um die Phase des Softwarelebenszyklus anzugeben.
   8. Klicken Sie auf Weiter.
   9. Geben Sie im Bereich Inhaber hinzufügen die erforderlichen Details für Entwicklerinhaber, Betreiberinhaber und Inhaber von Unternehmen ein. Wenn Sie einen Anzeigenamen hinzufügen, müssen Sie die E-Mail-Adresse des Inhabers eingeben.
      1. Geben Sie den Anzeigenamen eines Eigentümers ein.
      2. Geben Sie die E-Mail-Adresse des Inhabers ein. Dieser Wert muss das Format username@yourdomain haben, z. B. 222larabrown@gmail.com.
   10. Wiederholen Sie diese Schritte für jeden Entwickler, Betreiber und Geschäftsinhaber.
   11. Klicken Sie auf Registrieren.

   Auf dem Tab Dienste und Arbeitslasten im Bereich Registrierte Dienste und Arbeitslasten sehen Sie den hinzugefügten neuen Dienst.

4. Wiederholen Sie die vorherigen Schritte, um die anderen Dienste als tutorial-service-forwarding-rule und tutorial-service-url-map zu registrieren.

5. Registrieren Sie eine Arbeitslast, indem Sie die vorherigen Schritte zum Registrieren eines Dienstes wiederholen. Beachten Sie dabei die folgenden Ausnahmen:

   1. Wählen Sie im Bereich Dienst oder Arbeitslast registrieren unter Dienst oder Arbeitslast auswählen den Namen der Arbeitslast, l7-xlb-backend-example, aus und klicken Sie auf Weiter.
   2. Geben Sie im Bereich Ressource auswählen den Namen der Ressource ein, tutorial-workload-mig.
   3. Geben Sie einen Anzeigenamen, Workload instance group, ein und klicken Sie auf Weiter. Auf dem Tab Dienste und Arbeitslasten sehen Sie im Bereich Registrierte Dienste und Arbeitslasten die neu hinzugefügte Arbeitslast.

gcloud

1. So fügen Sie eine Person mit App Hub-Berechtigungen hinzu:

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
     --member='user:APP_HUB_EDITOR' \
     --role='roles/apphub.editor'
   

   Ersetzen Sie APP_HUB_EDITOR durch den Nutzer, der die Rolle „App Hub-Bearbeiter“ im App Hub-Hostprojekt hat. Dieser Wert hat das Format username@yourdomain, z. B. 222larabrown@gmail.com.

2. Liste aller erkannten Dienste im App Hub-Hostprojekt auflisten Dieser Befehl gibt Dienste zurück, die für die Registrierung bei einer Anwendung verfügbar sind.

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

   Die Ausgabe sollte in etwa so aussehen:

   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'}
   

   Kopieren Sie die Dienst-IDs, z. B. BACKEND_SERVICE_SP2_ID, aus der Ausgabe für den nächsten Schritt.

3. Registrieren Sie die Dienste aus dem vorherigen Schritt in Ihrer Anwendung. Kopieren Sie die Dienst-IDs aus dem Ausgabefeld im vorherigen Schritt.

   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
   

   Ersetzen Sie Folgendes:

   • BACKEND_SERVICE_ID: Der Dienst ID des Backend-Dienstes, den Sie registrieren möchten.
   • FORWARDING_RULE_SERVICE_ID: der Dienst ID der Weiterleitungsregel, die Sie registrieren möchten.
   • URL_MAP_SERVICE_ID: Der Dienst ID der URL-Zuordnung, die Sie registrieren möchten.

4. Listet alle registrierten Dienste in der Anwendung auf.

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

   Die Ausgabe sollte in etwa so aussehen:

   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
   

   Registrierte, aber getrennte Dienste werden durch einen leeren Wert im Feld SERVICE_REFERENCE gekennzeichnet. Weitere Informationen zu den Registrierungsstatus finden Sie unter Eigenschaften und Attribute des App Hub.

5. Listet alle erkannten Arbeitslasten im App Hub-Hostprojekt auf. Dieser Befehl gibt Arbeitslasten zurück, die für die Registrierung bei einer Anwendung verfügbar sind.

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

   Die Ausgabe sollte in etwa so aussehen:

   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'}
   

   Kopieren Sie die Arbeitslast-ID aus der Ausgabe, um sie im nächsten Schritt zu verwenden.

6. Registrieren Sie die Arbeitslast aus dem vorherigen Schritt in Ihrer Anwendung als tutorial-workload-mig. Kopieren Sie die Workload-ID aus dem Ausgabefeld im vorherigen Schritt.

   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
   

   Ersetzen Sie WORKLOAD_ID durch die ID der Arbeitslast, die Sie registrieren möchten.

7. Listet alle registrierten Arbeitslasten in der Anwendung auf.

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

   Die Ausgabe sollte in etwa so aussehen:

   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
   

   Registrierte, aber getrennte Arbeitslasten werden durch einen leeren Wert im Feld WORKLOAD_REFERENCE gekennzeichnet. Weitere Informationen zu den Registrierungsstatus finden Sie unter Eigenschaften und Attribute des App Hub.