App Hub einrichten

In diesem Dokument finden Sie eine Anleitung zum Einrichten von App Hub für Anwendungen in Google Cloud erstellen, betreiben und verwalten. Es ist ist für Personen gedacht, die App Hub einrichten und verwalten.

Wenn Sie App Hub einrichten, sind die Hauptaufgaben: folgt:

  1. Entscheiden Sie, ob Sie ein neues App Hub-Hostprojekt erstellen oder ein vorhandenes Projekt als Hostprojekt verwenden.
    • Wenn Sie mehr als ein Hostprojekt haben möchten, empfehlen wir Ihnen dringend, die Sie im selben Ordner erstellen.
    • Hostprojekte in App Hub sind nicht mit den Freigegebene VPC-Hostprojekte und haben nicht die gleichen Anforderungen. Zum Beispiel sollten Sie Sie benötigen ein freigegebene VPC-Netzwerk, um App Hub nutzen zu können. In dieser Dokument bezieht sich alle Verweise auf Hostprojekte auf den App Hub Hostprojekte.
    • Ein Hostprojekt kann kein anderes Dienstprojekt als sich selbst sein.
  2. Aktivieren Sie die App Hub API im Hostprojekt.
  3. Fügen Sie dem Hostprojekt ein oder mehrere App Hub-Dienstprojekte hinzu.
    • Dienstprojekte in App Hub sind nicht dasselbe wie Freigegebene VPC-Dienstprojekte und haben nicht die gleichen Anforderungen. In diesem Dokument beziehen sich alle Verweise auf Dienstprojekte App Hub-Dienstprojekte
  4. App Hub-Nutzer als App Hub festlegen Administratoren, App Hub-Bearbeiter oder App Hub Zuschauer
  5. Anwendungen erstellen
  6. Registrieren Sie Dienste und Arbeitslasten bei der Anwendung.

Dienste und Arbeitslasten

Mit App Hub werden die Ressourcen aus Dienstprojekten, die an das Hostprojekt als Dienste und Arbeitslasten zur Verfügung. Wird registriert Ihrer Dienste und Arbeitslasten an eine Anwendung senden, Ressourcen zu finden. Sie können die folgenden Ressourcen als App Hub-Dienste und registrieren Sie sie unter App Hub-Anwendungen:

  • Weiterleitungsregeln
  • URL-Zuordnungen
  • Backend-Dienste

Sie können verwaltete Instanzgruppen (MIGs), aber keine einzelnen VMs festlegen, Arbeitslasten erstellen und bei App Hub-Anwendungen registrieren.

App Hub unterstützt regionale und externe L7-Bereiche Application Load Balancer mit HTTP- oder HTTPS-Traffic

Arbeitslasten und Dienste, die Sie registrieren, müssen sich in derselben Region wie die Anwendung Daher wird bei den folgenden Anweisungen und Befehlen vorausgesetzt, dass alle Ressourcen befinden sich in derselben Region. Informationen dazu, in welchen Regionen Sie finden Sie unter Standorte.

Allgemeiner Einrichtungsprozess

