輪替管理員叢集 CA 憑證

您可以輪替 Google Distributed Cloud 管理員叢集中的憑證授權單位 (CA) 憑證,在到期前更新憑證。這些 CA 憑證是透過管理員叢集建立,並會核發 Kubernetes 系統元件用於驗證通訊的憑證。您可以使用 gkectl 執行輪替作業,然後更新 kubeconfig 檔案,輪替作業會使這些檔案失效。本文件僅適用於管理員叢集。如要瞭解使用者叢集,請參閱「輪替使用者叢集 CA 憑證」。

關於管理員叢集 CA 憑證

管理員叢集中的 Kubernetes 系統會使用三個 CA 憑證:

  • etcd CA 憑證可保護 Kubernetes API 伺服器與 etcd 副本之間的通訊,以及 etcd 副本之間的通訊。屬於自行簽署的憑證。

  • 叢集 CA 憑證可保護 Kubernetes API 伺服器與所有內部 Kubernetes API 用戶端 (例如 kubelet、控制器管理工具和排程器) 之間的通訊。這個憑證是自行簽署。

  • 前端 Proxy CA 憑證可保護與匯總 API 的通訊。這個憑證是自行簽署。

您可以使用 gkectl 觸發憑證輪替。在輪替期間,gkectl 會將管理員叢集的核心系統 CA 憑證替換為新產生的憑證。接著,系統會將新的 CA 憑證、分葉憑證和私密金鑰發布至管理員叢集系統元件。輪替會逐步進行,因此系統元件在輪替期間仍可繼續通訊。不過請注意,工作負載和節點會在輪替期間重新啟動。

如果不進行輪替,CA 憑證和控制層憑證會在叢集建立日期後的一段時間後到期。

到期時間取決於叢集類型和建立版本:

  • 進階叢集:
    • 10 年到期
  • 非進階叢集:
    • 1.5 版之前建立:10 年到期
    • 1.5 至 1.16 版建立:5 年到期
    • 1.16 版之後建立:30 年後到期

叢集升級期間,控制層憑證會自動輪替,但 CA 不會自動輪替。也就是說,除了定期升級版本外,還必須在 CA 到期日前執行 CA 輪替。

限制

  • 請注意進階叢集的下列限制:

    • 1.31 版:進階叢集不支援 CA 輪替。
    • 1.32 以上版本:進階叢集支援 CA 輪替,但有部分細微差異,詳情請參閱本文。
  • CA 憑證輪替僅限於前述的 etcd、叢集和 front-proxy 憑證。

  • CA 憑證輪替僅限於 Google Distributed Cloud 自動核發的憑證。即使憑證是由系統 CA 簽署,系統也不會更新由管理員手動核發的憑證。

  • CA 憑證輪替會多次重新啟動 Kubernetes API 伺服器、其他控制層程序,以及管理員叢集中的每個節點。輪替的每個階段都與叢集升級類似。雖然管理員叢集和由管理員叢集管理的使用者叢集在憑證輪替期間仍可運作,但管理員叢集中的工作負載會重新啟動並重新排程。管理員叢集控制層和使用者叢集控制層也會短暫停機。

  • 您必須在憑證輪替期間更新管理員叢集 kubeconfig 檔案,並在輪替完成後再次更新。這是因為舊的叢集憑證已撤銷,kubeconfig 檔案中的憑證將不再有效。

  • CA 憑證輪替作業一旦啟動,就無法復原。

  • 視叢集大小而定,CA 憑證輪替可能需要相當長的時間才能完成。

  • 如果憑證輪替程序中斷,可以重新執行相同指令來繼續執行。不過,請務必確保一次只執行一個輪替指令。

開始輪替

如要開始輪替憑證,請執行下列指令:

gkectl update credentials certificate-authorities rotate \
    --admin-cluster \
    --config ADMIN_CLUSTER_CONFIG \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

更改下列內容:

  • ADMIN_CLUSTER_CONFIG:管理員叢集設定檔的路徑

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

指令的行為會因是否啟用進階叢集而有所不同:

未啟用

gkectl update credentials certificate-authorities rotate 指令會啟動並執行輪替作業的前半部分。接著,指令會暫停,讓您執行下一個指令來更新 kubeconfig 檔案。

更新 kubeconfig 檔案

gkectl update credentials certificate-authorities rotate 指令暫停時,請更新管理員叢集的 kubeconfig 檔案。這會在 kubeconfig 檔案中放置新的用戶端憑證和新的 CA 憑證。舊的用戶端憑證會從 kubeconfig 檔案中移除,而舊的 CA 憑證則會保留在 kubeconfig 檔案中。

gkectl update credentials certificate-authorities update-kubeconfig \
  --admin-cluster \
  --config ADMIN_CLUSTER_CONFIG \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG

繼續輪替

執行下列指令,完成後半段程序。gkectl 驗證更新後的 kubeconfig 檔案位於目前目錄後,指令才會繼續執行。

gkectl update credentials certificate-authorities rotate \
  --admin-cluster \
  --complete \
  --config ADMIN_CLUSTER_CONFIG \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG

輪替完成後,系統會回報目前的 CA 版本。

再次更新 kubeconfig 檔案

輪替作業的後半部完成後,請再次更新 kubeconfig 檔案。這會從 kubeconfig 檔案中移除舊的 CA 憑證。

gkectl update credentials certificate-authorities update-kubeconfig \
  --admin-cluster \
  --config ADMIN_CLUSTER_CONFIG \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG

已啟用

如果啟用進階叢集,gkectl update credentials certificate-authorities rotate 指令會同步執行。隨著 CA 輪替作業進行,指令會將狀態訊息輸出至管理員工作站。

CA 輪替成功後,指令會結束,並自動產生新的 kubeconfig 檔案。您在指令中指定的 kubeconfig 檔案會替換成新檔案。指令輸出類似以下的結果:

Beginning CA rotation with generated CA
...
Successfully rotated CA for admin cluster. The kubeconfig file
"/home/ubuntu/kubeconfig" has been updated.
Done rotating certificate-authorities

發布新的 kubeconfig 檔案

將新的管理員叢集 kubeconfig 檔案發布給所有叢集使用者。