預先準備的憑證可讓您將 Google Distributed Cloud 軟體 only for VMware 使用者叢集的憑證,儲存在管理員叢集的 Secret 中,因此您不必在管理員工作站中保留密碼和服務帳戶金鑰。您必須先建立 Secret,然後在建立使用者叢集或輪替憑證時參照這些 Secret。
事前準備
如果還沒有管理員叢集,請建立一個。
程序總覽
填寫 Secret 設定檔。
在管理員叢集中建立 Secret 群組。每個 Secret 群組都位於各自的 Kubernetes 命名空間中。
建立使用者叢集。在使用者叢集設定檔中,指明要從管理員叢集特定命名空間的 Secret 取得憑證。
視需要建立其他 Secret 群組和 Secret 版本。
視需要更新現有使用者叢集的憑證。
視需要建立其他使用者叢集。在每個使用者叢集設定檔中,指定 Secret 命名空間。您也可以指定要用於特定憑證的 Secret 版本。
填寫 Secret 設定檔
產生 Secrets 設定檔的範本:
gkectl create-config secrets
上述指令會產生名為 secrets.yaml 的檔案。您可以視需要變更這個檔案的名稱和位置。
請參閱密鑰設定檔文件,熟悉設定檔。建議您在另一個分頁或視窗中保持開啟這份文件。
在 Secrets 設定檔中,填入與您情況相關的值。您必須填寫 namespace 的值,且開頭必須是 gke-onprem-secrets-。
以下是含有一個 Secret 群組的 Secrets 設定檔範例。這個群組包含 vCenter 憑證和四個服務帳戶金鑰的值:
apiVersion: v1
kind: ClusterSecrets
secretGroups:
- namespace: "gke-onprem-secrets-user-cluster-1"
secrets:
vCenter:
username: "my-vcenter-account"
password: "U$icUKEW#INE"
componentAccessServiceAccount:
serviceAccountKeyPath: "my-key-folder/component-access-key.json"
registerServiceAccount:
serviceAccountKeyPath: "my-key-folder/connect-register-key.json"
stackdriverServiceAccount:
serviceAccountKeyPath: "my-key-folder/log-mon-key.json"
cloudAuditLoggingServiceAccount:
serviceAccountKeyPath: "my-key-folder/audit-log-key.json"
建立預先準備的 Secret
在管理員叢集中建立預先準備的 Secret:
gkectl prepare secrets --kubeconfig ADMIN_CLUSTER_KUBECONFIG --secret-config SECRETS_CONFIG
更改下列內容:
ADMIN_CLUSTER_KUBECONFIG:管理員叢集 kubeconfig 檔案的路徑
SECRETS_CONFIG:Secret 設定檔的路徑
查看準備好的 Secret
列出管理員叢集中準備好的 Secret:
gkectl list secrets --kubeconfig ADMIN_CLUSTER_KUBECONFIG
輸出內容範例:
The following secrets have been found:
- namespace: gke-onprem-secrets-user-cluster-1
- secrets with name prefix: component-access-sa-creds
name: component-access-sa-creds.1, version 1, age: 58s
- secrets with name prefix: cloud-audit-logging-service-account-creds
name: cloud-audit-logging-service-account-creds.1, version: 1, age: 58s
- secrets with name prefix: register-service-account-creds
name: register-service-account-creds.1, version: 1, age: 58s
- secrets with name prefix: stackdriver-service-account-creds
name: stackdriver-service-account-creds.1, version: 1, age: 58s
- secrets with name prefix: vsphere-creds
name: vsphere-creds.1, version: 1, age: 58s
您也可以執行 kubectl get secrets,列出命名空間中的 Secret。例如:
kubectl --kubeconfig ADMIN_CLUSTER_KUBECONFIG get secrets --namespace gke-onprem-secrets-user-cluster-1
輸出內容範例:
component-access-sa-creds ... cloud-audit-logging-service-account-creds ... register-service-account-creds.1 ... stackdriver-service-account-creds.1 ... vsphere-creds.1 ...
在上述輸出內容中,您可以看到每個 Secret 名稱都有一個副檔名,指出 Secret 的版本。在本範例中,所有 Secret 的版本都是 1。
建立使用者叢集
請按照「建立使用者叢集」中的操作說明進行。
填寫使用者叢集設定檔時,請輸入 preparedSecrets.namespace 的值。這個值必須與您先前在 Secrets 設定檔中指定的命名空間相符。
範例:
preparedSecrets: namespace: "gke-onprem-secrets-user-cluster-1"
請勿在使用者叢集設定檔中指定下列欄位的值。這些欄位並非必要,因為 VMware 適用的 Google Distributed Cloud 軟體只會從您準備的 Secret 取得憑證和金鑰。
vCenter.credentials.fileRef.pathcomponentAccessServiceAccountKeyPathloadBalancer.f5BigIP.credentials.fileRef.pathgkeConnect.registerServiceAccountKeyPathstackdriver.serviceAccountKeyPathusageMetering.bigQueryServiceAccountKeyPathcloudAuditLogging.serviceAccountKeyPathprivateRegistry.credentials.fileRef.path
在使用者叢集設定檔中,指定要使用的預先準備 Secret 版本。以下範例為五個密鑰分別指定版本 1:
vCenter:
credentials:
secretRef:
version: "1"
...
componentAccessServiceAccountKey:
secretRef:
version: "1"
...
gkeConnect:
registerServiceAccountKey:
secretRef:
version: "1"
...
stackdriver:
serviceAccountKey:
secretRef:
version: "1"
...
cloudAuditLogging:
serviceAccountKey:
secretRef:
version: "1"
version 的值必須是整數字串或「latest」字串。如未指定 version 的值,系統會使用最新版本。
按照「建立使用者叢集」一文所述,完成使用者叢集建立作業。
建立其他預先準備的密鑰
本節說明如何為現有命名空間中的部分 Secret 建立第 2 版。
建立名為 secrets-2.yaml 的新 Secret 設定檔。指定現有命名空間,並提供所選 Secret 的憑證。
範例:
apiVersion: v1
kind: ClusterSecrets
secretGroups:
- namespace: "gke-onprem-secrets-user-cluster-1"
secrets:
stackdriverServiceAccount:
serviceAccountKeyPath: "log-mon-sa-2.json"
cloudAuditLoggingServiceAccount:
serviceAccountKeyPath: "audit-log-sa-2.json"
上述範例為 gke-onprem-secrets-user-cluster-1 命名空間中的下列 Secret 提供金鑰路徑。
stackdriver-service-account-credsSecret 的第 2 版cloud-audit-logging-service-account-credsSecret 的第 2 版
建立新的 Secret:
gkectl prepare secrets --kubeconfig ADMIN_CLUSTER_KUBECONFIG --secret-config secrets-2.yaml
列出管理員叢集中準備好的 Secret:
gkectl --kubeconfig ADMIN_CLUSTER_KUBECONFIG list secrets
輸出內容範例:
The following secrets have been found:
- namespace: gke-onprem-secrets-user-cluster-1
- secrets with name prefix: component-access-sa-creds
name: component-access-sa-creds.1, version 1, age: 11h
- secrets with name prefix: cloud-audit-logging-service-account-creds
name: cloud-audit-logging-service-account-creds.1, version: 1, age: 11h
name: cloud-audit-logging-service-account-creds.2, version: 2, age: 33m
- secrets with name prefix: register-service-account-creds
name: register-service-account-creds.1, version: 1, age: 11h
- secrets with name prefix: stackdriver-service-account-creds
name: stackdriver-service-account-creds.1, version: 1, age: 11h
name: stackdriver-service-account-creds.2, version: 2, age: 33m
- secrets with name prefix: vsphere-creds
name: vsphere-creds.1, version: 1, age: 11h
在上述輸出內容中,您可以看到 stackdriver-service-account-creds Secret 有兩個版本,cloud-audit-logging-service-account-creds Secret 也有兩個版本。
輪替使用者叢集的憑證
本節說明如何為現有使用者叢集輪替所選憑證。
輪替憑證前,請先查看叢集目前使用的 Secret 版本:
gkectl list secrets cluster --cluster-name USER_CLUSTER_NAME --kubeconfig ADMIN_CLUSTER_KUBECONFIG
輸出內容範例:
The following prepared secrets have been used for cluster "user-cluster-1": - namespace: gke-onprem-secrets-user-cluster-1 secret: vsphere-creds.1, version: 1 secret: f5-creds.1, version: 1 secret: component-access-sa-creds.1, version 1 secret: register-service-account-creds.1, version: 1 secret: stackdriver-service-account-creds.1, version: 1 secret: cloud-audit-logging-service-account-creds.1, version: 1
將使用者叢集設定檔複製到名為 user-cluster-update.yaml 的檔案。
在 user-cluster-update.yaml 中,新增 serviceAccountKey 區段。舉例來說,以下範例在 stackdriver 和 cloudAuditLogging 下方有 serviceAccountKey 區段:
stackdriver:
projectID: "my-project-123"
clusterLocation: "us-central1"
serviceAccountKey:
secretRef:
version: "2"
cloudAuditLogging:
projectID: "my-project-123"
clusterLocation: "us-central1"
serviceAccountKey:
secretRef:
version: "latest"
上述範例指定使用者叢集更新時,會使用:
stackdriver-service-account-credsSecret 的第 2 版cloud-audit-logging-service-account-creds密鑰的最新版本。在本範例中,這個版本是第 2 版。
更新使用者叢集的憑證:
gkectl update credentials stackdriver --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config user-cluster-update.yaml gkectl update credentials cloudauditlogging --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config user-cluster-update.yaml
現在,使用者叢集會使用下列預先準備的 Secret:
vsphere-creds的第 1 版component-access-sa-creds的第 1 版register-service-account-creds的第 1 版stackdriver-service-account-creds的第 2 版cloud-audit-logging-service-account-creds的第 2 版
建立其他 Secret 和使用者叢集
如果您打算建立其他使用者叢集,請思考如何整理準備好的 Secret。建議您在管理員叢集中,為每個使用者叢集建立個別的命名空間。或者,您可能想為多個或所有使用者叢集共用相同的預備 Secret 命名空間。
舉例來說,假設 Alice、Bob 和 Carol 各有一個使用者叢集。您可以建立三個 Secret 群組,如以下範例所示:
apiVersion: v1
kind: ClusterSecrets
secretGroups:
- namespace: "gke-onprem-secrets-alice"
secrets:
vCenter:
username: "alice"
password: "zC7r^URDPq2t"
componentAccessServiceAccount:
serviceAccountKeyPath: "component-access-sa-a.json"
registerServiceAccount:
serviceAccountKeyPath: "register-sa-a.json"
stackdriverServiceAccount:
serviceAccountKeyPath: "log-mon-sa-a.json"
cloudAuditLoggingServiceAccount:
serviceAccountKeyPath: "audit-log-sa-a.json"
- namespace: "gke-onprem-secrets-bob"
secrets:
vCenter:
username: "bob"
password: "zC8r^URDPq2t"
componentAccessServiceAccount:
serviceAccountKeyPath: "component-access-sa-b.json"
registerServiceAccount:
serviceAccountKeyPath: "register-sa-b.json"
stackdriverServiceAccount:
serviceAccountKeyPath: "log-mon-sa-b.json"
cloudAuditLoggingServiceAccount:
serviceAccountKeyPath: "audit-log-sa-b.json"
- namespace: "gke-onprem-secrets-carol"
secrets:
vCenter:
username: "carol"
password: "zC9r^URDPq2t"
componentAccessServiceAccount:
serviceAccountKeyPath: "component-access-sa-c.json"
registerServiceAccount:
serviceAccountKeyPath: "register-sa-c.json"
stackdriverServiceAccount:
serviceAccountKeyPath: "log-mon-sa-c.json"
cloudAuditLoggingServiceAccount:
serviceAccountKeyPath: "audit-log-sa-c.json"
隨著時間推移,您可以在每個 Secret 群組中建立其他版本的 Secret。
在使用者叢集設定檔中,提供 serviceAccountKey.secretRef.version 的值,指定要使用的 Secret 版本。您可以將值設為 "latest"、空字串或整數字串。
舉例來說,假設所有 Secret 都有版本 1、2 和 3。假設這是 Alice 的使用者叢集設定檔的一部分。
apiVersion: v1
kind: UserCluster
name: "user-cluster-alice"
preparedSecrets:
namespace: "gke-onprem-secrets-alice"
...
vCenter:
credentials:
gkeConnect:
projectID: "project-a"
registerServiceAccountKey:
secretRef:
version: "2"
stackdriver:
projectID: "project-a"
clusterLocation: "us-central1"
serviceAccountKey:
secretRef:
version: "latest"
cloudAuditLogging:
projectID: "project-a"
clusterLocation: "us-central1"
serviceAccountKey:
secretRef:
version: ""
在上述範例中,我們可以看到:
未指定 vCenter 的
secretRef,因此叢集會使用gke-onprem-secrets-alice命名空間中最新版本的vsphere-credsSecret。叢集會使用
gke-onprem-secrets-alice命名空間中register-service-account-credsSecret 的第 2 版。叢集會使用
gke-onprem-secrets-alice命名空間中最新版本的stackdriver-service-account-credsSecret。在這個範例中,版本為 3。cloudAuditLogging的版本是空字串,因此叢集會使用gke-onprem-secrets-alice命名空間中最新版本的cloud-audit-logging-service-account-credsSecret。在本範例中,該版本為第 3 版。未指定元件存取服務帳戶的
secretRef.version,因此叢集會使用最新版本。
刪除準備好的 Secret
如要列出所有已準備的 Secret 及其命名空間,請執行下列指令:
gkectl list secrets --kubeconfig ADMIN_CLUSTER_KUBECONFIG
如果任何使用者叢集都未使用已準備好的 Secret 命名空間,您可以刪除該命名空間。
如要刪除預先建立的 Secret 命名空間和其中的所有 Secret,請按照下列步驟操作:
gkectl delete secret --namespace PREPARED_SECRET_NAMESPACE \
--kubeconfig ADMIN_CLUSTER_KUBECONFIG
如果任何使用者叢集都未使用個別準備的 Secret,您可以刪除該 Secret。
如要刪除個別預先準備的 Secret,請按照下列步驟操作:
gkectl delete secret --namespace PREPARED_SECRET_NAMESPACE \
--kubeconfig ADMIN_CLUSTER_KUBECONFIG \
--secret-name SECRET