K8s API Resources

一個 API end point 會有以下組成:

• API Group: 是邏輯上相關的種類集合，如 Job 與 CronJob 都屬於批次處理功能相關。
• Version: 每個 API Group 存在多個版本，這些版本區分不同穩定度層級，一般功能會從 v1alpha1 升級到 v1beta1，然後在 v1 成為穩定版本。
• Resource: 資源是透過 HTTP 發送與檢索的 API 物件實體，其以 JSON 來表示。可以是單一或者多個資源。

API 的版本以及編排方式

Version 又分成

• Alpha Level
• Beta Level
• Stable Level

Custom Resource 就是由使用這自己定義 K8s 原生 API Server 之外的 Resource ，包含了從當前叢集擴展新的資源物件等等。

目前我們有兩種方法來增加 Custom Resource

CRD (Custom Resource Definitions)

https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/

Since Kubernetes v1.7

一但 CRD 物件建立時，Kubernetes API Server 就會幫你處理 Custom Resource 的 API 請求、狀態儲存等。

定義

CRD 定義 API URL 的方式是透過資 源類型名稱 + 域名來定義，例如我們定義 crontabs 這個 Custom Resource 在 lsalab.cs.nthu.edu.tw 這個域名下面，那 CRD 名稱就會是 crontabs.lsalab.cs.nthu.edu.tw。

完整的 API 路徑就會是 /apis/lsalab.cs.nthu.edu.tw/<version>/namespaces/<namespace>/crontabs/..