如要使用 Google Distributed Cloud 軟體建立管理員和使用者叢集 (僅限 VMware),您需要多個Google Cloud 服務帳戶及其 JSON 金鑰。在本文件中,您將建立必要的元件存取權、connect-register 和 logging-monitoring 服務帳戶,並授予所需角色。您也可以為稽核記錄等功能建立選用服務帳戶。如需較短的設定路徑,請參閱「設定最基本的基礎架構」。
事前準備
服務帳戶總覽
建立管理員和使用者叢集之前,您必須具備下列服務帳戶:
- 元件存取服務帳戶
- Connect 註冊服務帳戶
- 記錄/監控服務帳戶
視您要啟用的功能而定,您可能也需要一些選用服務帳戶。
瞭解服務帳戶和 Google Cloud 專案
建立服務帳戶時,您會將其與 Google Cloud 專案建立關聯。這個 Google Cloud 專案稱為服務帳戶的「上層專案」。在本文件中,所有 gcloud iam service-accounts create 指令都會使用預留位置變數 PROJECT_ID,也就是服務帳戶父項專案的專案 ID。
您可以查看服務帳戶的電子郵件地址,判斷服務帳戶的上層專案。舉例來說,以下是名為 logger 的服務帳戶電子郵件地址。上層專案為 alice-123。
logger@alice-123.iam.gserviceaccount.com
將 Identity and Access Management (IAM) 角色授予服務帳戶時,您是將角色授予特定Google Cloud 專案中的服務帳戶。這符合將資源角色授予主體的一般模式。
例如,您可以將 bob-456 專案的 bigquery.dataEditor 角色授予 logger@alice-123.iam.gserviceaccount.com 服務帳戶。在本例中,服務帳戶是主體, Google Cloud 專案則是資源。
您可以將 Google Cloud 專案的角色授予服務帳戶,該專案不一定是服務帳戶的上層專案,也可以是同一個專案。為提供這項彈性,在本文件中,元件存取服務帳戶、connect-register 服務帳戶和 logging-monitoring 服務帳戶的 gcloud projects add-iam-policy-binding 指令會使用預留位置變數 FLEET_HOST_PROJECT_ID。這是機群主專案的 ID。在 gcloud projects add-iam-policy-binding 指令中,您指定為 FLEET_HOST_PROJECT_ID 的 ID 必須相同。
將角色授予服務帳戶的權限
每個服務帳戶都必須在相關Google Cloud 專案中獲得特定角色。舉例來說,您的 connect-register 服務帳戶必須具備機群主專案的 gkehub.editor 角色。
如要授予 Google Cloud 專案的角色,您必須具備該專案的特定權限。詳情請參閱「瞭解角色」中的 roles/resourcemanager.projectIamAdmin。
如果您具備必要權限,可以自行授予角色。否則,貴組織中的其他人員必須為您授予角色。
使用 gkeadm 自動建立服務帳戶
本頁面說明如何手動建立服務帳戶,並為服務帳戶授予角色。除了手動執行這些步驟,您也可以在建立管理員工作站時,讓 gkeadm 指令列工具建立部分服務帳戶並授予角色。即使您允許 gkeadm 建立服務帳戶,仍須手動建立元件存取服務帳戶,並授予必要的 IAM 角色,詳情請參閱下一節。如要進一步瞭解 gkeadm 可建立的服務帳戶,請參閱「建立管理員工作站」。
元件存取服務帳戶
僅限 VMware 的 Google Distributed Cloud 軟體會使用這個服務帳戶,代表您從 Artifact Registry 下載叢集元件。
建立元件存取服務帳戶:
gcloud iam service-accounts create component-access-sa \ --display-name "Component Access Service Account" \ --project PROJECT_ID將
PROJECT_ID替換為要設為服務帳戶上層專案的 Google Cloud 專案 ID。取得新建立的元件存取服務帳戶電子郵件地址:
gcloud iam service-accounts list \ --project PROJECT_ID為元件存取服務帳戶建立 JSON 金鑰:
gcloud iam service-accounts keys create component-access-key.json \ --iam-account COMPONENT_ACCESS_SERVICE_ACCOUNT_EMAIL
將
COMPONENT_ACCESS_SERVICE_ACCOUNT_EMAIL替換為元件存取服務帳戶的電子郵件地址。
將角色授予元件存取服務帳戶
元件存取服務帳戶必須具備專案的下列 IAM 角色。您必須具備下列角色,才能讓 VMware 適用的 Google Distributed Cloud 軟體執行預檢:
serviceusage.serviceUsageVieweriam.roleVieweriam.serviceAccountViewercompute.viewer
授予角色的方法如下:
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member "serviceAccount:COMPONENT_ACCESS_SERVICE_ACCOUNT_EMAIL" \
--role "roles/serviceusage.serviceUsageViewer"
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member "serviceAccount:COMPONENT_ACCESS_SERVICE_ACCOUNT_EMAIL" \
--role "roles/iam.roleViewer"
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member "serviceAccount:COMPONENT_ACCESS_SERVICE_ACCOUNT_EMAIL" \
--role "roles/iam.serviceAccountViewer"
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member "serviceAccount:COMPONENT_ACCESS_SERVICE_ACCOUNT_EMAIL" \
--role "roles/compute.viewer"
將 FLEET_HOST_PROJECT_ID 替換為機群主專案的 ID。這可以是建立服務帳戶的相同專案,也可以是其他專案。您在此指定的專案 ID,必須與您為 connect-register 服務帳戶和 logging-monitoring 服務帳戶授予 IAM 角色時指定的 ID 相同。
Connect 註冊服務帳戶
只有 VMware 適用的 Google Distributed Cloud 軟體會使用這個服務帳戶,將叢集註冊至機群。
建立 connect-register 服務帳戶:
gcloud iam service-accounts create connect-register-sa \ --display-name "Connect-register Service Account" \ --project PROJECT_ID將
PROJECT_ID替換為要設為 connect-register 服務帳戶上層的Google Cloud 專案 ID。取得新建立的 connect-register 服務帳戶電子郵件地址:
gcloud iam service-accounts list \ --project PROJECT_ID為 connect-register 服務帳戶建立 JSON 金鑰:
gcloud iam service-accounts keys create connect-register-key.json \ --iam-account CONNECT_REGISTER_SERVICE_ACCOUNT_EMAIL
將
CONNECT_REGISTER_SERVICE_ACCOUNT_EMAIL替換為 connect-register 服務帳戶的電子郵件地址。將
gkehub.editor角色授予 connect-register 服務帳戶:gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \ --member "serviceAccount:CONNECT_REGISTER_SERVICE_ACCOUNT_EMAIL" \ --role "roles/gkehub.editor"您在此指定的專案 ID,必須與您將 IAM 角色授予元件存取服務帳戶和記錄/監控服務帳戶時指定的 ID 相同。
記錄/監控服務帳戶
只有 VMware 適用的 Google Distributed Cloud 軟體會使用這個服務帳戶,將叢集的記錄和指標匯出至 Cloud Logging 和 Cloud Monitoring。
建立記錄/監控服務帳戶:
gcloud iam service-accounts create logging-monitoring-sa \ --display-name "Logging-monitoring Service Account" \ --project=PROJECT_ID將
PROJECT_ID替換為Google Cloud 專案 ID,該專案將做為記錄監控服務帳戶的父項。取得新建立的記錄/監控服務帳戶電子郵件地址:
gcloud iam service-accounts list \ --project PROJECT_ID為記錄監控服務帳戶建立 JSON 金鑰:
gcloud iam service-accounts keys create logging-monitoring-key.json \ --iam-account LOGGING_MONITORING_SERVICE_ACCOUNT_EMAIL將
LOGGING_MONITORING_SERVICE_ACCOUNT_EMAIL替換為記錄/監控服務帳戶的電子郵件地址。
將角色授予記錄/監控服務帳戶
記錄/監控服務帳戶必須具備下列專案角色:
opsconfigmonitoring.resourceMetadata.writerlogging.logWritermonitoring.metricWritermonitoring.dashboardEditorkubernetesmetadata.publisher
如要將必要角色授予記錄/監控服務帳戶,請按照下列步驟操作:
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member "serviceAccount:LOGGING_MONITORING_SERVICE_ACCOUNT_EMAIL" \
--role "roles/opsconfigmonitoring.resourceMetadata.writer"
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member "serviceAccount:LOGGING_MONITORING_SERVICE_ACCOUNT_EMAIL" \
--role "roles/logging.logWriter"
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member "serviceAccount:LOGGING_MONITORING_SERVICE_ACCOUNT_EMAIL" \
--role "roles/monitoring.metricWriter"
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member "serviceAccount:LOGGING_MONITORING_SERVICE_ACCOUNT_EMAIL" \
--role "roles/monitoring.dashboardEditor"
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member "serviceAccount:LOGGING_MONITORING_SERVICE_ACCOUNT_EMAIL" \
--role "roles/kubernetesmetadata.publisher"
您在此指定的專案 ID,必須與您將 IAM 角色授予元件存取服務帳戶和 connect-register 服務帳戶時指定的 ID 相同。
選用服務帳戶
本節所述的服務帳戶為選用。
稽核記錄服務帳戶
只有 VMware 適用的 Google Distributed Cloud 軟體會使用這個服務帳戶,將 Kubernetes 稽核記錄從叢集傳送至 Cloud 稽核記錄。
如果您打算建立啟用進階叢集的叢集 (設定拓撲網域時必須啟用),請使用記錄/監控服務帳戶和金鑰進行稽核記錄,不要建立其他服務帳戶。
建立稽核記錄服務帳戶:
gcloud iam service-accounts create audit-logging-sa \ --project PROJECT_ID將
PROJECT_ID替換為要設為稽核記錄服務帳戶上層的Google Cloud 專案 ID。取得新建立的稽核記錄服務帳戶電子郵件地址:
gcloud iam service-accounts list \ --project PROJECT_ID為稽核記錄服務帳戶建立 JSON 金鑰:
gcloud iam service-accounts keys create audit-logging-key.json \ --iam-account AUDIT_LOGGING_SERVICE_ACCOUNT_EMAIL
將
AUDIT_LOGGING_SERVICE_ACCOUNT_EMAIL替換為稽核記錄服務帳戶的電子郵件地址。
您不需要將任何角色授予稽核記錄服務帳戶。
二進位授權服務帳戶
VMware 適用的 Google Distributed Cloud (僅限軟體) 會使用這個服務帳戶呼叫 二進位授權 API。
如要瞭解如何建立二進位授權服務帳戶,請參閱「Google Distributed Cloud 中的二進位授權」。