Configura Cloud Number Registry

Questa pagina spiega come configurare Cloud Number Registry nella tua organizzazione.

Prima di iniziare

  1. Designa un progetto da utilizzare per Cloud Number Registry in questa organizzazione.
  2. Seleziona il progetto designato per eseguire i passaggi di questa guida.
  3. Verifica di disporre delle autorizzazioni necessarie per completare questa guida.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare e gestire Cloud Number Registry, chiedi all'amministratore di concederti il ruolo IAM Cloud Number Registry IPAM Admin (roles/cloudnumberregistry.ipamAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un ambito amministratore IPAM

Quando crei l'ambito amministratore IPAM, Cloud Number Registry esegue le attività di configurazione, identifica le risorse Compute Engine supportate nella tua organizzazione e le aggiunge a un libro del registro predefinito.

Potrebbero essere necessarie fino a 24 ore prima che tutte le risorse dell'organizzazione vengano individuate. Puoi visualizzare lo stato dell'ambito di amministrazione IPAM per verificare se l'individuazione delle risorse è completa.

Puoi gestire Cloud Number Registry tramite questo registry book predefinito oppure, facoltativamente, creare registry book aggiuntivi per organizzare le risorse.

Se ricevi un errore quando provi a creare un ambito amministrativo IPAM, consulta la sezione Risoluzione dei problemi.

Console

  1. Nella console Google Cloud , vai alla pagina Cloud Number Registry.

    Vai a Cloud Number Registry

  2. Fai clic sulla scheda Gestisci.

  3. Nel riquadro Gestisci ambito amministratore IPAM, fai clic su Crea ambito amministratore IPAM.

Viene avviato il processo di creazione dell'ambito amministratore IPAM. Per controllare l'avanzamento della configurazione, visualizza lo stato dell'ambito amministrativo IPAM.

gcloud

Crea l'ambito amministratore IPAM utilizzando il comando gcloud alpha number-registry ipam-admin-scopes create.

Per controllare l'avanzamento della configurazione di Cloud Number Registry, visualizza lo stato dell'ambito amministratore IPAM.

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

Sostituisci quanto segue:

  • SCOPE_NAME: un nome per l'ambito amministratore IPAM
  • ORGANIZATION_ID: il numero ID dell'organizzazione che vuoi gestire.

Visualizzare lo stato dell'ambito amministratore IPAM

Durante la configurazione, l'ambito amministrativo può avere i seguenti stati:

  • SETUP_IN_PROGRESS: la configurazione è iniziata, ma la procedura di rilevamento non è completa. Potrebbero essere necessarie fino a 24 ore prima che tutte le risorse esistenti nell'organizzazione vengano rilevate. Tuttavia, le nuove risorse create nell'organizzazione vengono rilevate in pochi minuti.

  • READY_TO_USE: la procedura di rilevamento è completata e Cloud Number Registry è pronto per l'uso.

Console

  1. Nella console Google Cloud , vai alla pagina Cloud Number Registry.

    Vai a Cloud Number Registry

  2. Fai clic sulla scheda Gestisci.

  3. Nel riquadro Gestisci ambito amministratore IPAM, visualizza il campo Stato.

gcloud

Visualizza i dettagli dell'ambito amministrativo IPAM utilizzando il comando gcloud alpha number-registry ipam-admin-scopes describe.

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

Sostituisci SCOPE_NAME con il nome dell'ambito amministrativo IPAM.

Risoluzione dei problemi

Le sezioni seguenti spiegano come risolvere i problemi che potresti riscontrare durante la configurazione di Cloud Number Registry.

La creazione dell'ambito amministratore IPAM non riesce e viene visualizzato l'errore ALREADY_EXISTS o INVALID_ARGUMENT

Se la creazione dell'ambito amministratore IPAM non riesce a causa di uno di questi errori, il motivo è che nel progetto esiste già un ambito amministratore IPAM.

  • In questo progetto esiste già un ambito amministrativo IPAM con lo stesso nome:

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

  • In questo progetto esiste già un ambito amministrativo IPAM con un nome diverso:

    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'

La creazione dell'ambito amministratore IPAM non riesce e viene visualizzato l'errore FAILED_PRECONDITION

Se la creazione di un ambito amministrativo IPAM non va a buon fine e viene visualizzato il seguente messaggio di errore, significa che questo progetto non è stato designato per l'utilizzo di Cloud Number Registry per questa organizzazione.

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

Per risolvere il problema, segui questi passaggi:

  1. Controlla se Cloud Number Registry è già configurato per questa organizzazione in un altro progetto.

  2. Se Cloud Number Registry non è configurato per questa organizzazione, verifica se un progetto è già designato per Cloud Number Registry in questa organizzazione.

  3. Se non è stato designato alcun progetto, chiedi all'amministratore della tua organizzazione di designare un progetto da utilizzare con Cloud Number Registry o di concederti l'accesso per farlo.

Passaggi successivi