App Hub-Anwendung mit einem einzelnen Projekt erstellen

---

<ph type="x-smartling-placeholder">

</ph> In diesem Tutorial erfahren Sie, wie Sie eine App Hub-Anwendung für ein einzelnes Projekt. In einem App Hub-Hostprojekt, das als Dienstprojekt dient, stellen Sie eine verwaltete Instanzgruppe (MIG) mit Lastausgleich bereit. Anschließend registrieren und überwachen Sie in einer Anwendung im App Hub-Hostprojekt alle Infrastrukturressourcen aus dem Dienstprojekt als App Hub-Dienste und -Arbeitslasten.

Diese Anleitung richtet sich an Personen, die App Hub: Sie sollten Erfahrung mit Cloud Load Balancing.

Lernziele

In diesem Anleitung werden die folgenden Aufgaben erläutert:

1. Google Cloud-Projekt erstellen oder auswählen. Dieses Projekt ist Ihr App Hub-Hostprojekt.

2. Verwenden Sie im Hostprojekt Terraform, um ein VPC-Netzwerk, einen regionalen externen Application Load Balancer und ein MIG-Backend für den Load Balancer bereitzustellen. Der regionale externe Application Load Balancer enthält die folgenden Ressourcen:

   • HTTP-Systemdiagnose
   • Weiterleitungsregel
   • URL-Zuordnung
   • Zielproxy
   • Backend-Dienst mit einer verwalteten Instanzgruppe als Backend
   • SSL-Zertifikat (für HTTPS)

   Nur die Weiterleitungsregel, die URL-Zuordnung, der Back-End-Dienst und die MIG sind als entdeckte Ressourcen im App Hub verfügbar. Weitere Informationen finden Sie unter Konzepten und Datenmodellen.

3. Geben Sie die entsprechenden Rollen und Berechtigungen für das Hostprojekt an.

4. Hängen Sie das App Hub-Hostprojekt als Dienstprojekt an.

5. Erstellen Sie eine Anwendung im App Hub-Hostprojekt.

6. Infrastrukturressourcen als App Hub-Dienste und Arbeitsbelastungen.

7. Registrieren Sie Dienste und eine Arbeitslast aus dem Dienstprojekt auf der und Attribute zuweisen.

8. Details zu den registrierten Diensten und Arbeitslasten im App Hub ansehen

Kosten

Eine Schätzung der Kosten für die Google Cloud-Ressourcen, die von der Lösung „Verwaltete VMs mit Load Balancing“ verwendet werden, finden Sie in der vorab berechneten Schätzung im Google Cloud-Preisrechner.

Verwenden Sie die vorab berechnete Schätzung als Ausgangspunkt, um die Kosten Ihrer Bereitstellung zu berechnen. Sie können die Schätzung ändern, um alle Konfigurationsänderungen widerzuspiegeln, die Sie für die in der Lösung verwendeten Ressourcen vornehmen möchten.

Die vorab berechnete Schätzung basiert auf Annahmen für bestimmte Faktoren, darunter:

• Die Google Cloud-Standorte, an denen die Ressourcen bereitgestellt werden.
• Die Zeitdauer der Verwendung der Ressourcen.

Weitere Informationen zu den Kosten für App Hub finden Sie auf der Seite Preise.

Hinweis

Wenn Sie der Projektersteller sind, wird Ihnen die einfache "Owner" Rolle (roles/owner) zugewiesen. Standardmäßig enthält diese IAM-Rolle (Identity and Access Management) die Berechtigungen, die für den vollständigen Zugriff auf die meisten Google Cloud-Ressourcen erforderlich sind.

Wenn Sie nicht der Projektersteller sind, müssen die erforderlichen Berechtigungen auf dem in das entsprechende Hauptkonto übertragen. Ein Hauptkonto kann beispielsweise ein Google-Konto (für Endnutzer) oder ein Dienstkonto (für Anwendungen und Arbeitslasten) sein.

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