In der folgenden Liste sind die Schritte zur Einrichtung von App Hub zusammengefasst:

  1. Bestimmen, welche vorhandenen Ressourcen in Ihr und welchen Projekten sie angehören.
  2. Erstellen Sie ein App Hub-Hostprojekt und aktivieren Sie die App Hub API im Projekt. Optional, je nach Ihren Unternehmensstrukturen erstellen, erstellen Sie mehr als ein Hostprojekt. Wenn Sie mehrere Projekte erstellen, empfehlen wir, sie in einem neuen Ordner zu erstellen.
  3. Dienstprojekte anhängen Nachdem Sie ein Hostprojekt konfiguriert haben, hängen Sie Dienstprojekten mit zugrunde liegenden Ressourcen, die Ihre Anwendungen benötigen, das Hostprojekt. Beachten Sie Folgendes: <ph type="x-smartling-placeholder">
      </ph>
    1. Die Dienstprojekte müssen sich in derselben Organisation befinden. als Hostprojekt festlegen. Nachdem Sie ein Dienstprojekt an einen Host angehängt haben Projekt arbeiten, können Sie es nicht in eine andere Organisation verschieben. So verschieben Sie den Dienstprojekt einer anderen Organisation zuweisen, müssen Sie die Anleitung in diesem Dokument, entfernen oder trennen Den Anhang des Dienstprojekts an das Hostprojekt. Anschließend können Sie das Dienstprojekt einer anderen Organisation zuzuweisen.
    2. Ein Dienstprojekt kann nicht an mehr als ein Hostprojekt angehängt werden.
    3. Ein Hostprojekt kann ein eigenes Dienstprojekt sein, Dienstprojekt für ein beliebiges anderes Hostprojekt.
    4. Nachdem Sie Dienstprojekte an ein Hostprojekt angehängt haben, wird durch Abfrage des Hostprojekts Projekt für Dienste oder Arbeitslasten gibt automatisch alle Dienste und Arbeitslasten in allen Dienstprojekten.
  4. Erstellen Sie eine Anwendung, um mehrere Arbeitslasten und Dienste zu organisieren. Wichtige Hinweise:
    1. Der Name der Anwendung muss im Hostprojekt eindeutig sein und den Standort haben.
    2. Ein Dienstprojekt kann an ein Hostprojekt mit mehreren Anwendungen angehängt werden, seine Einzelne Ressourcen können nur für eine Anwendung registriert werden.
  5. Dienste und Arbeitslasten abfragen und in der Anwendung registrieren Nachdem Sie eine Anwendung erstellt haben, fragen Sie das Hostprojekt nach verfügbaren Dienste und Arbeitslasten. Die Abfragen werden für das Hostprojekt und alle Dienstprojekte, die an das Hostprojekt angehängt sind. Es werden auch alle Dienste und Arbeitslasten in diesen Projekten zu nutzen. Beachten Sie Folgendes: <ph type="x-smartling-placeholder">
      </ph>
    1. Sie können einen Dienst oder eine Arbeitslast nur bei einer einzelnen Anwendung registrieren.
    2. Alle Arbeitslasten und Dienste, die Sie registrieren, müssen sich in derselben Region befinden wie die Anwendung.
    3. Registrierte Dienste und Arbeitslasten sind von Aktualisierungen der zugrunde liegende Infrastrukturressource. Mit anderen Worten: Wenn Sie den zugrunde liegende Ressourcen, die als Dienste und Arbeitslasten fungieren, App Hub löscht die zugehörigen Arbeitslasten und Dienste aus Ihrer Anwendung. Sie müssen die Registrierung Arbeitslast oder Dienst.

Vorbereitung

Führen Sie die folgenden Aufgaben aus, bevor Sie den App Hub einrichten.

  1. Entscheiden Sie, welches vorhandene Projekt das Hostprojekt ist, oder erstellen Sie ein neues Projekt, das Hostprojekt sein. Wir empfehlen Ihnen dringend, ein neues Projekt zu erstellen.
  2. Sie müssen entschieden haben, welche Personen für die Identitäts- und Zugriffsverwaltung (Identity and Access Management, IAM) zuständig sind. Rollen für App Hub: App Hub-Administrator, App Hub Editor und App Hub Viewer.

Wichtige Hinweise:

  • An Hostprojekte können ein oder mehrere Dienstprojekte angehängt werden.
  • Ein Dienstprojekt kann nicht an mehr als ein Hostprojekt angehängt werden.
  • Die Person, die ein Dienstprojekt an ein Hostprojekt anhängt, muss die Berechtigung IAM-Rolle „App Hub Admin“ sowohl im Dienst und Hostprojekt. Weitere Informationen finden Sie unter App Hub-Rollen und -Berechtigungen:

App Hub einrichten

In diesem Abschnitt erstellen Sie eine App Hub-Beispielarchitektur.

In diesem Beispiel hat eine Organisation drei Dienstprojekte, Infrastrukturressourcen, die in den Projekten wie folgt bereitgestellt werden:

  • Dienstprojekt 1 hat zwei Infrastrukturressourcen: Dienst 1 und Dienst 2.
  • Dienstprojekt 2 hat drei Infrastrukturressourcen: Dienst 3, Arbeitslast 1, und Arbeitslast 2.
  • Dienstprojekt 3 hat drei Infrastrukturressourcen: Dienst 4, Arbeitslast 3, und Arbeitslast 4.

Achten Sie darauf, dass die Projekte, die Sie zum Erstellen des Beispiels auswählen, den Parameter Ressourcen, die in diesem Abschnitt beschrieben sind, oder seien Sie darauf vorbereitet, das Beispiel so anzupassen, befolgen Sie die Anweisungen.

