Hostprojekt einrichten (Legacy)

In diesem Dokument wird beschrieben, wie Sie ein Hostprojekt in App Hub einrichten und eine Grenze für mehrere Projekte erstellen.

Das Hostprojekt ist ein altes Anwendungsmodell, das für bestehende App Hub-Nutzer unterstützt wird. Wir empfehlen, für neue Implementierungen Grenzen auf Ordnerniveau zu definieren, indem Sie einen app-fähigen Ordner einrichten. Grenzen auf Ordnerebene bieten Zugriff auf alle anwendungsbezogenen Google Cloud-Funktionen wie Application Design Center und Gemini Cloud Assist. Einen Vergleich der wichtigsten Unterschiede zwischen den verfügbaren Modellen für die Anwendungsverwaltung finden Sie unter Modell für die Anwendungsinstallation auswählen.

Host- und Dienstprojekte – Übersicht

Ein Hostprojekt ist ein Google CloudProjekt, an das Sie andere Projekte anhängen, die die Dienste und Arbeitslasten enthalten, die Sie als App Hub-Anwendungen gruppieren möchten. Die Projekte, die Sie an das Hostprojekt anhängen, werden als Dienstprojekte bezeichnet. Durch das Anhängen des Hostprojekts und der Dienstprojekte wird eine Grenze für mehrere Projekte definiert.

Ein Hostprojekt kann seine eigenen Ressourcen direkt verwalten, indem es sich selbst anhängt. Für die Einrichtung eines einzelnen Projekts empfehlen wir jedoch, den Ansatz für ein einzelnes Projekt zu verwenden.

Wichtig :Das Host- und Dienstprojektmodell in App Hub unterscheidet sich vom Modell, das von freigegebener VPC verwendet wird. Sie können ein Hostprojekt mit freigegebene VPC und die zugehörigen Dienstprojekte nicht für App Hub verwenden. In App Hub dienen Host- und Dienstprojekte zum logischen Gruppieren von Anwendungskomponenten, nicht zum Freigeben von VPC-Netzwerken.

Hinweise

Bevor Sie ein Google Cloud Projekt als Hostprojekt einrichten und Dienstprojekte daran anhängen, führen Sie die folgenden Schritte aus:

1. Identifizieren Sie das Google Cloud -Projekt, das Sie als Hostprojekt verwenden möchten. Sie können ein vorhandenes Projekt verwenden oder ein neues Projekt erstellen.

2. Identifizieren Sie die Google Cloud Projekte, die Sie als Dienstprojekte an das Hostprojekt anhängen möchten. Sie müssen alle Projekte ermitteln, die die Dienste und Arbeitslasten enthalten, die Sie für App Hub-Anwendungen registrieren möchten. Ressourcen in anderen Projekten sind für App Hub nicht sichtbar. Für Dienstprojekte gelten die folgenden Anforderungen:

   • Dienstprojekte müssen sich in derselben Organisation wie das Hostprojekt befinden.
   • Ein Dienstprojekt kann jeweils nur an ein Hostprojekt angehängt werden.
   • Ein Hostprojekt kann als Dienstprojekt für sich selbst fungieren, um seine eigenen Ressourcen zu verwalten. Sie können es jedoch nicht als Dienstprojekt an ein anderes Hostprojekt anhängen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle App Hub Admin (roles/apphub.admin) für das Hostprojekt und für jedes Dienstprojekt, das Sie anhängen möchten, zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Anhängen von Dienstprojekten an das Hostprojekt benötigen. 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.

Hostprojekt einrichten

So konfigurieren Sie ein Google Cloud -Projekt als Hostprojekt:

Console

1. Wählen Sie in der Google Cloud -Console Ihr Projekt über die Projektauswahl aus.

2. So rufen Sie die Seite Übersicht über App Hub auf:

   Zur Übersicht

3. Klicken Sie auf App Hub einrichten.

4. Wählen Sie auf der Seite App Hub aktivieren die Option Vollständige Einrichtung aus, um eine Projektgrenze mit mehreren Projekten zu erstellen.

5. Notieren Sie sich den Projektnamen und die Projekt-ID. Mit diesen Informationen wird das Hostprojekt identifiziert. Sie verwenden diese Werte, um Zugriff zu gewähren.

6. Sehen Sie sich die Liste der APIs an, die aktiviert werden. Für einige APIs fallen Kosten an. Weitere Informationen zu den Kosten von APIs Sie können auch auf die einzelnen APIs klicken, um die zugehörigen Kosten zu sehen.

   Hinweis :Bei diesem Einrichtungsvorgang werden mehrere APIs aktiviert, aber nur App Hub und Application Monitoring unterstützen Hostprojekte. Daher funktionieren andere aktivierte APIs in diesem Legacy-Einrichtungsmodell möglicherweise nicht wie erwartet. Weitere Informationen finden Sie unter Unterstützung von Funktionen nach Grenztyp.

7. Klicken Sie auf Weiter.

8. Prüfen Sie auf dem Tab Grenze definieren Ihre Projektinformationen.

