Einzelnes Projekt einrichten

Vorschau

Dieses Produkt oder diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

In diesem Dokument wird beschrieben, wie Sie ein einzelnes Google Cloud Projekt zum Verwalten von Anwendungen einrichten. Diese Konfiguration wird auch als Grenze für ein einzelnes Projekt bezeichnet.

In dieser Konfiguration ist das Google Cloud Projekt so konfiguriert, dass es seine eigenen Anwendungen und Komponenten verwaltet und als eigenständiges Verwaltungsprojekt fungiert. Dieser Ansatz ist der schnellste Weg, um mit der Verwaltung von Anwendungen zu beginnen, wenn sich alle Ihre Anwendungskomponenten in diesem einen Projekt befinden. App Hub erkennt automatisch alle unterstützten Ressourcen im Projekt, sodass sie in Anwendungen organisiert werden können.

Beschränkungen

Die Unterstützung von Funktionen in der Grenze für ein einzelnes Projekt unterscheidet sich von der Unterstützung in der Grenze auf Ordnerebene. App Hub, Application Design Center und Application Monitoring unterstützen einzelne Projekte vollständig. Für andere anwendungsbezogene Google Cloud-Dienste wie Cloud Hub und Gemini Cloud Assist ist jedoch eine Abgrenzung auf Ordnerebene erforderlich.

Einen Vergleich der Featureunterstützung zwischen den Modellen auf Einzelprojektebene und auf Ordnerebene finden Sie unter Featureunterstützung nach Grenztyp.

Hinweise

Wählen Sie das Google Cloud -Projekt aus, das Sie zum Verwalten Ihrer Anwendungen verwenden möchten. Dieses Projekt dient als eigenständiges Verwaltungsprojekt. Sie können ein vorhandenes Projekt verwenden oder ein neues erstellen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, das Sie als eigenständiges Verwaltungsprojekt konfigurieren möchten, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren eines einzelnen Projekts für die Anwendungsverwaltung benötigen:

• Ressourcen, Berechtigungen und Abrechnung für das Projekt verwalten: Projektinhaber (roles/owner)
• Alle Anwendungskomponenten im Projekt verwalten: 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.

Anwendungsverwaltung für ein Projekt aktivieren

Bei dieser Aktion wird das Projekt als eigenständiges Verwaltungsprojekt konfiguriert und die erforderlichen APIs für Anwendungsmetadaten und -konfigurationen werden aktiviert. Das Projekt wird dann als Projekt mit aktivierter App-Verwaltung bezeichnet.

So aktivieren Sie die Anwendungsverwaltung für ein einzelnes Projekt:

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.

   Wenn sich Ihr Projekt bereits in einem app-fähigen Ordner befindet, wird die Option App Hub einrichten auf der Seite nicht angezeigt. Stattdessen werden Sie in einem Menü aufgefordert, entweder den für Anwendungen aktivierten Ordner oder das aktuelle Projekt auszuwählen. Wählen Sie das aktuelle Projekt aus, um mit der Einrichtung für ein einzelnes Projekt fortzufahren. Weitere Informationen zur Ressourcenhierarchie für die Anwendungsverwaltung finden Sie unter Ressourcenhierarchie für die Anwendungsverwaltung planen.

4. Wählen Sie auf der Seite App Hub aktivieren eine der folgenden Optionen aus:

   • Schnelle Einrichtung: Verwalten Sie eine Standardkonfiguration für Ressourcen in diesem Projekt und definieren Sie Ihre erste Anwendung für die erste Einführung.
   • Vollständige Einrichtung: Sie können benutzerdefinierte Konfigurationen für Ihre Anwendungen verwalten, einschließlich der Einrichtung von Vorab-Zugriffskontrollen und optional dem Hinzufügen weiterer Projekte für Grenzen für mehrere Projekte.

5. Notieren Sie sich den Projektnamen und die Projekt-ID. Mit diesen Informationen wird das Verwaltungsprojekt 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.

7. Klicken Sie auf Weiter.

8. Schließen Sie die Einrichtung entsprechend Ihrer Auswahl ab:

   • Wenn Sie Schnelle Einrichtung ausgewählt haben, können Sie auf dem Tab Anwendung definieren optional eine Anwendung definieren oder die Einrichtung ohne Anwendung abschließen. Jetzt können Sie Anwendungen erstellen und Ressourcen darin registrieren. Sie können auch mit einer Kurzanleitung für Anwendungen beginnen.

   • Wenn Sie Vollständige Einrichtung ausgewählt haben, gewähren Sie Ihren Administratoren benutzerdefinierten anwendungsbezogenen Zugriff:

     1. Prüfen Sie auf dem Tab Grenze definieren Ihre Projektinformationen. In der Tabelle Projekte in Ihrer Begrenzung wird nur das Projekt angezeigt, das Ihre Begrenzung für ein einzelnes Projekt definiert. Fügen Sie bei der Einrichtung der Begrenzung für ein einzelnes Projekt keine zusätzlichen Projekte hinzu.

     2. Klicken Sie auf Weiter.

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

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

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

     Sie können jetzt mit Application Design Center vorhandene Ressourcen für eine Anwendung registrieren oder eine Anwendungsvorlage erstellen.

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. Projekt-ID suchen

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

   gcloud config set project PROJECT_ID
   

   Ersetzen Sie PROJECT_ID durch die ID des Projekts.

5. App Hub API aktivieren:

   gcloud services enable apphub.googleapis.com \
       --project PROJECT_ID
   

