Cloud Number Registry einrichten

Auf dieser Seite wird beschrieben, wie Sie die Cloud Number Registry in Ihrer Organisation einrichten.

Hinweis

  1. Legen Sie ein Projekt fest, das für die Cloud Number Registry in dieser Organisation verwendet werden soll.
  2. Wählen Sie das entsprechende Projekt aus, um die Schritte in dieser Anleitung auszuführen.
  3. Prüfen Sie, ob Sie die Berechtigungen haben, die für diese Anleitung erforderlich sind.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud Number Registry IPAM Admin (roles/cloudnumberregistry.ipamAdmin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Einrichten und Verwalten der Cloud Number Registry 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.

IPAM-Administratorbereich erstellen

Wenn Sie den IPAM-Administratorbereich erstellen, führt die Cloud Number Registry Einrichtungsaufgaben aus, identifiziert unterstützte Compute Engine-Ressourcen in Ihrer Organisation und fügt sie einem Standardregistrierungsbuch hinzu.

Es kann bis zu 24 Stunden dauern, bis alle Ressourcen in der Organisation erkannt werden. Sie können den Status des IPAM-Administratorenbereichs aufrufen, um zu prüfen, ob die Ressourcensuche abgeschlossen ist.

Sie können die Cloud Number Registry über dieses Standard-Registry-Buch verwalten oder optional zusätzliche Registry-Bücher erstellen, um Ihre Ressourcen zu organisieren.

Wenn beim Erstellen eines IPAM-Administratorenbereichs ein Fehler auftritt, lesen Sie den Abschnitt Fehlerbehebung.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cloud Number Registry auf.

    Cloud Number Registry aufrufen

  2. Klicke auf den Tab Verwalten.

  3. Klicken Sie im Bereich IPAM-Administratorbereich verwalten auf IPAM-Administratorbereich erstellen.

Die Erstellung des IPAM-Administratorbereichs wird gestartet. Prüfen Sie den Status des IPAM-Administratorenbereichs, um den Fortschritt der Einrichtung zu sehen.

gcloud

Erstellen Sie den IPAM-Administratorbereich mit dem Befehl gcloud alpha number-registry ipam-admin-scopes create.

Wenn Sie den Fortschritt der Einrichtung der Cloud Number Registry prüfen möchten, sehen Sie sich den Status des IPAM-Administratorbereichs an.

gcloud alpha number-registry ipam-admin-scopes create SCOPE_NAME \
    --enabled-addon-platforms=COMPUTE_ENGINE \
    --scopes=organizations/ORGANIZATION_ID \
    --location=global

Ersetzen Sie Folgendes:

  • SCOPE_NAME: Ein Name für den IPAM-Administratorbereich
  • ORGANIZATION_ID: die ID-Nummer der Organisation, die Sie verwalten möchten.

Status des IPAM-Administratorbereichs ansehen

Der Administratorbereich kann während der Einrichtung die folgenden Status haben:

  • SETUP_IN_PROGRESS: Die Einrichtung wurde gestartet, der Erkennungsprozess ist aber noch nicht abgeschlossen. Es kann bis zu 24 Stunden dauern, bis alle vorhandenen Ressourcen in der Organisation erkannt werden. Neue Ressourcen, die in der Organisation erstellt werden, werden jedoch innerhalb weniger Minuten erkannt.

  • READY_TO_USE: Der Erkennungsprozess ist abgeschlossen und die Cloud Number Registry kann verwendet werden.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cloud Number Registry auf.

    Cloud Number Registry aufrufen

  2. Klicke auf den Tab Verwalten.

  3. Sehen Sie sich im Bereich IPAM-Administratorbereich verwalten das Feld Status an.

gcloud

Rufen Sie mit dem Befehl gcloud alpha number-registry ipam-admin-scopes describe Details zum IPAM-Administratorbereich auf.

gcloud alpha number-registry ipam-admin-scopes describe SCOPE_NAME \
    --location=global

Ersetzen Sie SCOPE_NAME durch den Namen des IPAM-Administratorbereichs.

Fehlerbehebung

In den folgenden Abschnitten wird beschrieben, wie Sie Probleme beheben können, die bei der Einrichtung der Cloud Number Registry auftreten können.

Erstellen des IPAM-Administratorbereichs schlägt mit dem Fehler ALREADY_EXISTS oder INVALID_ARGUMENT fehl

Wenn die Erstellung des IPAM-Administratorbereichs aufgrund eines dieser Fehler fehlschlägt, liegt das daran, dass im Projekt bereits ein IPAM-Administratorbereich vorhanden ist.

  • In diesem Projekt ist bereits ein IPAM-Administratorenbereich mit demselben Namen vorhanden:

    ALREADY_EXISTS: Resource 'projects/PROJECT_ID/locations/global/ipamAdminScopes/SCOPE_NAME'
already exists.

  • In diesem Projekt ist bereits ein IPAM-Administratorbereich mit einem anderen Namen vorhanden:

    INVALID_ARGUMENT: Violation in ipam_admin_scope.scopes: Scope
organizations/ORGANIZATION_ID is already administered by another ipam admin scope
'projects/PROJECT_ID/locations/global/ipamAdminScopes/EXISTING_SCOPE_NAME'

Fehler beim Erstellen des IPAM-Administratorbereichs mit dem Fehler FAILED_PRECONDITION

Wenn die Erstellung eines IPAM-Administratorbereichs mit der folgenden Fehlermeldung fehlschlägt, bedeutet das, dass dieses Projekt nicht für die Verwendung der Cloud Number Registry für diese Organisation vorgesehen ist.

FAILED_PRECONDITION: There is no existing registry for 'projects/PROJECT_ID in scope
organizations/ORGANIZATION_ID'

So beheben Sie das Problem:

  1. Prüfen Sie, ob die Cloud Number Registry für diese Organisation bereits in einem anderen Projekt eingerichtet ist.

  2. Wenn die Cloud Number Registry für diese Organisation nicht eingerichtet ist, prüfen Sie, ob bereits ein Projekt für die Cloud Number Registry in dieser Organisation festgelegt ist.

  3. Wenn kein Projekt festgelegt ist, bitten Sie den Administrator Ihrer Organisation, ein Projekt für die Verwendung mit der Cloud Number Registry festzulegen oder Ihnen Zugriff darauf zu gewähren.

Nächste Schritte