Configurer Cloud Number Registry

Cette page explique comment configurer Cloud Number Registry dans votre organisation.

Avant de commencer

  1. Désignez un projet à utiliser pour Cloud Number Registry dans cette organisation.
  2. Sélectionnez le projet désigné pour suivre les étapes de ce guide.
  3. Vérifiez que vous disposez des autorisations requises pour suivre les instructions de ce guide.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer et gérer Cloud Number Registry, demandez à votre administrateur de vous accorder le rôle IAM Administrateur IPAM Cloud Number Registry (roles/cloudnumberregistry.ipamAdmin) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer un niveau d'accès d'administrateur IPAM

Lorsque vous créez le champ d'application Administrateur IPAM, Cloud Number Registry effectue des tâches de configuration, identifie les ressources Compute Engine compatibles dans votre organisation et les ajoute à un livre de registre par défaut.

Un délai de 24 heures peut être nécessaire pour que toutes les ressources de l'organisation soient découvertes. Vous pouvez afficher l'état du champ d'application de l'administrateur IPAM pour vérifier si la découverte des ressources est terminée.

Vous pouvez gérer le registre des numéros Cloud à l'aide de ce registre par défaut. Vous pouvez également créer des registres supplémentaires pour organiser vos ressources.

Si un message d'erreur s'affiche lorsque vous essayez de créer un champ d'application d'administrateur IPAM, consultez Dépannage.

Console

  1. Dans la console Google Cloud , accédez à la page Cloud Number Registry.

    Accéder au registre des numéros Cloud

  2. Cliquez sur l'onglet Gestion.

  3. Dans le panneau Gérer le niveau d'accès Administrateur IPAM, cliquez sur Créer un niveau d'accès Administrateur IPAM.

Le processus de création du niveau d'accès d'administrateur IPAM commence. Pour vérifier la progression de la configuration, affichez l'état du champ d'application de l'administrateur IPAM.

gcloud

Créez le niveau d'accès d'administrateur IPAM à l'aide de la commande gcloud alpha number-registry ipam-admin-scopes create.

Pour vérifier la progression de la configuration de Cloud Number Registry, consultez l'état du champ d'application Administrateur IPAM.

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

Remplacez les éléments suivants :

  • SCOPE_NAME : nom du champ d'application d'administrateur IPAM
  • ORGANIZATION_ID : numéro d'identification de l'organisation que vous souhaitez gérer.

Afficher l'état du niveau d'accès Administrateur IPAM

L'étendue de l'administrateur peut avoir les états suivants lors de la configuration :

  • SETUP_IN_PROGRESS : la configuration a commencé, mais le processus de découverte n'est pas terminé. Il peut s'écouler jusqu'à 24 heures avant que toutes les ressources existantes de l'organisation soient détectées. Toutefois, les nouvelles ressources créées dans l'organisation sont détectées en quelques minutes.

  • READY_TO_USE : le processus de découverte est terminé et le registre des numéros Cloud est prêt à être utilisé.

Console

  1. Dans la console Google Cloud , accédez à la page Cloud Number Registry.

    Accéder au registre des numéros Cloud

  2. Cliquez sur l'onglet Gestion.

  3. Dans le panneau Gérer le niveau d'accès Administrateur IPAM, consultez le champ État.

gcloud

Affichez les détails du champ d'application de l'administrateur IPAM à l'aide de la commande gcloud alpha number-registry ipam-admin-scopes describe.

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

Remplacez SCOPE_NAME par le nom du champ d'application de l'administrateur IPAM.

Dépannage

Les sections suivantes expliquent comment résoudre les problèmes que vous pouvez rencontrer lors de la configuration de Cloud Number Registry.

Échec de la création du niveau d'accès d'administrateur IPAM avec l'erreur ALREADY_EXISTS ou INVALID_ARGUMENT

Si la création du niveau d'accès d'administrateur IPAM échoue en raison de l'une de ces erreurs, cela signifie qu'un niveau d'accès d'administrateur IPAM existe déjà dans le projet.

  • Une portée d'administration IPAM portant le même nom existe déjà dans ce projet :

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

  • Une portée d'administration IPAM portant un autre nom existe déjà dans ce projet :

    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'

Échec de la création du niveau d'accès d'administrateur IPAM avec l'erreur FAILED_PRECONDITION

Si la création d'un champ d'application d'administrateur IPAM échoue avec le message d'erreur suivant, cela signifie que ce projet n'a pas été désigné pour être utilisé avec Cloud Number Registry pour cette organisation.

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

Pour résoudre ce problème, procédez comme suit :

  1. Vérifiez si Cloud Number Registry est déjà configuré pour cette organisation dans un autre projet.

  2. Si Cloud Number Registry n'est pas configuré pour cette organisation, vérifiez si un projet est déjà désigné pour Cloud Number Registry dans cette organisation.

  3. Si aucun projet n'est désigné, demandez à l'administrateur de votre organisation de désigner un projet à utiliser avec Cloud Number Registry ou de vous accorder l'accès pour le faire.

Étapes suivantes