本頁說明如何建立中樞,以便連結不同專案中的 VPC 輪輻。此外,本文也詳細說明如何在建立中樞時,為虛擬私有雲輪輻選取網狀或星狀連線拓撲的預設選項。
中樞管理員可以使用 gcloud network-connectivity hubs groups update 指令更新輻射群組。您可以新增專案 ID 或專案編號清單,為子專案啟用自動接受功能。啟用自動接受功能後,系統會自動將自動接受專案中的輪輻連線至中樞,不必逐一審查輪輻提案,並進入 ACTIVE 狀態。如果專案未列於自動接受清單,輪輻會維持 INACTIVE 狀態,直到您審查並接受輪輻為止。
您可以使用 gcloud network-connectivity hubs groups list --hub 指令,將特定中樞的中心和邊緣群組列為巢狀資源。如果是使用網狀拓撲建立的中心,輸出內容會傳回預設群組。
如果是以星狀拓撲建立的中心,輸出內容會傳回 center 和 edge 群組。
事前準備
開始設定前,請先詳閱下列各節。
建立或選取專案
如要輕鬆設定 NCC,請先找出有效的專案。
- 登入 Google Cloud 帳戶。如果您是 Google Cloud新手,歡迎 建立帳戶,親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額,可用於執行、測試及部署工作負載。
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
安裝 Google Cloud CLI。
-
若您採用的是外部識別資訊提供者 (IdP),請先使用聯合身分登入 gcloud CLI。
-
執行下列指令,初始化 gcloud CLI:
gcloud init -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
安裝 Google Cloud CLI。
-
若您採用的是外部識別資訊提供者 (IdP),請先使用聯合身分登入 gcloud CLI。
-
執行下列指令,初始化 gcloud CLI:
gcloud init 如果使用 Google Cloud CLI,請使用
gcloud config set指令設定專案 ID。gcloud config set project PROJECT_ID
將
PROJECT_ID替換為專屬專案 ID。本頁的 gcloud CLI 指令假設您已設定專案 ID。
如要確認專案 ID 設定正確無誤,請使用
gcloud config list指令。gcloud config list --format='text(core.project)'
啟用 Network Connectivity API
您必須先啟用 Network Connectivity API,才能使用 Network Connectivity Center (NCC) 執行任何工作。
控制台
如要啟用 Network Connectivity API,請按照下列步驟操作:
前往 Google Cloud 控制台的「Network Connectivity Center」(網路連線中心) 頁面。
按一下「啟用」。
或者,您也可以使用Google Cloud 控制台 API 程式庫啟用 API,如「啟用 API」一文所述。
取得存取權
如要使用 NCC,您需要「角色和權限」一文所述的權限。
找出資源
使用 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"
|
建立中樞
如要建立中樞,請按照下列步驟操作。
控制台
前往 Google Cloud 控制台的「Network Connectivity Center」(網路連線中心) 頁面。
在專案選單中選取專案。
點選「建立中樞」。
填妥表單的「基本設定」部分:
- 輸入中樞名稱。
- 選用:輸入說明。
- 選擇預設拓撲類型。
- 選用:如要新增標籤,請按一下「新增項目」,然後輸入「鍵」和「值」。
- 確認表單顯示的專案 ID 正確無誤。如果專案 ID 不正確,請使用頁面頂端的選單選取其他專案。
在「Private Service Connect 連線傳播」部分,按一下「開啟」或「關閉」,啟用或停用 Private Service Connect 連線傳播。
執行下列其中一個步驟:
- 如要建立連結至這個中樞的輻射網路,請按一下「下一步」,然後填寫表單的輻射網路建立部分。如需操作說明,請參閱「建立 VPC 輪輻」。
- 如果目前不想建立 Spoke,請按一下「建立」,完成建立新中樞的程序。
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"
如要為 NCC 中樞啟用 Private Service Connect 傳播連線,請使用 --export-psc 旗標。
gcloud network-connectivity hubs create HUB_NAME \
--description="DESCRIPTION" \
--labels="KEY"="VALUE" \
--export-psc
替換下列值:
HUB_NAME:新中樞的名稱POLICY_MODE:選用:啟用預設拓撲的政策模式,例如PRESETTOPOLOGY_TYPE:預設拓撲類型。支援的值為STAR或MESH。預設值為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"
}
如要為 NCC 中樞啟用 Private Service Connect 傳播連線功能,請將 export-psc 值設為「true」。
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
{
"export_psc": true
}
替換下列值:
PROJECT_ID:包含新中樞的專案 IDHUB_NAME:新中樞的名稱DESCRIPTION:描述中心的選填文字KEY:鍵值組中的鍵,用於選用標籤文字VALUE:選用標籤文字的鍵/值組合中的值TOPOLOGY_TYPE:預設拓撲類型。支援的值為STAR或MESH。預設值為MESH。
如要在現有中樞上啟用 Private Service Connect 連線傳播,請參閱「更新中樞」。如要停用現有中樞的 Private Service Connect 連線傳播功能,請將 export_psc 值設為「false」。現有的傳播連線會以非同步方式移除。
如要進一步瞭解其他中樞指令 (例如 list、describe 和 update),請參閱「使用中樞和輪輻」。
管理 Spoke 群組的自動接受專案
如要更新 Spoke 群組的自動接受專案,請按照下列步驟操作。
控制台
前往 Google Cloud 控制台的「Network Connectivity Center」(網路連線中心)。
在專案選單中,選取中心所在的專案。
按一下要更新自動接受專案的中心名稱。
在「中樞詳細資料」頁面的「群組」下方,按一下群組名稱旁的「編輯」。如為網狀拓撲連線能力,則只有一個預設群組。如為星狀拓撲連線,群組為「中心」和「邊緣」。
在「編輯群組」窗格中,執行下列其中一個步驟:
如要新增要自動接受 Spoke 的專案,請按一下「新增專案 ID」,然後輸入「專案 ID」。如要新增更多專案,請按一下「新增專案 ID」。
如要從自動接受清單中移除專案 ID,請按一下「專案 ID」旁的「刪除」。
按一下 [儲存]。
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_1、PROJECT_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_1、PROJECT_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:您建立中樞的專案 IDHUB_NAME:中樞名稱GROUP_NAME:群組名稱PROJECT_NAME_1、PROJECT_NAME_2:以半形逗號分隔的清單,列出一或多個要新增或移除自動接受功能的專案 ID 或專案編號
刪除中樞
如要刪除中樞,請按照下列步驟操作。
如要刪除中樞,必須先刪除或拒絕所有連結至中樞的輪輻。如果 spoke 位於其他專案,您可能沒有刪除權限。在這種情況下,您必須拒絕輪輻。
如要瞭解如何刪除 Spoke,請參閱「刪除 Spoke」。
控制台
前往 Google Cloud 控制台的「Network Connectivity Center」(網路連線中心) 頁面。
在專案選單中選取專案。
按一下「Hubs」(中樞) 分頁標籤。
在中心裝置清單中,選取要刪除的中心裝置。
按一下「Spoke」分頁標籤。系統會列出所有附加至這個中樞的輪輻,以及這些輪輻的狀態。
從有效 Spoke 清單中刪除有效 Spoke。如果沒有刪除 Spoke 的權限,請拒絕 Spoke。
按一下 「刪除中心」。
在確認對話方塊中,執行下列任一操作:
- 如不想刪除中心,請按一下「取消」。
- 按一下「刪除」即可刪除中樞。
gcloud
如要列出附加至要刪除中樞的所有有效 Spoke,請使用
gcloud network-connectivity hubs list-spokes指令。gcloud network-connectivity hubs list-spokes HUB_NAME \ --filter="state:ACTIVE"將
HUB_NAME替換為要刪除的中樞名稱。如要刪除中樞,請使用
gcloud network-connectivity hubs delete指令。gcloud network-connectivity hubs delete HUB_NAME
將
HUB_NAME替換為中樞名稱。
API
如要列出附加至要刪除中樞的所有有效 Spoke,請使用
networkconnectivity.hubs.listSpokes方法。GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME:listSpokes
替換下列值:
PROJECT_ID:專案 ID,用於存放您要列出 Spoke 的中樞HUB_NAME:要列出 Spoke 的中樞名稱
如要刪除中樞,請使用
networkconnectivity.hubs.delete方法。DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME
替換下列值:
PROJECT_ID:要刪除的中樞所在專案的專案 IDHUB_NAME:要刪除的中心名稱
後續步驟
- 如要建立中樞和輪輻,請參閱「與中樞和輪輻搭配使用」。
- 如要查看解決方案已整合 NCC 的合作夥伴清單,請參閱 NCC 合作夥伴。
- 如需常見問題的解決方案,請參閱「疑難排解」。
- 如要瞭解 API 和 Google Cloud CLI 指令的詳細資料,請參閱「API 和參考資料」。