In den folgenden Abschnitten wird beschrieben, wie Sie ein Beispiel für einen App Hub Sie erstellen ein Hostprojekt und fügen einen Dienst an das Hostprojekt an, erstellen Sie dann eine Anwendung und hängen Sie Arbeitslasten an die Anwendung senden. Das Beispiel umfasst drei Dienstprojekte, können weniger oder mehr hinzufügen.

Im Beispiel wird davon ausgegangen, dass alle Dienstprojekte, die Sie hinzufügen, bereits vorhanden sind und Dienste und Arbeitslasten enthalten, die Sie Ihrer Anwendung hinzufügen. Bevor Sie das Beispiel erstellen, bestimmen, welche Dienstprojekte die Dienste enthalten die Sie in die Anwendung aufnehmen möchten.

App Hub aktivieren

In diesem Abschnitt wählen Sie ein Hostprojekt aus oder erstellen ein neues und aktivieren das App Hub API aktivieren und den Nutzern die entsprechenden Rollen und Berechtigungen Personen in Ihrer Organisation. Außerdem hängen Sie Dienstprojekte an den Host an. Projekt arbeiten.

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. Ihr App Hub-Hostprojekt sein.

  3. Aktivieren Sie die erforderliche API.

    Aktivieren Sie die API

  4. Als Ersteller des Projekts erhalten Sie die einfache Rolle „Inhaber“ (roles/owner). Diese Identitäts- und Zugriffsverwaltung (Identity and Access Management, IAM) Rolle die Berechtigungen für vollständigen Zugriff auf die meisten Google Cloud-Ressourcen

    Wenn Sie nicht der Projektersteller sind, müssen die erforderlichen Berechtigungen gewährt werden für das Projekt an das entsprechende Hauptkonto. Beispiel: Das Hauptkonto kann ein Google-Konto (für Endnutzer) oder ein Dienstkonto sein (für Anwendungen und Computing-Arbeitslasten). Um die Berechtigungen zu erhalten, die Sie zum Ausführen dieser Anleitung benötigen, fragen Sie Ihr Administrator, um Ihnen die folgenden IAM-Rollen für Ihr Projekt zu gewähren:

    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 in das Feld Neue Hauptkonten die E-Mail-Adresse des Person, die App Hub verwaltet 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 Admin“ (App Hub-Administrator) aus und klicken Sie auf Save (Speichern).

    6. Gewähren Sie in jedem App Hub-Dienstprojekt die App Hub-Administrator.

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

    Einstellungen aufrufen

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

  7. Führen Sie einen der folgenden Schritte aus:

    • Wählen Sie in der Projektliste die Kästchen für die Projekte aus, die Sie als Dienstprojekte hinzufügen möchten.
    • Nach Projekten suchen und dann die Projekte auswählen, die als Dienst hinzugefügt werden sollen Projekten.
  8. Klicken Sie auf Auswählen. In der Tabelle Angehängte Dienstprojekte wird der ausgewählte Dienst angezeigt. Projekten.

  9. Klicken Sie auf Schließen.

