輪替 KSA 簽署金鑰

如要重新整理 Pod 用於驗證的憑證,可以輪替 Google Distributed Cloud 用來簽署 Kubernetes 服務帳戶 (KSA) 權杖的金鑰組,這些權杖會核發給使用者叢集中的 Pod。輪替作業會取代私密和公開金鑰、重新核發由新私密金鑰簽署的權杖,並提供Google Cloud 新的公開金鑰,用於 Workload Identity 驗證。進階叢集不支援金鑰輪替。

關於 KSA 簽署金鑰

KSA 會為 Pod 中執行的程序提供身分。KSA 與Google Cloud 服務帳戶不同,後者是應用程式用來對 Google Cloud API 進行授權呼叫。

Google Distributed Cloud 會使用私密金鑰簽署核發給 Pod 的 KSA 權杖,並在 Pod 傳送要求至 Kubernetes API 伺服器時,使用對應的公開金鑰驗證權杖。當 Pod 使用 Workload Identity 呼叫 Google Cloud API 時, Google Cloud 會使用相同的公開金鑰驗證 Pod 的身分。建立使用者叢集時,Google Distributed Cloud 會產生金鑰組、將叢集註冊至機群,並將公開金鑰提供給 Google Cloud。

繫結權杖和舊版權杖

Pod 呼叫 Kubernetes API 伺服器時,可以使用舊版權杖或繫結權杖進行驗證和授權。繫結權杖的生命週期有限,並會使用預計磁碟區發布至 Pod。舊版權杖不會過期,並保存在 Kubernetes Secret 中。建議使用繫結權杖,因為這類權杖更安全。

金鑰輪替期間,繫結權杖和舊版權杖都會重新整理。

限制

開始金鑰輪替

開始金鑰輪替前,請考量下列事項:

  • 金鑰輪替期間,您無法啟動其他金鑰輪替、憑證授權單位輪替或叢集更新。

  • 金鑰輪替無法暫停或復原。所有舊金鑰都會刪除。

  • 金鑰輪替會刪除現有叢集節點,並建立新節點。

如要開始輪替金鑰,請按照下列步驟操作:

gkectl update credentials ksa-signing-key rotate \
    --config USER_CLUSTER_CONFIG \
    --kubeconfig ADMIN_KUBECONFIG_FILE \
    [--skip-prompt]

更改下列內容:

  • USER_CLUSTER_CONFIG:使用者叢集設定檔的路徑

  • ADMIN_KUBECONFIG_FILE:管理員叢集 kubeconfig 檔案的路徑

如果不想收到提示,請加入 --skip-prompt。

查看金鑰輪替狀態

如要查看金鑰輪替狀態,請按照下列步驟操作:

gkectl update credentials ksa-signing-key status \
    --config USER_CLUSTER_CONFIG \
    --kubeconfig ADMIN_KUBECONFIG_FILE

如果金鑰輪替已完成,您會看到類似以下的訊息:

State of KSASigningKeyRotation with KSASigningKeyVersion 2 is -
status: True,
reason: KSASigningKeyRotationCompleted,
message:{"tokenVersion":2,"privateKeyVersion":2,"publicKeyVersions":[2]}

如果 KSA 簽署金鑰輪替作業仍在進行中,您會看到類似以下的訊息:

State of KSASigningKeyRotation with KSASigningKeyVersion 2 is -
status: False,
reason: KSASigningKeyRotationProcessedReason,
message:{"tokenVersion":2,"privateKeyVersion":2,"publicKeyVersions":[1,2]}