設定 Cloud Number Registry

本頁說明如何在機構中設定 Cloud Number Registry。

事前準備

  1. 指定要在這個機構中使用 Cloud Number Registry 的專案。
  2. 選取指定專案，以便執行本指南中的步驟。
  3. 確認您具備完成本指南所需的權限。

必要的角色

如要取得設定及管理 Cloud Number Registry 所需的權限，請要求管理員授予您專案的「Cloud Number Registry IPAM 管理員」 (roles/cloudnumberregistry.ipamAdmin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

建立 IPAM 管理員範圍

建立 IPAM 管理員範圍時，Cloud Number Registry 會執行設定工作，並找出您機構中支援的 Compute Engine 資源，然後將這些資源新增至預設的登錄簿。

系統最多可能需要 24 小時，才會探索到機構中的所有資源。您可以查看 IPAM 管理員範圍的狀態，確認資源探索是否完成。

您可以透過這個預設的儲存庫目錄管理 Cloud Number Registry，也可以選擇建立其他儲存庫目錄來整理資源。

如果嘗試建立 IPAM 管理員範圍時發生錯誤，請參閱「疑難排解」。

控制台

  1. 前往 Google Cloud 控制台的「Cloud Number Registry」頁面。

    前往 Cloud Number Registry

  2. 按一下「管理」分頁標籤。

  3. 在「管理 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 已可供使用。

控制台

  1. 前往 Google Cloud 控制台的「Cloud Number Registry」頁面。

    前往 Cloud Number Registry

  2. 按一下「管理」分頁標籤。

  3. 在「管理 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'

如要解決這個問題，請按照下列步驟操作：

  1. 檢查其他專案是否已為這個機構設定 Cloud Number Registry。

  2. 如果這個機構尚未設定 Cloud Number Registry，請確認這個機構是否已指定專案用於 Cloud Number Registry。

  3. 如果沒有指定專案，請要求貴機構的管理員指定專案，以便搭配 Cloud Number Registry 使用，或授予您相關存取權。

後續步驟