Diese Seite wurde von der Cloud Translation API übersetzt.

Einzelnes Projekt einrichten

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 für die Grenze auf Projektebene unterscheidet sich von der für die 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 Begrenzung 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 für die Verwaltung von Anwendungen konfiguriertes Projekt bezeichnet.

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

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.
Prüfen Sie, ob die neueste Version der Google Cloud CLI installiert ist:
```
gcloud components update
```
Projekt-ID suchen
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.

App Hub API aktivieren:

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

Hängen Sie das Projekt an sich selbst an, um eine Grenze für die Anwendungsverwaltung zu erstellen:
```
gcloud alpha apphub boundary update \
    --crm-node="projects/$(gcloud projects describe PROJECT_ID --format='value(projectNumber)')" \
    --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.

Prüfen Sie den Status des Anhangs:

gcloud alpha 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_NUMBER
createTime: 2025-08-28T19:04:47Z
updateTime: 2025-08-28T19:04:47Z
type: AUTOMATIC

PROJECT_NUMBER ist die Projektnummer, die Ihrer Projekt-ID entspricht.

Nachdem Sie das Verwaltungsprojekt konfiguriert 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

Wählen Sie in der Google Cloud -Console mit der Projektauswahl das Verwaltungsprojekt aus.
Rufen Sie die Seite IAM auf:

IAM aufrufen
Klicken Sie auf Zugriffsrechte erteilen. Der Bereich Zugriff gewähren wird geöffnet.
Geben Sie im Feld Neue Hauptkonten die E-Mail-Adresse des Hauptkontos ein, dem Sie Zugriff auf App Hub gewähren möchten.
Klicken Sie auf Rolle auswählen und geben Sie App Hub in das Feld Filter ein.
Wählen Sie die App Hub-IAM-Rolle aus, die Sie dem Hauptkonto zuweisen möchten, und klicken Sie auf Speichern.

gcloud

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. my.user@example.com.
- 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:

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.
Prüfen Sie, ob die neueste Version der Google Cloud CLI installiert ist:
```
gcloud components update
```
Projekt-ID suchen
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.
Trennen Sie das Projekt von seiner Grenze, um die Anwendungsverwaltung zu deaktivieren:
```
gcloud alpha apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --clear-crm-node
```
Mit diesem Befehl wird die Grenzressource aktualisiert und die Anlage entfernt. Dadurch wird die Anwendungsverwaltung für das Projekt deaktiviert.
Bestätigen Sie das Abtrennen, indem Sie die Grenze beschreiben:
```
gcloud alpha 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.
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:
```
gcloud services disable apphub.googleapis.com \
    --project=PROJECT_ID
```

Einzelnes Projekt einrichten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.