gcloud

  1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

  2. Achten Sie darauf, dass die neueste Version der Google Cloud CLI installiert ist. Ausführen den folgenden Befehl in Cloud Shell 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 App Hub API im soeben erfolgten Hostprojekt. erstellt.

    gcloud services enable apphub.googleapis.com \
        --project=HOST_PROJECT_ID
    
  5. Als Ersteller des Projekts erhalten Sie die einfache Rolle „Inhaber“ (roles/owner). Diese Identitäts- und Zugriffsverwaltung (Identity and Access Management, IAM) Rolle die Berechtigungen für vollständigen Zugriff auf die meisten Google Cloud-Ressourcen

    Wenn Sie nicht der Projektersteller sind, müssen die erforderlichen Berechtigungen gewährt werden für das Projekt an das entsprechende Hauptkonto. Beispiel: Das Hauptkonto kann ein Google-Konto (für Endnutzer) oder ein Dienstkonto sein (für Anwendungen und Computing-Arbeitslasten). Um die Berechtigungen zu erhalten, die Sie zum Ausführen dieser Anleitung benötigen, fragen Sie Ihr Administrator, um Ihnen die folgenden IAM-Rollen für Ihr Projekt zu gewähren:

    1. Erteilen Sie optional den Personen, die App Hub, der App Hub Administratorrolle im Hostprojekt. Wiederholen Sie den folgenden Befehl für einzelnen Administratoren.

      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 hat im Hostprojekt die Rolle „App Hub Admin“. Dieses hat das Format username@yourdomain. Beispiel: robert.smith@example.com.

    2. Gewähren Sie dem Nutzer in den Dienstprojekten die Rolle „App Hub Admin“. Personen, die App Hub verwalten Sie müssen die Rolle „App Hub Admin“ zum Hinzufügen von Dienstprojekten zum Host Projekt arbeiten. Sie benötigen für jeden Dienst mindestens eine Person mit dieser Rolle Projekt arbeiten. Eine einzelne Person kann die Rolle in mehreren Dienstprojekten übernehmen.

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

      Ersetzen Sie Folgendes:

      • SERVICE_PROJECT_1: die erste von drei Dienstprojekten.
      • SERVICE_PROJECT_2: die zweite von drei Dienstprojekten.
      • SERVICE_PROJECT_3: das dritte von drei Dienstprojekten.
  6. Fügen Sie Ihre Dienstprojekte dem App Hub-Hostprojekt hinzu.

    gcloud apphub service-projects add SERVICE_PROJECT_1 \
        --project=HOST_PROJECT_ID
    
    gcloud apphub service-projects add SERVICE_PROJECT_2 \
        --project=HOST_PROJECT_ID
    
    gcloud apphub service-projects add SERVICE_PROJECT_3 \
        --project=HOST_PROJECT_ID
    

Anwendung erstellen

Wenn Sie noch keine Anwendung haben, erstellen Sie eine, die als Container für Ihre Dienste und Arbeitslasten.

Console

  1. Achten Sie darauf, dass Sie sich im 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. Der Bereich Create application (Anwendung erstellen) angezeigt.

  4. Wählen Sie eine Region aus.

  5. Geben Sie den Namen der Anwendung ein und klicken Sie auf Weiter.

  6. Geben Sie im Abschnitt Attribute hinzufügen den Anzeigenamen ein.

  7. Geben Sie bei Bedarf weitere Details zur Anwendung in die Felder ein. die folgenden. Weitere Informationen in diesem Dokument finden Sie unter Vorhandene App Hub-Anwendung aktualisieren

  8. Klicken Sie auf Erstellen.

gcloud

  1. Erstellen Sie eine neue Anwendung namens APPLICATION_NAME und geben Sie einen Anzeigenamen ein, APPLICATION_DISPLAY_NAME. Das Flag --scope-type definiert, welche Dienste und Arbeitslasten können für eine Anwendung registriert werden. Es wird nur REGIONAL unterstützt. Das bedeutet, dass nur Dienste und Arbeitslasten aus derselben Region -Anwendung registriert werden kann.

    gcloud apphub applications create APPLICATION_NAME \
      --display-name='APPLICATION_DISPLAY_NAME' \
      --scope-type=REGIONAL \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Ersetzen Sie Folgendes:

    • APPLICATION_NAME ist der Name Ihrer Anwendung. Der Name darf nur kleingeschriebene alphanumerische Zeichen ohne Leerzeichen.
    • APPLICATION_DISPLAY_NAME: der Anzeigename von Ihre Anwendung.
    • REGION ist die Region der Anwendung. Verschenken Wert us-east1
  2. Listen Sie die Anwendungen in Ihrem Hostprojekt auf.

    gcloud apphub applications list \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Ausgabe sieht in etwa so aus:

    ID: APPLICATION_NAME
    DISPLAY_NAME: APPLICATION_DISPLAY_NAME
    CREATE_TIME: 2023-10-31T18:33:48
    
  3. Rufen Sie Details zu der von Ihnen erstellten Anwendung ab.

    gcloud apphub applications describe APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

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

    createTime: '2023-10-31T18:33:48.199394108Z'
    displayName: APPLICATION_DISPLAY_NAME
    name: projects/HOST_PROJECT_ID/locations/REGION/applications/APPLICATION_NAME
    scope:
      type: REGIONAL
    state: ACTIVE
    uid: [APPLICATION_UID]
    updateTime: '2023-10-31T18:33:48.343303819Z'
    
    

Vorhandene App Hub-Anwendung aktualisieren

