深入理解和使用Kubernetes API Versioning

一、Kubernetes API Versioning簡介

Kubernetes作為一個開源的容器編排平台，不斷推進其向企業級應用的發展。在不斷壯大的Kubernetes生態系統中，API Versioning是一個非常重要的話題之一。

Kubernetes API Versioning包括兩個方面：API Endpoint的版本和API對象的版本。API Endpoint的版本主要是指URL API Endpoint的前綴，而API對象的版本則對應的是使用相應API版本來序列化和反序列化的Kubernetes對象。

二、API Endpoint的版本

Kubernetes API版本可以被用於管理集群以及管理在集群中的應用程序所使用的不同API的狀態的兼容性。API Endpoint的版本主要指的是URL API Endpoint的前綴，例如，v1，apps/v1beta1，apps/v1beta2等。

在Kubernetes中，每個API組都有相應的API Version，可以通過」kubectl api-versions」命令查看所有可用的API版本。例如，如果我們需要查看apps API組可用的版本，則可以執行以下命令:

kubectl api-versions | grep apps

輸出如下：

apps/v1
apps/v1beta1
apps/v1beta2

除了上面提到的API Endpoint版本外，還有一些其他的API Endpoint版本，包括：

apis: 對於幾乎所有擴展API組，如CRD。只有三個嵌套子目錄：apis/\/，apis/\/v1/和apis/\/v1beta1/。
api: Kubernetes主API組的Endpoint前綴，是Kubernetes API允許的最常見版本。
healthz: 可用於檢查API Server的運行狀況。
version：該Endpoint可以返回API Server的版本信息。

三、API對象的版本

API對象的版本是在Kubernetes對象執行序列化和反序列化過程中所使用的版本。Kubernetes可以支持多個版本的API對象，一個API版本可以包含多個Kubernetes對象版本。

API Versioning有一種Kubernetes對象通用模式。在Kubernetes對象通用模式中，Kubernetes對象包括以下三個部分：

Kind: 對於這個對象是什麼的命名。
API Group: 對象所屬Group，一般為CRD。
API Version: 對象所在的版本。

在創建或更新Kubernetes對象時，需要為其指定API版本。下面是一個Pod對象的典型定義：

apiVersion: v1
kind: Pod
metadata:
  name: example-pod

以上代碼指定了Pod對象所處的API版本v1。如果想要使用其他版本對象，只需更改「apiVersion」部分即可。

四、API Versioning的作用

API Versioning在Kubernetes中有很多用處，以下列舉了幾個主要的作用：

保證API的向前兼容性。Kubernetes API在更新版本時，保證了API的部分向前兼容性，允許舊版本的API與新版本的API並存。
允許API的平滑演進。若在後續的Kubernetes版本中引入了一些新特性，可以通過添加新的API版本來使得舊版本和新版本的Kubernetes對象並存。對於原本使用舊API版本的應用，無需升級Kubernetes以適應新特性，而可以繼續使用舊版本API即可。
減少Kubernetes對象定義中的混亂和不確定性。使用不同版本的Kubernetes對象來定義應用程序，有助於減少衝突和混亂，特別是當不同版本的應用程序使用衝突的資源時。

五、使用API Versioning創建CRD

使用API Versioning功能可以很方便地為Kubernetes集群中創建自定義資源。下面的示例將演示如何使用API Versioning創建一個CRD對象：

1. 創建CRD

# 示例1.yaml
apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition
metadata:
  name: example-crd.example.com
spec:
  group: example.com
  version: v1alpha1
  scope: Namespaced
  names:
    plural: examples
    singular: example
    kind: Example
    shortNames:
    - ex

運行該CRD定義文件創建CRD，可以使用以下命令：

kubectl apply -f 示例1.yaml

2. 創建Custom Resource

使用名稱為example的CRD創建一個 CR（Custom Resource），示例如下：

# 示例2.yaml
apiVersion: example.com/v1alpha1
kind: Example
metadata:
  name: my-example
spec:
  example: World!

運行以下命令以創建Custom Resource：

kubectl apply -f 示例2.yaml

六、總結

Kubernetes API Versioning是Kubernetes生態系統中一個不可或缺的部分。API Versioning通過API Endpoint的版本和API對象的版本，為Kubernetes在向前兼容性、平滑演進、減少定義混亂和不確定性等方面提供了極大的便利性。在創建自定義資源時，也可通過API Versioning功能輕鬆地創建CRD對象。

原創文章，作者：LFBOG，如若轉載，請註明出處：https://www.506064.com/zh-tw/n/370136.html