Cloud Number Registry を設定する
このページでは、組織で Cloud Number Registry を設定する方法について説明します。
始める前に
- この組織の Cloud Number Registry に使用するプロジェクトを指定します。
- このガイドの手順を行うプロジェクトを選択します。
- このガイドを完了するために必要な権限があることを確認します。
必要なロール
Cloud Number Registry の設定と管理に必要な権限を取得するには、プロジェクトに対する Cloud Number Registry IPAM 管理者 （roles/cloudnumberregistry.ipamAdmin）IAM ロールの付与を管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
IPAM 管理スコープを作成する
IPAM 管理スコープを作成すると、Cloud Number Registry は設定タスクを実行し、組織内のサポート対象の Compute Engine リソースを特定して、デフォルトのレジストリ ブックに追加します。
組織内のすべてのリソースが検出されるまでに、最長で 24 時間ほどかかることがあります。IPAM 管理スコープのステータスを表示して、リソース検出が完了したかどうかを確認できます。
Cloud Number Registry は、このデフォルトのレジストリ ブックで管理できます。また、必要に応じて追加のレジストリ ブックを作成して、リソースを整理することもできます。
IPAM 管理スコープの作成時にエラーが発生した場合は、トラブルシューティングをご覧ください。
コンソール
Google Cloud コンソールで、[Cloud Number Registry] ページに移動します。
[管理] タブをクリックします。
[IPAM 管理スコープの管理] パネルで、[IPAM 管理スコープを作成] をクリックします。
IPAM 管理のスコープの作成プロセスが開始されます。設定の進行状況を確認するには、IPAM 管理者スコープのステータスを表示します。
gcloud
gcloud alpha number-registry
ipam-admin-scopes create コマンドを使用して IPAM 管理スコープを作成します。
Cloud Number Registry の設定の進行状況を確認するには、IPAM 管理スコープのステータスを表示します。
gcloud alpha number-registry ipam-admin-scopes create SCOPE_NAME \
--enabled-addon-platforms=COMPUTE_ENGINE \
--scopes=organizations/ORGANIZATION_ID \
--location=global
次のように置き換えます。
SCOPE_NAME: IPAM 管理スコープの名前ORGANIZATION_ID: 管理する組織の ID 番号。
IPAM 管理スコープのステータスを表示する
管理スコープは、設定中に次のステータスになることがあります。
SETUP_IN_PROGRESS: セットアップは開始されましたが、検出プロセスが完了していません。組織内の既存のリソースがすべて検出されるまでに、最長で 24 時間ほどかかることがあります。ただし、組織で作成された新しいリソースは数分以内に検出されます。READY_TO_USE: 検出プロセスが完了し、Cloud Number Registry を使用できる状態です。
コンソール
Google Cloud コンソールで、[Cloud Number Registry] ページに移動します。
[管理] タブをクリックします。
[IPAM 管理スコープの管理] パネルで、[状態] フィールドを確認します。
gcloud
gcloud alpha number-registry ipam-admin-scopes describe コマンドを使用して、IPAM 管理スコープの詳細を表示します。
gcloud alpha number-registry ipam-admin-scopes describe SCOPE_NAME \
--location=global
SCOPE_NAME は、IPAM 管理スコープの名前に置き換えます。
トラブルシューティング
以降のセクションでは、Cloud Number Registry の設定時に発生する可能性のある問題を解決する方法について説明します。
IPAM 管理スコープの作成が ALREADY_EXISTS または INVALID_ARGUMENT エラーで失敗する
これらのエラーのいずれかが原因で IPAM 管理スコープの作成に失敗した場合は、プロジェクトに IPAM 管理スコープがすでに存在するためです。
同じ名前の IPAM 管理スコープがこのプロジェクトにすでに存在します。
ALREADY_EXISTS: Resource 'projects/PROJECT_ID/locations/global/ipamAdminScopes/SCOPE_NAME' already exists.
このプロジェクトには、別の名前の IPAM 管理スコープがすでに存在します。
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'
IPAM 管理のスコープの作成が FAILED_PRECONDITION エラーで失敗する
次のエラー メッセージで IPAM 管理スコープの作成が失敗した場合、このプロジェクトがこの組織の Cloud Number Registry に使用するように指定されていないことを意味します。
FAILED_PRECONDITION: There is no existing registry for 'projects/PROJECT_ID in scope organizations/ORGANIZATION_ID'
この問題を解決するには、次の操作を行います。
別のプロジェクトで Cloud Number Registry がこの組織用にすでに設定されているかどうかを確認します。
この組織で Cloud Number Registry が設定されていない場合は、この組織で Cloud Number Registry にプロジェクトがすでに指定されているかどうかを確認します。
プロジェクトが指定されていない場合は、組織の管理者に Cloud Number Registry で使用するプロジェクトを指定するか、そのためのアクセス権を付与するよう依頼してください。