Sie können die Attribute Ihrer Anwendung auch aktualisieren, nachdem die Anwendung erstellt.

Console

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

    Wechseln Sie zu „Anwendungen“

  2. Klicken Sie in der Liste der Anwendungen auf . Wählen Sie für die Anwendung, die Sie aktualisieren möchten, die Option Bearbeiten aus.

  3. Bearbeiten Sie die Felder nach Bedarf und klicken Sie auf Speichern.

  4. Optional: In der Liste Wichtigkeit können Sie hier die Wichtigkeit der Funktion angeben. wählen Sie eine der folgenden Optionen aus:

    • Missionskritisch
    • Hoch
    • Mittel
    • Niedrig
  5. Optional: Geben Sie im Feld Environment (Umgebung) die Phase der Softwarelebenszyklus wählen Sie eine der folgenden Optionen aus:

    • Produktion
    • Phase
    • Entwicklung
    • Test
  6. Optional: Fügen Sie nach Bedarf die folgenden Informationen für Entwicklerinhaber hinzu: Operator-Inhaber und Geschäftsinhaber Sie müssen E-Mail-Adresse des Inhabers, wenn Sie einen Anzeigenamen hinzufügen.

    1. Geben Sie den Anzeigenamen eines Inhabers ein.
    2. Geben Sie die E-Mail-Adresse des Inhabers ein. Dieser Wert muss Format username@yourdomain, z. B. 222larabrown@gmail.com
  7. Wiederholen Sie diese Schritte für jeden Entwickler, Betreiber und Geschäftsinhaber.

  8. Klicken Sie auf Speichern.

gcloud

  1. Aktualisieren Sie Ihre Anwendung mit dem criticality-type, environment-type, und Inhabertypattribute:

    gcloud apphub applications update APPLICATION_NAME \
      --criticality-type='CRITICALITY_LEVEL' \
      --environment-type='ENVIRONMENT' \
      --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=REGION
    

    Ersetzen Sie Folgendes:

    • CRITICALITY_LEVEL: gibt an, wie wichtig Anwendung, Dienst oder Arbeitslast für Ihre Geschäftsabläufe. Geben Sie einen der folgenden Werte an: <ph type="x-smartling-placeholder">
        </ph>
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: gibt die Phasen der Softwarelebenszyklus. Geben Sie einen der folgenden Werte an: <ph type="x-smartling-placeholder">
        </ph>
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • 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 muss das Format username@yourdomain haben. Beispiel: 222larabrown@gmail.com.
  2. Lassen Sie die Anwendungen auflisten, bei denen das Attribut environment-type Wert PRODUCTION.

    gcloud apphub applications list \
        --filter='attributes.environment.type=PRODUCTION' \
        --project=HOST_PROJECT_ID \
        --location=REGION
    

    Die Ausgabe sieht in etwa so aus:

    ID: APPLICATION_NAME
    DISPLAY_NAME: APPLICATION_DISPLAY_NAME
    CREATE_TIME: 2023-10-31T18:33:48
    

Dienste und Arbeitslasten registrieren

Wenn Sie Infrastrukturdienste und -arbeitslasten bei einer Anwendung registrieren, Dienste und Arbeitslasten werden als App Hub-Ressourcen registriert. Wenn verwenden Sie die Platzhalter, um die Anwendung mit gcloud CLI, den Diensten und Arbeitslasten in den drei Dienstprojekten sind:

  • Dienstprojekt 1 hat zwei Infrastrukturressourcen: Dienst 1 und Dienst 2.
  • Dienstprojekt 2 hat drei Infrastrukturressourcen: Dienst 3, Arbeitslast 1, und Arbeitslast 2.
  • Dienstprojekt 3 hat drei Infrastrukturressourcen: Dienst 4, Arbeitslast 3, und Arbeitslast 4.

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. Der Tab Dienste und Arbeitslasten wird mit einer Liste der registrierten Dienste und Arbeitslasten, die sich in Ihren Dienstprojekten befinden.

  3. Gehen Sie für jeden Dienst oder jede Arbeitslast, den Sie registrieren möchten, so vor:

    1. Klicken Sie auf dem Tab Dienste und Arbeitslasten auf Dienst/Arbeitslast registrieren
    2. Führen Sie im Bereich Dienst oder Arbeitslast registrieren im Menü Wählen Sie im Bereich Dienst oder Arbeitslast auswählen den Dienst oder die Arbeitslast aus. und klicken Sie auf Weiter.
    3. Geben Sie im Abschnitt Attribute hinzufügen einen Namen für den Dienst oder Arbeitsbelastung.
    4. Geben Sie optional in die Felder weitere Details zum Dienst oder zur Arbeitslast ein. die folgenden. Weitere Informationen in diesem Dokument finden Sie unter Vorhandene App Hub-Anwendung aktualisieren Sie müssen einen der angegebenen Werte für Wichtigkeit und Umgebung, aber der Wert kann die sich von den Werten unterscheiden, die Sie beim Erstellen der Anwendung festgelegt haben.
    5. Klicken Sie auf Registrieren. Auf dem Tab Dienste und Arbeitslasten wird der registrierte Dienst oder Arbeitsbelastung. Weitere Informationen zu den Registrierungsstatus finden Sie in der Properties und Attribute von App Hub.

