設定中樞

本頁說明如何建立中樞,以便連結不同專案中的 VPC 輪輻。此外,本文也詳細說明如何在建立中樞時,為虛擬私有雲輪輻選取網格或星狀連線拓撲的預設選項。

中樞管理員可以使用 gcloud network-connectivity hubs groups update 指令更新輻射群組。您可以新增專案 ID 或專案編號清單,啟用自動接受功能。啟用自動接受功能後,系統會自動將自動接受專案中的輪輻連線至中樞,不必逐一審查輪輻提案,並進入 ACTIVE 狀態。如果專案未列於自動接受清單,輪輻會維持在 INACTIVE 狀態,直到您審查並接受輪輻為止。

如要列出特定中樞的中心邊緣群組,請使用 gcloud network-connectivity hubs groups list --hub 指令。 如果是使用網狀拓撲建立的中心,輸出內容會傳回預設群組。 如果是以星狀拓撲建立的中心,輸出內容會傳回「中心」和「邊緣」群組。

事前準備

開始設定前,請先詳閱下列各節。

建立或選取專案

為方便設定 Network Connectivity Center,請先找出有效的專案。

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Install the Google Cloud CLI.

  5. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  6. To initialize the gcloud CLI, run the following command:

    gcloud init
  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  8. Make sure that billing is enabled for your Google Cloud project.

  9. Install the Google Cloud CLI.

  10. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  11. To initialize the gcloud CLI, run the following command:

    gcloud init
  12. 如果您使用 Google Cloud CLI,請使用 gcloud config set 指令設定專案 ID。

    gcloud config set project PROJECT_ID

    PROJECT_ID 替換為專屬專案 ID。

    這個頁面的 gcloud CLI 指令假設您已設定專案 ID。

  13. 如要確認專案 ID 設定正確無誤,請使用 gcloud config list 指令

    gcloud config list --format='text(core.project)'
  14. 啟用 Network Connectivity API

    您必須先啟用 Network Connectivity API,才能使用 Network Connectivity Center 執行任何工作。

    控制台

    如要啟用 Network Connectivity API,請按照下列步驟操作:

    1. 在 Google Cloud 控制台中,前往「Network Connectivity Center」頁面。

      前往 Network Connectivity Center

    2. 按一下「啟用」

    或者,您也可以使用Google Cloud 控制台 API 程式庫啟用 API,如「啟用 API」一文所述。

    取得存取權

    如要使用 Network Connectivity Center,您需要具備角色和權限一文所述的權限。

    找出資源

    使用 gcloud CLI 或 API 參照資源時,請採用下表所述的慣例。

    集會/座談 僅支援 附註 範例
    完整 URI 所有資源 請使用下列任一方法參照路由器設備執行個體。
    "https://www.googleapis.com/compute/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME"
    
          
    相對資源名稱 所有資源
    "projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME"
    
        
    名稱 區域和全域資源 這個方法適用於中樞、輪輻、VPN 通道和 VLAN 連結。
     "HUB_NAME"
    
        

    建立中樞

    如要建立中心,請按照下列步驟操作。

    主控台

    1. 在 Google Cloud 控制台中,前往「Network Connectivity Center」頁面。

      前往 Network Connectivity Center

    2. 在專案選單中選取專案。

    3. 按一下「建立中心」

    4. 填妥表單的「基本設定」部分:

      1. 輸入中樞名稱
      2. 選用:輸入說明
      3. 選擇預設拓撲類型
      4. 選用:如要新增標籤,請按一下「新增項目」,然後輸入「鍵」和「值」
      5. 確認表單顯示的專案 ID 正確無誤。如果專案 ID 不正確,請使用頁面頂端的選單選取其他專案。
    5. 在「Private Service Connect connection propagation」(Private Service Connect 連線傳播) 專區中,按一下「開啟」或「關閉」,啟用或停用 Private Service Connect 連線傳播。

    6. 執行下列其中一個步驟:

      • 如要建立連結至這個中樞的輻射網路,請按一下「下一步」,然後填寫表單的輻射網路建立部分。如需操作說明,請參閱建立 VPC 支點
      • 如果目前不想建立 Spoke,請按一下「建立」,完成新 Hub 的建立程序。

    gcloud

    如要建立中樞,請使用 gcloud network-connectivity hubs create 指令

      gcloud network-connectivity hubs create HUB_NAME \
          --policy-mode="POLICY_MODE" \
          --preset-topology="TOPOLOGY_TYPE" \
          --description="DESCRIPTION" \
          --labels="KEY"="VALUE"
    

    如要為 Network Connectivity Center 中樞全域啟用 Private Service Connect 傳播連線,請使用 --export-psc 旗標。

      gcloud network-connectivity hubs create HUB_NAME \
          --description="DESCRIPTION" \
          --labels="KEY"="VALUE" \
          --export-psc
    

    替換下列值:

    • HUB_NAME:新中樞的名稱
    • POLICY_MODE:選用:啟用預設拓撲的政策模式,例如 PRESET
    • TOPOLOGY_TYPE:預設拓撲類型。支援的值為 STARMESH。預設值為 MESH
    • DESCRIPTION:描述中心的選填文字
    • KEY:選用標籤文字的鍵/值組合中的鍵
    • VALUE:選用標籤文字的鍵/值組合中的值

    如要在現有中樞上啟用 Private Service Connect 連線傳播,請參閱「更新中樞」。如要停用現有中樞的 Private Service Connect 連線傳播功能,請使用 --no-export-psc 標記。系統會以非同步方式移除現有的傳播連線。

    API

    如要建立中樞,請使用 networkconnectivity.hubs.create 方法

      POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
      {
        "name":"HUB_NAME",
        "description":"DESCRIPTION",
        "labels": {
          "KEY": "VALUE"
        }
      }
    

    如要選擇預設拓撲,請使用相同方法並指定拓撲:

      POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
      {
        "name":"HUB_NAME",
        "description":"DESCRIPTION",
        "preset_topology": "TOPOLOGY_TYPE"
      }
    

    如要為 Network Connectivity Center 中樞全域啟用 Private Service Connect 傳播連線,請將 export-psc 值設為「true」。

      POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
      {
        "export_psc": true
      }
    

    替換下列值:

    • PROJECT_ID:含有新中樞的專案 ID
    • HUB_NAME:新中樞的名稱
    • DESCRIPTION:描述中心的選填文字
    • KEY:選用標籤文字的鍵/值配對中的鍵
    • VALUE:選用標籤文字的鍵/值組合中的值
    • TOPOLOGY_TYPE:預設拓撲類型。支援的值為 STARMESH。預設值為 MESH

    如要在現有中樞上啟用 Private Service Connect 連線傳播,請參閱「更新中樞」。如要停用現有中樞的 Private Service Connect 連線傳播功能,請將 export_psc 值設為「false」。現有的傳播連線會以非同步方式移除。

    如要進一步瞭解其他 Hub 指令 (例如 list、describe 和 update),請參閱「使用 Hub 和 Spoke」。

    管理 Spoke 群組的自動接受專案

    如要更新 Spoke 群組的自動接受專案,請按照下列步驟操作。

    主控台

    1. 前往 Google Cloud 控制台的「Network Connectivity Center」

      前往 Network Connectivity Center

    2. 在專案選單中,選取中心所在的專案。

    3. 按一下要更新自動接受專案的中心名稱。

    4. 在「中樞詳細資料」頁面的「群組」下方,按一下群組名稱旁的「編輯」。如為網格拓撲連線,則只有一個預設群組。如為星狀拓撲連線,群組為「中心」和「邊緣」

    5. 在「編輯群組」窗格中,執行下列其中一個步驟:

      • 如要新增專案,並自動接受來自這些專案的輪輻,請按一下「新增專案 ID」,然後輸入「專案 ID」。如要新增更多專案,請按一下「新增專案 ID」

      • 如要從自動接受清單中移除專案 ID,請按一下「專案 ID」旁的「刪除」圖示

    6. 按一下 [儲存]

    gcloud

    如要更新 Spoke 群組,請使用 gcloud network-connectivity hubs groups update 指令

    gcloud network-connectivity hubs groups update GROUP_NAME \
      --hub=HUB_NAME \
      --description=DESCRIPTION \
      --add-auto-accept-projects=PROJECT_NAME_1,PROJECT_NAME_2
    

    更改下列內容:

    • GROUP_NAME:群組名稱
    • HUB_NAME:中樞名稱
    • DESCRIPTION:描述群組的選填文字
    • PROJECT_NAME_1PROJECT_NAME_2:以半形逗號分隔的清單,內含一或多個專案 ID 或專案編號,您想為這些專案啟用自動接受功能

    如要從自動接受專案清單中清除所有專案,請使用 --clear-auto-accept-projects 標記。

    gcloud network-connectivity hubs groups update GROUP_NAME \
      --hub=HUB_NAME \
      --description=DESCRIPTION \
      --clear-auto-accept-projects
    

    更改下列內容:

    • GROUP_NAME:群組名稱
    • HUB_NAME:中樞名稱
    • DESCRIPTION:描述中心的選填文字

    如要從自動接受專案清單中移除特定專案,請使用 --remove-auto-accept-projects 標記。

    gcloud network-connectivity hubs groups update GROUP_NAME \
      --hub=HUB_NAME \
      --description=DESCRIPTION \
      --remove-auto-accept-projects=PROJECT_NAME_1,PROJECT_NAME_2
    

    更改下列內容:

    • GROUP_NAME:群組名稱
    • HUB_NAME:中樞名稱
    • DESCRIPTION:描述中心的選填文字
    • PROJECT_NAME_1PROJECT_NAME_2:以逗號分隔的專案 ID 或專案編號清單,列出要停用自動接受功能的專案

    API

    如要更新 Spoke 群組的自動接受專案,請使用

    networkconnectivity.hubs.groups.update 方法

      PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME/groups/GROUP_NAME/updateMask=auto_accept.auto_accept_projects
      {
       "auto_accept": {
           "auto_accept_projects": ["PROJECT_NAME_1","PROJECT_NAME_2"],
        }
      }
    

    更改下列內容:

    • PROJECT_ID:您建立中樞的專案 ID
    • HUB_NAME:中樞名稱
    • GROUP_NAME:群組名稱
    • PROJECT_NAME_1PROJECT_NAME_2:以半形逗號分隔的專案 ID 或專案編號清單,可包含一或多個專案,您要為這些專案新增或移除自動接受功能

    刪除中樞

    如要刪除中樞,請按照下列步驟操作。

    如要刪除中樞,必須先刪除或拒絕所有連結至中樞的輪輻。如果 Spoke 位於其他專案,您可能沒有刪除權限。在這種情況下,您必須拒絕輪輻。

    如要瞭解如何刪除 Spoke,請參閱「刪除 Spoke」。

    主控台

    1. 在 Google Cloud 控制台中,前往「Network Connectivity Center」頁面。

      前往 Network Connectivity Center

    2. 在專案選單中選取專案。

    3. 按一下「Hubs」(中樞) 分頁標籤。

    4. 在中樞裝置清單中,選取要刪除的中樞裝置。

    5. 按一下「Spoke」分頁標籤。系統會列出所有連結至這個中樞的輪輻,以及這些輪輻的狀態。

    6. 從有效 Spoke 清單中刪除有效 Spoke。如果沒有刪除 Spoke 的權限,請拒絕 Spoke

    7. 按一下 「刪除中心」

    8. 在確認對話方塊中,執行下列任一操作:

      • 如不想刪除中樞,請按一下「取消」
      • 按一下「刪除」即可刪除中樞。

    gcloud

    1. 如要列出附加至要刪除中樞的所有有效輪輻,請使用 gcloud network-connectivity hubs list-spokes 指令

      gcloud network-connectivity hubs list-spokes HUB_NAME \
          --filter="state:ACTIVE"
      

      HUB_NAME 替換為要刪除的中心名稱。

    2. 刪除作用中的輪輻。 如果沒有刪除 Spoke 的權限,請拒絕 Spoke

    3. 如要刪除中樞,請使用 gcloud network-connectivity hubs delete 指令

      gcloud network-connectivity hubs delete HUB_NAME
      

      HUB_NAME 替換為中樞名稱。

    API

    1. 如要列出附加至要刪除的中心的所有有效 Spoke,請使用 networkconnectivity.hubs.listSpokes 方法

       GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME:listSpokes
      

      替換下列值:

      • PROJECT_ID:包含要列出 Spoke 的中樞的專案 ID
      • HUB_NAME:要列出 Spoke 的中樞名稱
    2. 刪除作用中的輪輻。 如果沒有刪除 Spoke 的權限,請拒絕 Spoke

    3. 如要刪除中樞,請使用 networkconnectivity.hubs.delete 方法

       DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME
      

      替換下列值:

      • PROJECT_ID:要刪除中樞所屬專案的專案 ID
      • HUB_NAME:要刪除的中心名稱

    後續步驟