前言¶

在 GKE 上搭生產集羣時，選項很多：Autopilot 還是 Standard、私有節點、Workload Identity、監控組件、Pod 密度、升級策略等。文檔分散在多處，Agent 也容易給出彼此不一致的建議。若你希望有一套「默認就按生產最佳實踐來」的基準，並在偏離時明確權衡，Google 在 google/skills 倉庫的 GKE Golden Path Configuration（gke-golden-path，metadata 版本 1.1.0，分類 Containers）就是面向這類場景的 Agent Skill。

這是什麼¶

gke-golden-path 爲 Agent 提供 GKE golden path 的配置默認值、生產就緒檢查清單，以及集羣默認模式說明。官方描述中的使用邊界是：在設計 GKE 集羣、驗證生產就緒、或將現有配置與 GKE 默認/推薦做法對照時使用；不要用它專門處理工作負載彈性伸縮（應使用 gke-workload-scaling）。節點自動伸縮另有 gke-cluster-autoscaler。

文檔寫明：golden path 是生產集羣推薦的 Autopilot 配置；用戶要求不同設置時，Agent 應採納用戶選擇並說明相關權衡。Skill 還標註可通過 MCP 工具 get_cluster、create_cluster、update_cluster 與 GKE 交互。

核心功能¶

四條工作規則¶

1. 默認走 golden path：除非用戶另有要求；偏離時說明權衡並尊重用戶選擇。
2. 區分 Day-0 與 Day-1：網絡、私有節點、子網、IP 分配等 Day-0 決策在創建後難以更改，需突出提示。
3. 工具優先級：MCP > gcloud > kubectl（MCP 直接對接 GKE API、結構化數據，減少 shell 與解析錯誤）；完整矩陣見 gke-basics。用戶明確要求 gcloud 或 kubectl 時，當次會話遵從用戶。
4. 記錄決策與理由：尤其是 Day-0 選擇與偏離 golden path 的原因。

所需輸入¶

用戶不確定時，用 golden path 默認值。常見輸入包括：

• Project ID（必填）
• Region（必填，如 us-central1）
• Cluster name（必填）
• Environment type：dev/test 或 production（默認 production）
• Networking：自帶 VPC/子網或自動創建（默認自動創建）
• Scale expectations：預期節點/Pod 數量、工作負載類型
• Cost constraints：Spot VM 容忍度、預算等

Always-Apply 默認值（節選）¶

下列爲 Skill 中「推薦默認開啓/取值」的代表項；用戶改設時 Agent 應簡要說明安全或運維權衡。

完整列表以 Skill 內表格爲準。

可協商項¶

部分項有 golden path 默認，但可在有理由時調整；Skill 要求 變更前先詢問。例如：

• dnsEndpointConfig.allowExternalTraffic 默認 true；僅 VPC 內訪問時可收緊。
• maxPodsPerNode 本 golden path 選 48（降低每節點 IP 消耗；非 GKE 全局默認：Standard 常見 110，Autopilot 常見 32）。
• Release channel 默認 REGULAR 及週期性維護窗口；關鍵凍結可參考 gke-upgrades 做維護排除。
• nodeConfig.bootDisk.diskType 默認 pd-balanced；I/O 密集或成本敏感可選用 pd-ssd / pd-standard。

Autopilot 下節點機型由平臺自動選擇（如 describe 輸出中的 ek-standard-8），客戶不可直接指定機型；放置策略通過 ComputeClasses 引導。

Guardrails 與審計¶

• 不請求或輸出密鑰、令牌、服務賬號 JSON。
• 從對話、MCP 或 gcloud config get-value project 解析項目/集羣上下文；無法解析時再問用戶。
• Day-0 先澄清問題再推進；Day-1 提議默認並說明權衡，由客戶確認。
• 不承諾零停機；升級擾動見下文。
• 審計現有集羣時：對照 golden path，報告偏差、嚴重程度與 remediation。

升級擾動（Agent 應如實說明）¶

Skill 明確：任何配置下都不要承諾節點升級零停機。升級會 cordon、drain 節點並驅逐 Pod；drain 在最長約一小時內尊重 PDB 與 terminationGracePeriodSeconds，之後 GKE 會強制驅逐以繼續升級。PDB 可縮小窗口，但不能否決升級。

推薦同時覆蓋四點（不可只提 subset）：

1. PodDisruptionBudgets：minAvailable 避免驅逐最後一個健康副本；永遠無法滿足的 PDB 會拖滿約一小時後仍失敗。
2. 至少 2 副本，並用拓撲分佈約束跨 zone。
3. Readiness probe 反映真實服務健康，便於流量先切走。
4. Surge 升級：默認 maxSurge=1、maxUnavailable=0（每 zone 先增一節點就緒再 drain 舊節點）。

安裝與啓用¶

Skill 來自 Google 官方 Agent Skills 倉庫，與 Cursor、Codex CLI、Claude Code 等支持 agentskills.io 的 Agent 配合使用。倉庫根目錄安裝方式如下：

npx skills add google/skills

按提示選擇具體 Skill（可只選 gke-golden-path 或全量）、目標 Agent，以及安裝範圍（項目或全局）。環境若無 npx，需先安裝 Node.js（含 npm/npx）。

更新已安裝 Skill：

npx skills update

也可通過 skills.sh 安裝入口使用同一倉庫。官方未在資料中區分各 Agent 的額外配置步驟時，以 npx skills add 交互結果爲準。

Skill 源文件路徑：

https://github.com/google/skills/tree/main/skills/cloud/gke-golden-path

典型用法¶

本 Skill 是指導 Agent 行爲的 SKILL.md，不是單獨 CLI。啓用後，常見對話場景包括：

1. 新建生產 Autopilot 集羣：提供 Project ID、Region、集羣名；Agent 按 golden path 填默認，並標出 Day-0 網絡與子網選擇。
2. 生產就緒檢查：對照 Always-Apply 與 Guardrails，列出缺失項（如私有節點、Workload Identity、監控組件、PSS）。
3. 審計現有集羣：通過 MCP get_cluster（或用戶指定的 gcloud）拉取配置，報告與 golden path 的偏差及修復建議。
4. 升級與可用性諮詢：按 Upgrade Disruption 四條建議回答，避免「升級一定無感」的表述。

節點伸縮、HPA/VPA 細節應切換到 gke-cluster-autoscaler 或 gke-workload-scaling；維護窗口與版本通道細節可參考 gke-upgrades；CLI 與 MCP 覆蓋見 gke-basics。

適用場景與注意¶

適合：用 AI Agent 設計或評審 GKE 生產集羣、需要統一默認與安全基線、希望 Day-0 決策被顯式追問的團隊。

注意：

• 默認路徑針對 Autopilot 生產取向；與 Standard 或強定製網絡架構並存時，需主動偏離並記錄權衡。
• 工作負載自動伸縮不在本 Skill 職責內。
• 依賴 Google Cloud MCP 時，需已配置可調用 get_cluster / create_cluster / update_cluster 的環境；用戶堅持 shell 時以 gcloud/kubectl 爲準。
• 版本以 Skill metadata 1.1.0 及倉庫當前 SKILL.md 爲準，升級後可用 npx skills update 同步。

結尾¶

gke-golden-path 把 GKE 生產 Autopilot 的推薦默認值、檢查清單和升級話術收進一個 Skill，減少「每次從零拼配置」和 Agent 口徑不一的問題。安裝與源碼見 google/skills — gke-golden-path。