gcloud

  1. Fügen Sie eine Person mit der Berechtigung „App Hub-Bearbeiter“ 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 der Rolle „App Hub-Bearbeiter“ im Hostprojekt. Dieser Wert hat den Wert Format username@yourdomain, z. B. robert.smith@example.com.

  2. Erkannte Arbeitslasten aus Dienstprojekt 2 auflisten, das angehängt ist das Hostprojekt. Dieser Befehl gibt Arbeitslasten zurück, die die für eine Anwendung registriert sind.

    gcloud apphub discovered-workloads list \
      --filter='workload_properties.gcp_project=projects/SERVICE_PROJECT_2' \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Ausgabe sieht in etwa so aus, einschließlich nicht registrierter MIGs:

    ID: [DISCOVERED_WORKLOAD_ID_1]
    WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}
    WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
    
    ID: [DISCOVERED_WORKLOAD_ID_2]
    WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}
    WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
    

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

  3. Registrieren Sie eine Arbeitslast aus dem vorherigen Schritt bei Ihrer Anwendung.

    gcloud apphub applications workloads create WORKLOAD_NAME \
      --discovered-workload='projects/HOST_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID_2' \
      --display-name='mywebserver-deployment1' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Ersetzen Sie Folgendes:

    • WORKLOAD_NAME: ein Name zum Registrieren der Arbeitsbelastung.
    • DISCOVERED_WORKLOAD_ID_2: die Arbeitslast-ID aus die Ausgabe des vorherigen Schritts.
  4. Wiederholen Sie die vorherigen beiden Schritte, um die gewünschten Arbeitslasten zu filtern und zu registrieren. aus Service Project 3.

  5. Optional: Sie können die Arbeitslasten mit criticality-type aktualisieren. environment-type und Inhaberattribute.

    gcloud apphub applications workloads update WORKLOAD_NAME \
      --application=APPLICATION_NAME \
      --criticality-type='CRITICALITY_LEVEL' \
      --environment-type='ENVIRONMENT' \
      --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=REGION
    

    Sie müssen einen der angegebenen Werte für criticality-type und environment-type, aber der Wert kann die sich von den Werten unterscheiden, die Sie beim Erstellen der Anwendung festgelegt haben.

  6. Listen Sie registrierte Arbeitslasten in der Anwendung auf.

    gcloud apphub applications workloads list \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Ausgabe sieht in etwa so aus:

    ID: WORKLOAD_NAME
    DISPLAY_NAME: mywebserver-deployment1
    WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}
    CREATE_TIME: 2023-10-31T18:34:23
    

    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.

  7. Erkannte Dienste mit Weiterleitungsregeln im Dienstprojekt 1 auflisten das an das Hostprojekt angehängt ist. Dieser Befehl gibt Dienste zurück, für eine Anwendung registriert werden können.

    gcloud apphub discovered-services list \
      --filter='service_properties.gcp_project=projects/SERVICE_PROJECT_1 AND service_reference.uri~"forwardingRules"' \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Ausgabe sieht in etwa so aus:

    ID: [DISCOVERED_SERVICE_ID_1]
    SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}
    SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
    
    ID: [DISCOVERED_SERVICE_ID_2]
    SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}
    SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
    

    Kopieren Sie die Dienst-ID DISCOVERED_SERVICE_ID_2 aus der Ausgabe, um sie in zum nächsten Schritt.

  8. Weiterleitungsregel testing-forwarding-rule-2 im Dienst registrieren Projekt 1 als Dienst.

    gcloud apphub applications services create SERVICE_NAME \
      --discovered-service='projects/HOST_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE_ID_2' \
      --display-name='mywebserver-service1' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Ersetzen Sie Folgendes:

    • SERVICE_NAME: ein Name zum Registrieren der Service as.
    • DISCOVERED_SERVICE_ID_2: die Dienst-ID von die Ausgabe des vorherigen Schritts.
  9. Wiederholen Sie die vorherigen Schritte, um Dienste aufzulisten, diese Dienste zu filtern und Registrieren Sie die Dienste in den Dienstprojekten 1, 2 und 3.

  10. Aktualisieren Sie einen Dienst mit dem Attribut criticality-type und dem environment-type-Attribut.

    gcloud apphub applications services update SERVICE_NAME \
      --criticality-type='CRITICALITY_LEVEL' \
      --environment-type='ENVIRONMENT' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID  \
      --location=REGION
    
  11. Listen Sie die registrierten Dienste in der APPLICATION_NAME und HOST_PROJECT_ID Hostprojekt.

    gcloud apphub applications services list \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Ausgabe für jeden Dienst sieht in etwa so aus:

    ID: SERVICE_NAME
    DISPLAY_NAME: mywebserver-service1
    SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}
    CREATE_TIME: 2023-11-01T21:38:08
    

    Registriert, aber getrennte Dienste werden durch einen leeren Wert in der SERVICE_REFERENCE.

  12. Filtern Sie die Dienste in der APPLICATION_NAME und HOST_PROJECT_ID Hostprojekt zu denen, für die das Attribut environment-type auf PRODUCTION.

    gcloud apphub applications services list \
      --filter='attributes.environment.type=PRODUCTION' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