9. Klicken Sie auf  Projekt hinzufügen, um Dienstprojekte zu Ihrem Perimeter hinzuzufügen oder dies später zu tun.

10. Klicken Sie auf Weiter.

11. Wählen Sie auf dem Tab Zugriff gewähren die entsprechenden IAM-Rollen und -Berechtigungen für Administratoren im Projekt aus. Eine Liste der empfohlenen anwendungsbezogenen Rollen fürGoogle Cloud -Produkte finden Sie unter Nutzern anwendungsbezogene Rollen zuweisen.

12. Geben Sie im Feld Neue Hauptkonten die Nutzer, Gruppen oder Dienstkonten ein, die Administratorzugriff auf anwendungsbezogene Aufgaben im Projekt haben sollen.

13. Klicken Sie auf Rollen zuweisen und dann auf Fertigstellen.

Später können Sie Ihren Hauptkonten auf der Seite IAM zusätzliche IAM-Rollen zuweisen. Weitere Informationen finden Sie unter IAM-Rolle über die Google Cloud Console zuweisen.

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:

   gcloud components update
   

3. Suchen Sie die Projekt-ID des Google Cloud -Projekts, das Sie als Hostprojekt konfigurieren möchten.

4. Legen Sie das Hostprojekt als Standardprojekt für Befehle fest:

   gcloud config set project HOST_PROJECT_ID
   

   Ersetzen Sie HOST_PROJECT_ID durch die ID des Projekts, das Sie als Hostprojekt konfigurieren möchten.

5. Aktivieren Sie die App Hub API im Hostprojekt:

   gcloud services enable apphub.googleapis.com \
       --project=HOST_PROJECT_ID
   

Dienstprojekte hinzufügen

Fügen Sie Ihrer Anwendungsverwaltungsbegrenzung Dienstprojekte hinzu, indem Sie sie an das Hostprojekt anhängen.

So hängen Sie Dienstprojekte an das Hostprojekt an und erstellen eine Grenze für mehrere Projekte:

Console

1. Wählen Sie in der Google Cloud Console mit der Projektauswahl das Hostprojekt aus.

   Zur Begrüßungsseite

2. So rufen Sie die Seite Boundary settings (Grenzeinstellungen) im App Hub auf:

   Zu den Grenzeneinstellungen

3. Klicken Sie auf  Projekt hinzufügen.

4. Wählen Sie die Dienstprojekte aus, die Sie an das Hostprojekt anhängen und Ihrer Grenze hinzufügen möchten. Gehen Sie dazu so vor:

   • Wählen Sie in der Projektliste die Kästchen für die Projekte aus, die Sie als Dienstprojekte anhängen möchten.
   • Filtern Sie die Projektnamen und aktivieren Sie die entsprechenden Kästchen.

5. Klicken Sie auf Auswählen.

   In der Tabelle Projekte in Ihrem Perimeter werden die ausgewählten Dienstprojekte angezeigt. Das Anhängen kann einige Zeit dauern.

6. Prüfen Sie, ob die Liste der Dienstprojekte vollständig ist.

gcloud

1. Suchen Sie die Projekt-ID für jedes der Google Cloud Projekte, die Sie als Dienstprojekte konfigurieren möchten.

2. Hängen Sie jedes Dienstprojekt an:

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

   Ersetzen Sie Folgendes:

   • SERVICE_PROJECT_ID: die ID des anzuhängenden Dienstprojekts.
   • HOST_PROJECT_ID: die ID des Hostprojekts.

3. Wiederholen Sie den vorherigen Vorgang für jedes Dienstprojekt, das Sie an das Hostprojekt anhängen möchten.

Terraform

Wenn Sie ein Dienstprojekt mit Terraform an ein Hostprojekt anhängen möchten, verwenden Sie die Ressource google_apphub_service_project_attachment, z. B.:

resource "google_apphub_service_project_attachment" "example" {
    service_project_attachment_id = google_project.service_project.project_id
    depends_on = [time_sleep.wait_120s]
}

resource "google_project" "service_project" {
    project_id ="project-1"
    name = "Service Project"
    org_id = "123456789"
    deletion_policy = "DELETE"
}

resource "time_sleep" "wait_120s" {
    depends_on = [google_project.service_project]

    create_duration = "120s"
}

Informationen zum Trennen eines Dienstprojekts von einem Hostprojekt finden Sie unter Dienstprojekte entfernen.

App Hub-Rollen und ‑Berechtigungen zuweisen

So weisen Sie App Hub-Nutzern im Hostprojekt und in den Dienstprojekten die entsprechenden App Hub-Rollen und -Berechtigungen zu:

Console

1. Wählen Sie in der Google Cloud Console mit der Projektauswahl das Hostprojekt aus.

   Zur Begrüßungsseite

2. Rufen Sie die Seite IAM auf:

   IAM aufrufen

3. Klicken Sie auf Zugriffsrechte erteilen. Der Bereich Zugriff gewähren wird geöffnet.

4. Geben Sie im Feld Neue Hauptkonten die E-Mail-Adresse des Hauptkontos ein, dem Sie Zugriff auf App Hub gewähren möchten.