6. Hängen Sie das Projekt an sich selbst an, um eine Grenze für die Anwendungsverwaltung zu erstellen:

   gcloud apphub boundary update \
       --crm-node=projects/PROJECT_ID \
       --project=PROJECT_ID \
       --location=global
   

   Mit diesem Befehl wird das Projekt als eigenes Verwaltungsprojekt konfiguriert, sodass App Hub automatisch alle unterstützten Ressourcen darin erkennen kann.

7. Prüfen Sie den Status des Anhangs:

   gcloud apphub boundary describe \
       --project=PROJECT_ID \
       --location=global
   

   Die Ausgabe sollte in etwa so aussehen:

   name: projects/PROJECT_ID/locations/LOCATION/boundary
   crmNode: projects/PROJECT_ID
   createTime: 2025-08-28T19:04:47Z
   updateTime: 2025-08-28T19:04:47Z
   type: AUTOMATIC
   

Wenn Sie die Konfiguration des Verwaltungsprojekts abgeschlossen haben, sind die erforderlichen APIs für die Anwendungsverwaltung aktiviert und Sie können mit App Hub beginnen, Dienste und Arbeitslasten in Anwendungen zu gruppieren. Optional können Sie sich empfohlene APIs ansehen, um auf erweiterte Funktionen zuzugreifen.

App Hub-Rollen und ‑Berechtigungen zuweisen

Damit Nutzer Anwendungskomponenten in diesem Projekt über App Hub finden, registrieren und verwalten können, müssen Sie ihnen die entsprechenden App Hub-Rollen und ‑Berechtigungen zuweisen.

Gehen Sie so vor:

Console

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

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.

gcloud

1. Zugriff auf Hauptkonten im Verwaltungsprojekt gewähren:

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

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die ID des Verwaltungsprojekts.
   • EMAIL_ADDRESS: die E-Mail-Adresse des Hauptkontos, das App Hub-Zugriff 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.

Grenze für die Anwendungsverwaltung ändern

Wenn Sie das Projekt ändern möchten, das die Grenze für ein einzelnes Projekt definiert, deaktivieren Sie die Anwendungsverwaltung im alten Projekt und aktivieren Sie sie im neuen Projekt. Ihre Anwendungsdaten werden nicht migriert und Sie müssen Ihre Anwendungen im neuen Projekt neu erstellen.

Wenn Sie von einer Grenze auf Projektebene zu einer Grenze auf Ordnerebene wechseln möchten, richten Sie einen für die App aktivierten Ordner ein. Durch diese Aktion wird ein neues Verwaltungsprojekt im Ordner konfiguriert. Sie müssen Anwendungen in diesem neuen Verwaltungsprojekt neu erstellen.

Anwendungsverwaltung für ein Projekt deaktivieren

Sie können die Anwendungsverwaltung für ein Projekt deaktivieren, wenn Sie die zugehörigen Ressourcen nicht mehr in App Hub-Anwendungen verwalten möchten.

Wenn Sie die Anwendungsverwaltung für das Projekt deaktivieren, wird das Projekt von seiner Grenze für die Anwendungsverwaltung getrennt. Die Dienste und Arbeitslasten in Ihren Anwendungen sind weiterhin vorhanden, aber ihr Registrierungsstatus ändert sich zu „getrennt“. Wenn Sie sich entscheiden, die Anwendungsverwaltung für das Projekt wieder zu aktivieren, kann App Hub Ihre Anwendungen, Dienste und Arbeitslasten neu erkennen und den Registrierungsstatus aktualisieren, sofern die zugrunde liegenden Ressourcen noch vorhanden sind.

So deaktivieren Sie die Anwendungsverwaltung für ein einzelnes Projekt:

Console

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

   Zur Begrüßungsseite

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

   Zu den Grenzeneinstellungen

3. Klicken Sie das Kästchen des Projekts an, um es von der Grenze zu trennen und die Anwendungsverwaltung zu deaktivieren.

4. Klicken Sie auf Projekte trennen.

   Die Tabelle Projekte in Ihrem Grenzbereich wird aktualisiert und Ihre Projektinformationen werden nicht mehr angezeigt.

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. Projekt-ID suchen

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

   gcloud config set project PROJECT_ID
   

   Ersetzen Sie PROJECT_ID durch die ID des Projekts.

5. Trennen Sie das Projekt von seiner Begrenzung, um die Anwendungsverwaltung zu deaktivieren:

   gcloud apphub boundary update \
       --project=PROJECT_ID \
       --location=global \
       --crm-node=""
   

   Mit diesem Befehl wird die Grenzressource aktualisiert und die Anlage entfernt. Dadurch wird die Anwendungsverwaltung für das Projekt deaktiviert.

6. Bestätigen Sie die Abtrennung, indem Sie die Grenze beschreiben:

   gcloud apphub boundary describe \
       --project=PROJECT_ID \
       --location=global
   

   Die Ausgabe enthält kein Feld crmNode. Das bestätigt, dass die Anwendungsverwaltung für das Projekt deaktiviert ist.

7. Optional können Sie alle Anwendungen im Projekt löschen und dann die App Hub API deaktivieren, wenn Sie die Anwendungsfunktionen in diesem Projekt nicht mehr verwenden möchten:

   gcloud services disable apphub.googleapis.com \
       --project=PROJECT_ID
   

Nächste Schritte

• Kurzanleitung: Anwendung aus vorhandenen Ressourcen erstellen
• Ressourcen für eine Anwendung registrieren
• Anwendungsmonitoring einrichten
• IAM-Rollen und -Berechtigungen für App Hub
• App Hub – Übersicht