• Service Usage Admin (roles/serviceusage.services.enable)
• Service Account Admin (roles/iam.serviceAccounts.create)
• Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin)
• Cloud Infrastructure Manager (roles/config.admin)
• App Hub-Administrator (roles/apphub.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Console

1. Rufen Sie in der Google Cloud Console die Seite für die Projektauswahl auf.

   Zur Projektauswahl

2. Wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines, das als Hostprojekt für den App Hub verwendet werden soll.

3. Enable the required APIs.

   Enable the APIs

gcloud

1. 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.

2. Prüfen Sie, ob die neueste Version der Google Cloud CLI installiert ist. Führen Sie in Cloud Shell den folgenden Befehl aus:

     gcloud components update

3. Erstellen Sie ein Projekt oder wählen Sie ein neues aus. HOST_PROJECT_ID, um das Hostprojekt für App Hub zu sein.

   • Erstellen Sie ein Google Cloud-Projekt:

     gcloud projects create HOST_PROJECT_ID

   • Wählen Sie das von Ihnen erstellte Google Cloud-Projekt aus:

     gcloud config set project HOST_PROJECT_ID

4. Aktivieren Sie die APIs:

   gcloud services enable apphub.googleapis.com \
      cloudresourcemanager.googleapis.com \
      compute.googleapis.com \
      config.googleapis.com \
      serviceusage.googleapis.com

Umgebung vorbereiten

Damit Sie diese Lösung mit minimalem Aufwand bereitstellen können, wird in GitHub eine Terraform-Konfiguration bereitgestellt. Die Terraform-Konfiguration definiert alle Google Cloud-Ressourcen, die für die Lösung erforderlich sind. Terraform-Konfiguration herunterladen aus GitHub, passen Sie den Code nach Bedarf an und stellen Sie die Lösung dann mithilfe der Terraform-Befehlszeile Nachdem Sie die Lösung bereitgestellt haben, können Sie sie weiterhin mit Terraform verwalten.

<ph type="x-smartling-placeholder"></ph>

Abbildung 1. App Hub-Arbeitslasten und -Dienste mit einem Load-Balancer und einer verwalteten Instanzgruppe.

Im Folgenden sehen Sie den Ablauf der Anfrageverarbeitung der Topologie, bei der die eine verwaltete VM-Lösung mit Load-Balancing bereitstellt.

1. Der Nutzer sendet eine Anfrage an die Anwendung, die auf der Compute Engine bereitgestellt ist. Cloud Load Balancing empfängt diese Anfrage.

2. Cloud Load Balancing leitet den Traffic an die Compute Engine weiter verwalteten Instanzgruppen, die Informationen in den Weiterleitungsregeln, der URL-Zuordnung, und Back-End-Dienst.

Terraform-Client einrichten

Sie können Terraform entweder in Cloud Shell oder auf Ihrem lokalen Host ausführen. In dieser Anleitung wird beschrieben, wie Sie Terraform in Cloud Shell ausführen. Dort ist Terraform vorinstalliert und für die Authentifizierung bei Google Cloud konfiguriert.

Der Terraform-Code für diese Lösung ist in einem GitHub-Repository verfügbar.

1. Klonen Sie in Cloud Shell das GitHub-Repository in Cloud Shell.

   git clone https://github.com/terraform-google-modules/terraform-docs-samples
   

2. Prüfen Sie in Cloud Shell, ob das aktuelle Arbeitsverzeichnis terraform-docs-samples/lb/regional_external_http_load_balancer ist. Dies ist das Verzeichnis, das die Terraform-Konfigurationsdateien für die Lösung enthält. Wenn Sie in dieses Verzeichnis wechseln müssen, führen Sie den folgenden Befehl aus:

   cd terraform-docs-samples/lb/regional_external_http_load_balancer 
   

3. Initialisieren Sie Terraform mit dem folgenden Befehl:

   terraform init
   

   Warten Sie, bis folgende Meldung angezeigt wird:

   Terraform has been successfully initialized!
   

Terraform-Konfiguration validieren und prüfen

1. Prüfen Sie, ob das aktuelle Arbeitsverzeichnis terraform-docs-samples/lb/regional_external_http_load_balancer ist. Ist dies nicht der Fall, wechseln Sie zu diesem Verzeichnis.

2. Prüfen Sie, ob die Terraform-Konfiguration Fehler enthält:

   terraform validate
   

   Wenn der Befehl einen Fehler zurückgibt, nehmen Sie die erforderlichen Korrekturen in der Konfiguration vor und führen Sie den Befehl terraform validate noch einmal aus. Wiederholen Sie diesen Schritt, bis der Befehl die folgende Meldung zurückgibt:

   Success! The configuration is valid.
   

3. Sehen Sie sich die Ressourcen an, die in der Konfiguration definiert sind:

   terraform plan
   

   Die Ausgabe des Befehls terraform plan ist eine Liste der Ressourcen, die Terraform beim Anwenden der Konfiguration bereitstellt.

   Wenn Sie Änderungen vornehmen möchten, bearbeiten Sie die Konfiguration und führen Sie dann die Befehle terraform validate und terraform plan noch einmal aus.

Ressourcen bereitstellen

Wenn keine weiteren Änderungen an der Terraform-Konfiguration erforderlich sind, stellen Sie die Ressourcen bereit.

1. Prüfen Sie, ob das aktuelle Arbeitsverzeichnis terraform-docs-samples/lb/regional_external_http_load_balancer ist. Ist dies nicht der Fall, wechseln Sie zu diesem Verzeichnis.

2. Wenden Sie die Terraform-Konfiguration an:

   terraform apply
   

   Terraform zeigt eine Liste der Ressourcen an, die erstellt werden.

3. Wenn Sie aufgefordert werden, die Aktionen auszuführen, geben Sie yes ein.

   In Terraform werden Nachrichten angezeigt, die den Fortschritt der Bereitstellung anzeigen.

   Wenn die Bereitstellung nicht abgeschlossen werden kann, zeigt Terraform die Fehler an, die den Fehler verursacht haben. Prüfen Sie die Fehlermeldungen und aktualisieren Sie die Konfiguration, um die Fehler zu beheben. Führen Sie den Befehl terraform apply dann noch einmal aus.

   Nachdem alle Ressourcen erstellt wurden, zeigt Terraform die folgende Meldung an:

   Apply complete!
   

Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

Cloud Load Balancing verteilt den Traffic auf die Weiterleitung eine Regel, eine URL-Zuordnung, den Back-End-Dienst und eine Compute Engine-MIG. Backend Dienst, URL-Zuordnung und Weiterleitungsregeln zu erkannten Dienste im App Hub-Hostprojekt. Die Compute Engine MIG wird zu einer erkannten Arbeitslast im App Hub-Hostprojekt.

Wenn Sie die Lösung nicht mehr benötigen, können Sie die Bereitstellung löschen, um weitere Kosten für die Google Cloud-Ressourcen zu vermeiden. Weitere Informationen finden Sie unter Bereitstellung löschen.

IAM-Berechtigungen gewähren

Weisen Sie dem App Hub-Hostprojekt die entsprechenden IAM-Rollen und Berechtigungen zu.

Console

1. Um die Berechtigungen zu erhalten, die Sie für diesen Vorgang benötigen bitten Sie Ihren Administrator, Ihnen die erforderlichen IAM-Rollen für Ihr Projekt:

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

      IAM aufrufen

   2. Klicken Sie auf Zugriff 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 in das Feld Filter Folgendes ein: App Hub

   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 Format username@yourdomain, z. B.: [e-mail].

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. Sie benötigen für jeden Dienst mindestens eine Person mit dieser Rolle Projekt arbeiten. 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 müssen die Monitoring-Betrachter im Hostprojekt, um Messwerte anzusehen.

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

Dienstprojekt anhängen

Hängen Sie das Hostprojekt, in dem Sie die Ressourcen bereitgestellt haben, als Dienstprojekt an.

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 der ausgewählte Host angezeigt. Projekt als Dienstprojekt festlegen.

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

Anwendung erstellen

Erstellen Sie eine Anwendung, die als Container für Ihre Dienste und Arbeitslasten dient.

Console

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

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

   Wechseln Sie zu „Anwendungen“

3. Klicken Sie auf Anwendung erstellen.

4. auf der Seite Anwendung erstellen im Bereich Anwendungsregion auswählen und Name 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.

7. Geben Sie einen Anzeigenamen, Tutorial, ein und klicken Sie auf Weiter.

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 Unternehmensinhaber 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. [e-mail].

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:

   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 der Entwickler, Betreiber und Geschäftsinhaber.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR und EMAIL-NAME-BUSINESS: E-Mail-Adressen der Entwickler, Betreiber und Geschäftsinhaber. Diese Werte müssen das Format username@yourdomain haben, z. B.: [e-mail].

   Hinweise:

   • criticality-type: gibt an, wie wichtig eine Anwendung ist. Dienst oder Arbeitslast für Ihre Geschäftstätigkeiten 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'
   

Dienste und eine Arbeitslast registrieren

Durch das Registrieren von Diensten und Arbeitslasten werden sie einer Anwendung hinzugefügt.

Console

1. Rufen Sie in der Google Cloud Console die Seite Anwendungen in App Hub auf.

   Wechseln Sie zu „Anwendungen“

2. Klicken Sie auf den Namen Ihrer Anwendung, Tutorial. Der Tab Dienste und Arbeitslasten wird mit einer Liste der registrierten Dienste und Arbeitslasten in Ihrem App Hub-Dienst Projekten.

3. So registrieren Sie einen Dienst:

   1. Klicken Sie auf dem Tab Dienste und Arbeitslasten auf Dienst/Arbeitslast registrieren.
   2. Gehen Sie auf der Seite Dienst oder Arbeitslast registrieren in der Ressource auswählen auf Durchsuchen, um den Dienst oder Arbeitslast als Ressource.
   3. Wählen Sie im Bereich Ressource auswählen den Namen des l7-xlb-backend-service, 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 unter Display name (Anzeigename) Backend service ein und klicken Sie auf Continue (Weiter).
   6. Führen Sie im Bereich Attribute hinzufügen in der Liste Wichtigkeit folgende Schritte aus: wie wichtig die Anwendung ist, wählen Sie Hoch aus.
   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 nach Bedarf die folgenden Details für Entwicklerinhaber, Operator-Inhaber und Geschäftsinhaber Beachten Sie, dass Sie die E-Mail-Adresse des Eigentümers eingeben müssen, wenn Sie ein Anzeigename.
      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. [e-mail].
   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 mit den folgenden Ausnahmen wiederholen:

   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 Berechtigungen des App Hub-Bearbeiters 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 mit dem Rolle „App Hub-Bearbeiter“ im App Hub-Host Projekt arbeiten. Dieser Wert hat das Format username@yourdomain. Beispiel: [e-mail].

2. Alle erkannten Dienste im App Hub-Hostprojekt auflisten. Dieser Befehl gibt Dienste zurück, die für eine .

   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 IDs des Dienstes, z. B. BACKEND_SERVICE_SP2_ID. aus der Ausgabe für den nächsten Schritt.

3. Registrieren Sie die Dienste aus dem vorherigen Schritt bei Ihrer Anwendung. Kopieren 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: Dienst-ID der URL die Sie registrieren möchten.

4. Hiermit werden alle registrierten Dienste in der Anwendung aufgelistet.

   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 sind 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.

6. Arbeitslast aus dem vorherigen Schritt bei Ihrer Anwendung registrieren als sample-workload. Kopieren Sie die Arbeitslast-ID aus dem im vorherigen Schritt.

   gcloud apphub applications workloads create tutorial-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
   

   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
   

   Registriert, aber getrennte Arbeitslasten werden durch einen leeren Wert in der WORKLOAD_REFERENCE. Weitere Informationen zur finden Sie in der Properties und Attribute von App Hub.

Alle Dienste und Arbeitslasten ansehen

Sie können Details zu den Diensten und Arbeitslasten des Dienstes ansehen. Projekte, die an das App Hub-Hostprojekt angehängt sind.

1. Rufen Sie in der Google Cloud Console den App Hub auf. Seite Dienste und Arbeitslasten

   Zu „Dienste und Arbeitslasten“

   Alle Dienste und Arbeitslasten aus dem angehängten App Hub Dienstprojekte werden angezeigt.

2. Wählen Sie in der Liste Region die Option us-west1 aus. Die Arbeitslast Arbeitslastinstanzgruppe wird mit Details wie App Hub Type, Wichtigkeit und Registriert auf:

3. So filtern Sie die Dienste oder Arbeitslasten nach Status:

   1. Wählen Sie im Feld Filter Filter wie Registrierungsstatus aus.
   2. Klicken Sie auf Registriert. Liste der registrierten Dienste und Arbeitslasten erscheint.

Anwendungsmesswerte ansehen

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Sie können die Systemmesswerte für die Anwendungen aufrufen, die in Ihrem App Hub-Hostprojekt erstellt wurden. Diese Messwerte entsprechen den Goldene Signale: Traffic, Fehler, Latenz und Sättigung, die zur Überwachung der Leistung und Integrität der Anwendung beitragen.

1. Rufen Sie in der Google Cloud Console die Seite Anwendungen in App Hub auf.

   Wechseln Sie zu „Anwendungen“

2. Klicken Sie auf den Namen der Anwendung: Tutorial.

   Der Tab Dienste und Arbeitslasten wird mit den Metadaten der Dienste angezeigt. und Arbeitslasten, die für Ihre Anwendung registriert sind.

3. Klicken Sie zum Anzeigen der Systemmesswerte registrierter Dienste und Arbeitslasten auf Messwerte:

Bereinigen

Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.

App Hub-Ressourcen löschen

Console

1. Wechseln Sie in der Google Cloud Console zur App Hub-Seite Anwendungen.

   Wechseln Sie zu „Anwendungen“

2. Klicken Sie auf den Namen einer Anwendung, Anleitung.

3. Wählen Sie auf dem Tab Dienste und Arbeitslasten Registrierte Dienste und Arbeitslasten auf den Namen eines Service.

4. Klicken Sie auf der Seite Dienste und Arbeitslasten auf Registrierung aufheben.

   In einer Benachrichtigung werden Sie darüber informiert, dass der Dienst nicht registriert ist.

5. Klicken Sie auf dem Tab Dienste und Arbeitslasten im Bereich Registrierte Dienste und Arbeitslasten auf den Namen einer Arbeitslast.

6. Klicken Sie auf dem Tab Details auf Registrierung aufheben.

   Eine Benachrichtigung informiert Sie darüber, dass die Arbeitslast nicht registriert ist.

7. Rufen Sie im App Hub die Seite Anwendungen auf.

   Wechseln Sie zu „Anwendungen“

8. Klicken Sie auf den Namen einer Anwendung.

9. Klicken Sie auf der Seite tutorial-application auf Löschen.

10. Rufen Sie in der Google Cloud Console die App Hub-Einstellungen auf. Seite.

    Einstellungen aufrufen

11. Klicken Sie auf der Seite Einstellungen das Kästchen für das Dienstprojekt an, das Sie aus dem App Hub-Hostprojekt entfernen möchten.

12. Klicken Sie auf Projekte trennen.

gcloud

1. Listen Sie die registrierten Dienste in der Anwendung auf:

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

2. Melden Sie die Dienste von der Anwendung ab:

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

   Ersetzen Sie SERVICE_NAME durch den Namen Ihres Dienstes.

   Die Dienste werden jetzt erkannte Dienste, die im .

3. Listen Sie die registrierten Arbeitslasten in der Anwendung auf:

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

4. Heben Sie die Registrierung der Arbeitslast von der Anwendung auf:

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

   Ersetzen Sie WORKLOAD_NAME durch den Namen Ihrer Arbeitslast.

   Die Arbeitslast ist jetzt eine erkannte Arbeitslast, die bei der .

5. So löschen Sie die Anwendung:

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

6. Entfernen Sie das Dienstprojekt aus dem App Hub-Hostprojekt:

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

Bereitstellung löschen

Wenn Sie die Lösung nicht mehr benötigen, löschen Sie alle Ressourcen, um weitere Kosten für die in dieser Lösung erstellten Ressourcen zu vermeiden.

Verwenden Sie dieses Verfahren, wenn Sie die Lösung mit der Terraform-Befehlszeile bereitgestellt haben.

1. Prüfen Sie in Cloud Shell, ob das aktuelle Arbeitsverzeichnis terraform-docs-samples/lb/regional_external_http_load_balancer ist. Ist dies nicht der Fall, wechseln Sie zu diesem Verzeichnis.

2. Entfernen Sie die von Terraform bereitgestellten Ressourcen:

   terraform destroy
   

   Terraform zeigt eine Liste der Ressourcen an, die gelöscht werden.

3. Wenn Sie aufgefordert werden, die Aktionen auszuführen, geben Sie yes ein.

   Terraform zeigt Nachrichten mit dem Fortschritt an. Nachdem alle Ressourcen gelöscht wurden, zeigt Terraform die folgende Meldung an:

   Destroy complete!
   

Wenn Sie das für die Lösung verwendete Google Cloud-Projekt nicht mehr benötigen, können Sie das Projekt löschen.

Projekt löschen

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt die Sie in Zukunft verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Tutorials oder Kurzanleitungen Durch Wiederverwendung von Projekten können Sie die Überschreitung von Projektkontingenten vermeiden.

Console

1. Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.

   Zur Seite „Ressourcen verwalten“

2. Wählen Sie in der Projektliste das Projekt aus, die Sie löschen möchten, und klicken Sie dann auf Löschen.
3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Beenden, um das Projekt zu löschen.

gcloud

Löschen Sie ein Google Cloud-Projekt:

gcloud projects delete PROJECT_ID

Ersetzen Sie PROJECT_ID durch die Projekt-IDs des Host- oder Dienstprojekts.

Nächste Schritte

• App Hub – Übersicht