服務帳戶和金鑰

如要使用 Google Distributed Cloud 軟體建立管理員和使用者叢集 (僅限 VMware),您需要多個Google Cloud 服務帳戶及其 JSON 金鑰。在本文件中,您將建立必要的元件存取權、connect-register 和 logging-monitoring 服務帳戶,並授予所需角色。您也可以為稽核記錄等功能建立選用服務帳戶。如需較短的設定路徑,請參閱「設定最基本的基礎架構」。

事前準備

建立 Google Cloud 專案。

服務帳戶總覽

建立管理員和使用者叢集之前,您必須具備下列服務帳戶:

  • 元件存取服務帳戶
  • 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 下載叢集元件。

  1. 建立元件存取服務帳戶:

    gcloud iam service-accounts create component-access-sa \
        --display-name "Component Access Service Account" \
        --project PROJECT_ID
    

    將 PROJECT_ID 替換為要設為服務帳戶上層專案的 Google Cloud 專案 ID。

  2. 取得新建立的元件存取服務帳戶電子郵件地址:

    gcloud iam service-accounts list \
        --project PROJECT_ID
    
  3. 為元件存取服務帳戶建立 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.serviceUsageViewer
  • iam.roleViewer
  • iam.serviceAccountViewer
  • compute.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 軟體會使用這個服務帳戶,將叢集註冊至機群。

  1. 建立 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。

  2. 取得新建立的 connect-register 服務帳戶電子郵件地址:

    gcloud iam service-accounts list \
        --project PROJECT_ID
    
  3. 為 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 服務帳戶的電子郵件地址。

  4. 將 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。

  1. 建立記錄/監控服務帳戶:

    gcloud iam service-accounts create logging-monitoring-sa \
        --display-name "Logging-monitoring Service Account" \
        --project=PROJECT_ID
    

    將 PROJECT_ID 替換為Google Cloud 專案 ID,該專案將做為記錄監控服務帳戶的父項。

  2. 取得新建立的記錄/監控服務帳戶電子郵件地址:

    gcloud iam service-accounts list \
        --project PROJECT_ID
    
  3. 為記錄監控服務帳戶建立 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.writer
  • logging.logWriter
  • monitoring.metricWriter
  • monitoring.dashboardEditor
  • kubernetesmetadata.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 稽核記錄。

如果您打算建立啟用進階叢集的叢集 (設定拓撲網域時必須啟用),請使用記錄/監控服務帳戶和金鑰進行稽核記錄,不要建立其他服務帳戶。

  1. 建立稽核記錄服務帳戶:

    gcloud iam service-accounts create audit-logging-sa \
        --project PROJECT_ID
    

    將 PROJECT_ID 替換為要設為稽核記錄服務帳戶上層的Google Cloud 專案 ID。

  2. 取得新建立的稽核記錄服務帳戶電子郵件地址:

    gcloud iam service-accounts list \
        --project PROJECT_ID
    
  3. 為稽核記錄服務帳戶建立 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 中的二進位授權」。

後續步驟

建立管理員工作站