在 Kubernetes（K8s）的 YAML 配置中，GKV 是三個(gè)核心概念的縮寫(xiě)，分別對(duì)應(yīng) Group（API 組）、Version（版本）、Kind（資源類(lèi)型）。

它們共同標(biāo)識(shí)了一個(gè) Kubernetes 資源的“身份”，是理解和編寫(xiě) K8s 配置的基礎(chǔ)。

1. GKV 具體含義與作用

Kubernetes 的 API 體系通過(guò) GKV 對(duì)資源進(jìn)行分類(lèi)和版本管理，確保資源的擴(kuò)展性、兼容性和可維護(hù)性。

（1）Group（API 組）

含義：將功能相關(guān)的資源歸類(lèi)到同一個(gè)“組”中，類(lèi)似“命名空間”，用于區(qū)分不同功能領(lǐng)域的資源。

作用：避免資源名稱(chēng)沖突，方便管理和擴(kuò)展（比如新增資源時(shí)只需加入對(duì)應(yīng)的組）。

常見(jiàn)示例：

• apps：包含 Deployment、StatefulSet、DaemonSet 等工作負(fù)載資源。
• batch：包含 Job、CronJob 等批處理資源。
• networking.k8s.io：包含 Ingress、NetworkPolicy 等網(wǎng)絡(luò)相關(guān)資源。
• 核心組（無(wú)組名）：最基礎(chǔ)的資源（如 Pod、Service、ConfigMap），API 組為空。

（2）Version（版本）

含義：同一 API 組內(nèi)的資源可能有多個(gè)版本，用于標(biāo)識(shí)資源定義的演進(jìn)（字段增減、行為變更等）。

作用：支持資源的平滑升級(jí)和兼容性保障（不同版本可以并存，逐步遷移）。

版本類(lèi)型：

• v1：穩(wěn)定版本（Stable），字段和行為不會(huì)輕易變更，適合生產(chǎn)環(huán)境。
• v1beta1/v2alpha1：beta（測(cè)試）或 alpha（預(yù)覽）版本，可能包含實(shí)驗(yàn)性特性，不建議生產(chǎn)使用（可能會(huì)刪除或修改）。

常見(jiàn)示例：

• apps/v1：apps 組的穩(wěn)定版本（Deployment、StatefulSet 等均使用此版本）。
• batch/v1：batch 組的穩(wěn)定版本（Job、CronJob 等）。
• networking.k8s.io/v1：網(wǎng)絡(luò)組的穩(wěn)定版本（Ingress 等）。

（3）Kind（資源類(lèi)型）

含義：標(biāo)識(shí)具體的資源“類(lèi)型”，即你要操作的對(duì)象（如創(chuàng)建一個(gè) Deployment 還是一個(gè) Pod）。

作用：明確 YAML 配置描述的是哪種資源，Kubernetes 會(huì)根據(jù) Kind 解析配置并執(zhí)行對(duì)應(yīng)的操作。

常見(jiàn)示例：

• Pod：最小部署單元。
• Service：服務(wù)發(fā)現(xiàn)與負(fù)載均衡。
• Deployment：無(wú)狀態(tài)應(yīng)用的編排。
• StatefulSet：有狀態(tài)應(yīng)用的編排。
• ConfigMap：配置存儲(chǔ)。

2. GKV 在 YAML 配置中的體現(xiàn)

每個(gè) K8s 資源的 YAML 配置開(kāi)頭，必然包含 apiVersion 和 kind 字段，這兩個(gè)字段直接體現(xiàn)了 GKV：

• apiVersion: <Group>/<Version>（核心組資源的 apiVersion 僅為 <Version>，如 v1）。
• kind: <Kind>。

示例 1：Deployment（屬于 apps 組）

apiVersion: apps/v1  # Group=apps，Version=v1
kind: Deployment     # Kind=Deployment
metadata:
  name: nginx-deploy
spec:
  replicas: 3
  # ... 其他配置

示例 2：Service（屬于核心組，無(wú) Group 名）

apiVersion: v1       # 核心組（無(wú)Group），Version=v1
kind: Service        # Kind=Service
metadata:
  name: nginx-svc
spec:
  ports:
  - port: 80
  # ... 其他配置

示例 3：Ingress（屬于 networking.k8s.io 組）

apiVersion: networking.k8s.io/v1  # Group=networking.k8s.io，Version=v1
kind: Ingress                     # Kind=Ingress
metadata:
  name: nginx-ingress
spec:
  rules:
  # ... 其他配置

3. 為什么 GKV 很重要？

• 資源識(shí)別：Kubernetes 集群通過(guò) GKV 確定如何解析 YAML 配置（比如 Deployment 和 StatefulSet 的配置結(jié)構(gòu)不同，通過(guò) Kind 區(qū)分）。
• 版本兼容：不同版本的資源可能有不同的字段（如舊版本的 extensions/v1beta1 Deployment 和 apps/v1 Deployment 字段有差異），使用錯(cuò)誤版本會(huì)導(dǎo)致部署失敗。
• 操作正確性：執(zhí)行 kubectl 命令時(shí)，也依賴(lài) GKV 識(shí)別資源（如 kubectl get deployments.apps 明確指定“apps 組的 deployments 資源”）。

4. 如何查詢(xún)資源的 GKV？

通過(guò) kubectl api-resources 命令可以列出所有資源的 GKV 信息：

kubectl api-resources

輸出示例（部分）：

NAME                              SHORTNAMES   APIVERSION                             NAMESPACED   KIND
deployments                       deploy       apps/v1                               true         Deployment
services                          svc          v1                                    true         Service
ingresses                         ing          networking.k8s.io/v1                  true         Ingress
jobs                                          batch/v1                               true         Job

• APIVERSION 列：對(duì)應(yīng) Group/Version（核心組僅顯示 Version）。
• KIND 列：對(duì)應(yīng)資源類(lèi)型。

總結(jié)

GKV（Group、Version、Kind）是 Kubernetes 資源的“身份證”，在 YAML 配置中通過(guò) apiVersion 和 kind 體現(xiàn)，是正確定義和操作資源的前提。

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

最新評(píng)論