5. Klicken Sie auf Rolle auswählen und geben Sie App Hub in das Feld Filter ein.

6. Wählen Sie die App Hub-IAM-Rolle aus, die Sie dem Hauptkonto zuweisen möchten, und klicken Sie auf Speichern.

7. Wiederholen Sie in jedem der App Hub-Dienstprojekte, die Sie an das Hostprojekt angehängt haben, den vorherigen Vorgang, um denselben Nutzern dieselben Rollen zuzuweisen.

gcloud

1. Suchen Sie die Projekt-ID der einzelnen Google Cloud Projekte, die Sie als Host- und Dienstprojekte konfiguriert haben.

2. Gewähren Sie Zugriff auf Hauptkonten im Hostprojekt:

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
       --member='user:EMAIL_ADDRESS' \
       --role='ROLE_NAME'
   

   Ersetzen Sie Folgendes:

   • HOST_PROJECT_ID: die ID des Hostprojekts.
   • EMAIL_ADDRESS: die E-Mail-Adresse des Hauptkontos, das im Hostprojekt Zugriff auf App Hub benötigt. Dieser Wert muss das Format username@yourdomain haben, z. B. [e-mail].
   • ROLE_NAME: Die App Hub-IAM-Rolle, die Sie dem Hauptkonto zuweisen möchten, z. B. roles/apphub.admin.

3. Weisen Sie in jedem der App Hub-Dienstprojekte, die Sie an das Hostprojekt angehängt haben, denselben Nutzern dieselben Rollen zu:

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
       --member='user:EMAIL_ADDRESS' \
       --role='ROLE_NAME'
   

   Ersetzen Sie SERVICE_PROJECT_ID durch die ID des Dienstprojekts, für das Sie Zugriff gewähren.

VPC Service Controls einrichten

Wenn Sie Ihre Anwendungen mit einem VPC Service Controls-Perimeter schützen möchten, fügen Sie dem Perimeter Ihr App Hub-Hostprojekt und Ihre Dienstprojekte hinzu, bevor Sie Ihre Anwendungen erstellen. Weitere Informationen finden Sie unter VPC Service Controls mit App Hub verwenden.

Optional: Messwertbereich konfigurieren

Wenn Sie Systemmesswerte für Anwendungen in Ihrem Hostprojekt in Cloud Monitoring aufrufen möchten, fügen Sie die angehängten Dienstprojekte dem Messwertbereich des Hostprojekts hinzu. Das Hostprojekt dient als Scoping-Projekt für Zeitreihendaten und ermöglicht die Darstellung und Überwachung von Daten. Weitere Informationen und Konfigurationsanleitungen finden Sie unter Messwertbereich konfigurieren und Messwertbereich mithilfe der API konfigurieren.

Dienstprojekte entfernen

Entfernen Sie Dienstprojekte aus Ihrer Anwendungsverwaltungsbegrenzung, indem Sie sie vom Hostprojekt trennen.

So trennen Sie ein Dienstprojekt von einem Hostprojekt:

Console

1. Wählen Sie in der Google Cloud Console mit der Projektauswahl das Hostprojekt aus.

   Zur Begrüßungsseite

2. So rufen Sie die Seite Boundary settings (Grenzeinstellungen) über App Hub auf:

   Zu den Grenzeneinstellungen

3. Klicken Sie die Kästchen der Dienstprojekte an, die Sie vom Hostprojekt trennen und aus Ihrem Perimeter entfernen möchten.

4. Klicken Sie auf Projekte trennen.

   Die Tabelle Projekte in Ihrem Grenzbereich wird aktualisiert und enthält nur noch die Projekte, die weiterhin mit dem Hostprojekt verknüpft sind.

5. Prüfen Sie, ob die Liste der Dienstprojekte aktualisiert wurde.

gcloud

1. Suchen Sie die Projekt-ID der einzelnen Dienstprojekte, die Sie aus dem Hostprojekt entfernen möchten.

2. Entfernen Sie jedes Dienstprojekt:

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

   Ersetzen Sie Folgendes:

   • SERVICE_PROJECT_ID: die ID des zu entfernenden Dienstprojekts.
   • HOST_PROJECT_ID: die ID des Hostprojekts.

3. Wiederholen Sie den vorherigen Vorgang für jedes Dienstprojekt, das Sie aus dem Hostprojekt entfernen möchten.

Wichtig :Wenn Sie ein Dienstprojekt aus einem Hostprojekt entfernen, ändert sich der Registrierungsstatus von Diensten und Arbeitslasten aus diesem Projekt, die für Anwendungen registriert sind, in getrennt.

Wenn Sie ein Dienstprojekt aus einem Hostprojekt entfernen, sollten Sie es auch aus dem Messwertbereich des Hostprojekts entfernen, falls Sie den Messwertbereich zuvor konfiguriert haben. Weitere Informationen finden Sie unter Projekte aus einem Messwertbereich entfernen.

Nächste Schritte

• Vorhandene Ressourcen für eine Anwendung registrieren
• Anwendungsmonitoring einrichten
• IAM-Rollen und -Berechtigungen für App Hub
• App Hub – Übersicht