Die Einrichtung des App Hub ist abgeschlossen.

Dienstprojekte hinzufügen oder entfernen

Sie können Dienstprojektanhänge ändern, um eine andere Infrastruktur zu erstellen. Ressourcen, die zur Gruppierung in einer Anwendung zur Verfügung stehen.

Console

So fügen Sie einem Hostprojekt ein Dienstprojekt hinzu:

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

    Einstellungen aufrufen

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

  3. Suchen Sie im daraufhin angezeigten Bereich in der angezeigten Liste nach Projekten. Wählen Sie die Kästchen für die Projekte aus, die Sie als Dienst hinzufügen möchten Projekten.

  4. Klicken Sie auf Auswählen. In der Tabelle Angehängte Dienstprojekte werden die ausgewählten Projekte angezeigt. als Dienstprojekte für das Hostprojekt.

  5. Klicken Sie auf Schließen.

So entfernen Sie ein Dienstprojekt aus einem Hostprojekt:

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

    Einstellungen aufrufen

  2. Klicken Sie auf der Seite Einstellungen die Kästchen für die gewünschten Projekte an. die Sie als Dienstprojekte entfernen möchten.

  3. Klicken Sie auf Projekte trennen. Die Tabelle Angehängte Dienstprojekte wird aktualisiert und zeigt nur die Projekte, die mit dem Hostprojekt verbunden bleiben.

gcloud

So fügen Sie einem Hostprojekt ein Dienstprojekt hinzu:

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID
Ersetzen Sie SERVICE_PROJECT_ID durch den Namen des Dienstprojekt, das Sie dem Hostprojekt hinzufügen möchten. So entfernen Sie ein Dienstprojekt aus dem Hostprojekt:
gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Vorhandene Anwendungen, Dienste und Arbeitslasten ansehen

Sie können Anwendungen in einem Projekt ansehen und Dienste und Arbeitslasten in einem .

