您可以將一或多個 Google Cloud 專案與各個 Google Distributed Cloud 軟體專用 VMware 叢集建立關聯,以便管理機群註冊、元件存取權,以及記錄和監控功能。每個叢集都會使用機群主專案,以及元件存取服務帳戶的父項專案,這兩者可以是同一個專案。在本文件中,您將選擇這些專案、啟用必要的 API,並找出服務帳戶所需的角色。如需 Google Cloud 專案使用方式的簡短介紹,請參閱「設定最精簡的基礎架構」。
事前準備
機群主專案
每個管理員叢集都必須註冊至機群。由管理員叢集管理的所有使用者叢集,都必須註冊至與管理員叢集相同的機群。
管理員或使用者叢集註冊至機群後,會與機群主專案建立關聯。管理員叢集和其管理的所有使用者叢集,都具有相同的機群主專案。在 Google Cloud 控制台的機群主專案中,您可以查看及管理管理員和使用者叢集。
選擇要當做機群主專案的 Google Cloud 專案。您可以選擇現有專案,也可以建立新專案。記下專案 ID。在後續步驟中,您需要機群主專案的 ID。
在機群主專案中啟用 API
在機群主專案中啟用必要的 API:
Linux 和 macOS
在機群主專案中啟用下列 API:
gcloud services enable --project FLEET_HOST_PROJECT_ID \
anthos.googleapis.com \
container.googleapis.com \
gkehub.googleapis.com \
gkeconnect.googleapis.com \
connectgateway.googleapis.com \
monitoring.googleapis.com \
kubernetesmetadata.googleapis.com \
logging.googleapis.com \
opsconfigmonitoring.googleapis.com \
serviceusage.googleapis.com \
iam.googleapis.com \
cloudresourcemanager.googleapis.com
如要透過Google Cloud 控制台、Google Cloud CLI 或 Terraform 管理叢集的生命週期,請在機群主專案中啟用下列額外 API:
gcloud services enable --project FLEET_HOST_PROJECT_ID \
gkeonprem.googleapis.com \
anthosaudit.googleapis.com \
storage.googleapis.com
Windows
在機群主專案中啟用下列 API:
gcloud services enable --project FLEET_HOST_PROJECT_ID ^
anthos.googleapis.com ^
container.googleapis.com ^
gkehub.googleapis.com ^
gkeconnect.googleapis.com ^
connectgateway.googleapis.com ^
monitoring.googleapis.com ^
kubernetesmetadata.googleapis.com ^
logging.googleapis.com ^
opsconfigmonitoring.googleapis.com ^
serviceusage.googleapis.com ^
iam.googleapis.com ^
cloudresourcemanager.googleapis.com
如要透過Google Cloud 控制台、Google Cloud CLI 或 Terraform 管理叢集的生命週期,請在機群主專案中啟用下列額外 API:
gcloud services enable --project FLEET_HOST_PROJECT_ID ^
gkeonprem.googleapis.com ^
anthosaudit.googleapis.com ^
storage.googleapis.com
將角色授予機群主專案的服務帳戶
您必須為 connect-register 服務帳戶授予機群主專案的特定角色。詳情請參閱「Connect-register 服務帳戶」。
記錄/監控服務帳戶必須具備機群主專案的特定角色。詳情請參閱「Logging 監控服務帳戶」。
稽核記錄服務帳戶必須具備機群主專案的特定角色。詳情請參閱「稽核記錄服務帳戶」。
向機群註冊叢集
建立叢集時,您會將叢集註冊至機群。註冊詳細資料取決於您用來建立叢集的工具:
| 工具 | 如何註冊 |
|---|---|
gkectl | 填寫叢集設定檔中的 gkeConnect.projectID 欄位。 |
| Google Cloud 控制台 | 系統會自動註冊叢集。 您用來建立叢集的 Google Cloud 專案會成為機群主專案。 |
| Terraform | 在 .tfvars 檔案中填寫 project_id 欄位。 |
| gcloud CLI | 呼叫 gcloud container vmware clusters create 時,請提供 --project 的值。 |
元件存取服務帳戶的上層專案
建立叢集前,您必須擁有服務帳戶,且只有 VMware 專用 Google Distributed Cloud 軟體可以使用該帳戶,從 Artifact Registry 下載元件。這個服務帳戶稱為「元件存取服務帳戶」。
您建立元件存取服務帳戶的 Google Cloud 專案,稱為元件存取服務帳戶的「父項」。這個專案可以與機群主專案相同,也可以不同。如要進一步瞭解服務帳戶和父項專案,請參閱「瞭解服務帳戶和 Google Cloud 專案」。
如要為元件存取服務帳戶的父項專案啟用必要 API,請按照下列步驟操作:
Linux 和 macOS
gcloud services enable --project [PARENT_PROJECT_ID] \
serviceusage.googleapis.com \
iam.googleapis.com \
cloudresourcemanager.googleapis.com
Windows
gcloud services enable --project [PARENT_PROJECT_ID] ^
serviceusage.googleapis.com ^
iam.googleapis.com ^
cloudresourcemanager.googleapis.com