Configurar o Cloud Number Registry

Nesta página, explicamos como configurar o Cloud Number Registry na sua organização.

Antes de começar

  1. Designar um projeto para usar no Cloud Number Registry nesta organização.
  2. Selecione o projeto designado para realizar as etapas deste guia.
  3. Verifique se você tem as permissões necessárias para concluir este guia.

Funções exigidas

Para receber as permissões necessárias para configurar e gerenciar o Cloud Number Registry, peça ao administrador para conceder a você o papel do IAM de Administrador do IPAM do Cloud Number Registry (roles/cloudnumberregistry.ipamAdmin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Criar um escopo de admin do IPAM

Ao criar o escopo de administrador do IPAM, o Cloud Number Registry realiza tarefas de configuração e identifica os recursos compatíveis do Compute Engine na sua organização, adicionando-os a um livro de registro padrão.

Pode levar até 24 horas para que todos os recursos da organização sejam descobertos. Confira o status do escopo de administrador do IPAM para verificar se a descoberta de recursos foi concluída.

É possível gerenciar o Cloud Number Registry com esse livro de registro padrão ou criar outros livros de registro para organizar seus recursos.

Se você receber um erro ao tentar criar um escopo de administrador do IPAM, consulte Solução de problemas.

Console

  1. No console Google Cloud , acesse a página Registro de números do Cloud.

    Acessar o Cloud Number Registry

  2. Clique na guia Gerenciar.

  3. No painel Gerenciar escopo de admin do IPAM, clique em Criar escopo de admin do IPAM.

O processo de criação do escopo de admin do IPAM é iniciado. Para verificar o progresso da configuração, confira o status do escopo de administrador do IPAM.

gcloud

Crie o escopo de administrador do IPAM usando o comando gcloud alpha number-registry ipam-admin-scopes create.

Para verificar o progresso da configuração do Cloud Number Registry, confira o status do escopo de administrador do IPAM.

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

Substitua:

  • SCOPE_NAME: um nome para o escopo de administrador do IPAM.
  • ORGANIZATION_ID: o número de ID da organização que você quer gerenciar.

Ver o status do escopo de admin do IPAM

O escopo de administrador pode ter os seguintes status durante a configuração:

  • SETUP_IN_PROGRESS: a configuração foi iniciada, mas o processo de descoberta não está concluído. Pode levar até 24 horas para que todos os recursos da organização sejam descobertos. No entanto, todos os novos recursos criados na organização são descobertos em poucos minutos.

  • READY_TO_USE: o processo de descoberta está concluído e o Cloud Number Registry está pronto para uso.

Console

  1. No console Google Cloud , acesse a página Registro de números do Cloud.

    Acessar o Cloud Number Registry

  2. Clique na guia Gerenciar.

  3. No painel Gerenciar escopo de admin do IPAM, confira o campo Estado.

gcloud

Confira detalhes sobre o escopo de administrador do IPAM usando o comando gcloud alpha number-registry ipam-admin-scopes describe.

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

Substitua SCOPE_NAME pelo nome do escopo de administrador do IPAM.

Solução de problemas

As seções a seguir explicam como resolver problemas que podem ocorrer ao configurar o Cloud Number Registry.

A criação do escopo de admin do IPAM falha com o erro ALREADY_EXISTS ou INVALID_ARGUMENT

Se a criação do escopo de admin do IPAM falhar devido a um desses erros, isso vai acontecer porque um escopo de admin do IPAM já existe no projeto.

  • Já existe um escopo de administrador do IPAM com o mesmo nome neste projeto:

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

  • Já existe um escopo de administrador do IPAM com um nome diferente neste projeto:

    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'

A criação do escopo de admin do IPAM falha com o erro FAILED_PRECONDITION

Se a criação de um escopo de administrador do IPAM falhar com a seguinte mensagem de erro, isso significa que o projeto não foi designado para uso com o Cloud Number Registry para essa organização.

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

Para resolver esse problema, faça o seguinte:

  1. Verifique se o Cloud Number Registry já está configurado para essa organização em outro projeto.

  2. Se o Cloud Number Registry não estiver configurado para esta organização, verifique se um projeto já está designado para o Cloud Number Registry nesta organização.

  3. Se nenhum projeto estiver designado, peça ao administrador da organização para designar um projeto para uso com o Cloud Number Registry ou conceder acesso para você fazer isso.

A seguir