Console

  • Rufen Sie in der Google Cloud Console die App Hub-Seite Anwendungen.

    Wechseln Sie zu „Anwendungen“

  • So listen Sie Dienste und Arbeitslasten auf:

    Anwendungen

    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 einer Anwendung. Eine Seite mit einer Liste der Dienste und Arbeitslasten, die für Ihr angezeigt wird.

    3. Optional: So filtern Sie die Dienste oder Arbeitslasten:

      1. Wählen Sie im Feld Filter einen Filter aus, z. B. Wichtigkeit.
      2. Wählen Sie als Wert Hoch aus.
        Eine Liste von Diensten und Arbeitslasten von hoher Wichtigkeit, die die für die Anwendung registriert sind.

    Dienste und Arbeitslasten

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

      Zur Seite „Dienste und Arbeitslasten“

    2. Wählen Sie in der Liste Region die gewünschten Regionen aus. Sehen Sie sich die Dienste und Arbeitslasten an. Wählen Sie beispielsweise us-east1 aus.
      Auf der Seite Dienste und Arbeitslasten werden alle Dienste und aus den angehängten Dienstprojekten, die mit us-east1 an.

    3. Optional: So filtern Sie die Dienste oder Arbeitslasten:

      1. Wählen Sie im Feld Filter einen Filter aus, z. B. Umgebung.
      2. Wählen Sie als Wert Produktion aus.
        Eine Liste der Dienste und Arbeitslasten in der Produktionsumgebung, die für eine Anwendung registriert ist, erscheint.

gcloud

So rufen Sie Anwendungen in einem Projekt auf:

gcloud apphub applications list \
    --project=HOST_PROJECT_ID \
    --location=REGION

So listen Sie registrierte Dienste in einer Anwendung auf:

gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION

So listen Sie registrierte Arbeitslasten in einer Anwendung auf:

gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION

Bereinigen

Vorhandene Anwendung bereinigen und einen Dienstprojektanhang entfernen aus aus dem Hostprojekt, um die mit dem Projekt verknüpften Ressourcen zu entfernen. Dadurch wird der automatische Erkennung von Ressourcen im Dienstprojekt.

Dazu müssen Sie zuerst die Arbeitslasten und Dienste löschen, die im .

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. Eine Liste der für die Anwendung registrierten Dienste und Arbeitslasten wird angezeigt.

  3. Heben Sie die Registrierung eines Dienstes oder einer Arbeitslast auf.

    1. Wählen Sie auf dem Tab Dienste und Arbeitslasten Registrierte Dienste und Arbeitslasten auf den Namen des Dienst oder Arbeitslast, deren Registrierung Sie aufheben möchten.
    2. Klicken Sie auf dem Tab Details auf Registrierung aufheben, um den Dienst zu aktualisieren. Arbeitslast als Ressource vom Typ Erkannt.
      Auf dem Tab Dienste und Arbeitslasten wird in einer Benachrichtigung darauf hingewiesen, dass die Arbeitslast ist nicht registriert.
    3. Wiederholen Sie diese Anleitung für jeden Dienst und jede Arbeitslast.
  4. Rufen Sie im App Hub die Seite Anwendungen auf.

    Wechseln Sie zu „Anwendungen“

  5. Klicken Sie auf den Namen einer Anwendung.

  6. Klicken Sie auf der Seite mit den Anwendungsdetails auf Löschen.

  7. Verwenden Sie in diesem Dokument die Anweisungen unter Zu entfernende Dienstprojekte hinzufügen oder entfernen die Dienstprojekte aus Ihrem Hostprojekt.

gcloud

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

    gcloud apphub applications workloads list \
      --application=APPLICATION_NAME --project=HOST_PROJECT_ID \
      --location=REGION
    
  2. Heben Sie die Registrierung der Arbeitslast von der Anwendung auf:

    gcloud apphub applications workloads delete WORKLOAD_NAME \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Arbeitslast ist jetzt eine erkannte Arbeitslast, die im .

  3. Wiederholen Sie den vorherigen Befehl, um die verbleibenden registrierten Arbeitslasten zu löschen aus der Anwendung.

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

    gcloud apphub applications services list \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    
  5. Heben Sie die Registrierung des Dienstes bei der Anwendung auf:

    gcloud apphub applications services delete SERVICE_NAME \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Der Dienst ist jetzt ein erkannter Dienst, der im .

  6. Wiederholen Sie den vorherigen Befehl, um die Registrierung der verbleibenden registrierten aus der Anwendung zu entfernen.

  7. Löschen Sie die Anwendung:

    gcloud apphub applications delete APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    
  8. Entfernen Sie ein Dienstprojekt aus dem Hostprojekt:

    gcloud apphub service-projects remove SERVICE_PROJECT_ID \
      --project=HOST_PROJECT_ID
    
  9. Wiederholen Sie den vorherigen Befehl, um alle Dienstprojekte vom Host zu entfernen Projekt arbeiten.

Nächste Schritte