APIService · kubernetes完整攻略

# APIService APIService是用來表示一個特定的`GroupVersion`的中的server，它的結構定義位于代碼`staging/src/k8s.io/kube-aggregator/pkg/apis/apiregistration/types.go`中。下面是一個APIService的示例配置： ```yaml apiVersion: apiregistration.k8s.io/v1beta1 kind: APIService metadata: name: v1alpha1.custom-metrics.metrics.k8s.io spec: insecureSkipTLSVerify: true group: custom-metrics.metrics.k8s.io groupPriorityMinimum: 1000 versionPriority: 5 service: name: api namespace: custom-metrics version: v1alpha1 ``` ## APIService詳解使用`apiregistration.k8s.io/v1beta1` 版本的APIService，在metadata.name中定義該API的名字。使用上面的yaml的創建`v1alpha1.custom-metrics.metrics.k8s.io` APIService。 - `insecureSkipTLSVerify `：當與該服務通信時，禁用TLS證書認證。強加建議不要設置這個參數，默認為 false。應該使用CABundle代替。 - `service`：與該APIService通信時引用的service，其中要注明service的名字和所屬的namespace，如果為空的話，則所有的服務都會該API groupversion將在本地443端口處理所有通信。 - `groupPriorityMinimum`：該組API的處理優先級，主要排序是基于`groupPriorityMinimum`，該數字越大表明優先級越高，客戶端就會與其通信處理請求。次要排序是基于字母表順序，例如v1.bar比v1.foo的優先級更高。 - `versionPriority`：VersionPriority控制其組內的API版本的順序。必須大于零。主要排序基于VersionPriority，從最高到最低（20大于10）排序。次要排序是基于對象名稱的字母比較。（v1.foo在v1.bar之前）由于它們都是在一個組內，因此數字可能很小，一般都小于10。查看我們使用上面的yaml文件創建的APIService。 ```bash kubectl get apiservice v1alpha1.custom-metrics.metrics.k8s.io -o yaml ``` ```yaml apiVersion: apiregistration.k8s.io/v1beta1 kind: APIService metadata: creationTimestamp: 2017-12-14T08:27:35Z name: v1alpha1.custom-metrics.metrics.k8s.io resourceVersion: "35194598" selfLink: /apis/apiregistration.k8s.io/v1beta1/apiservices/v1alpha1.custom-metrics.metrics.k8s.io uid: a31a3412-e0a8-11e7-9fa4-f4e9d49f8ed0 spec: caBundle: null group: custom-metrics.metrics.k8s.io groupPriorityMinimum: 1000 insecureSkipTLSVerify: true service: name: api namespace: custom-metrics version: v1alpha1 versionPriority: 5 status: conditions: - lastTransitionTime: 2017-12-14T08:27:38Z message: all checks passed reason: Passed status: "True" type: Available ``` ## 查看集群支持的APISerivce 作為Kubernetes中的一種資源對象，可以使用`kubectl get apiservice`來查看。例如查看集群中所有的APIService： ```bash $ kubectl get apiservice NAME AGE v1. 2d v1.authentication.k8s.io 2d v1.authorization.k8s.io 2d v1.autoscaling 2d v1.batch 2d v1.monitoring.coreos.com 1d v1.networking.k8s.io 2d v1.rbac.authorization.k8s.io 2d v1.storage.k8s.io 2d v1alpha1.custom-metrics.metrics.k8s.io 2h v1beta1.apiextensions.k8s.io 2d v1beta1.apps 2d v1beta1.authentication.k8s.io 2d v1beta1.authorization.k8s.io 2d v1beta1.batch 2d v1beta1.certificates.k8s.io 2d v1beta1.extensions 2d v1beta1.policy 2d v1beta1.rbac.authorization.k8s.io 2d v1beta1.storage.k8s.io 2d v1beta2.apps 2d v2beta1.autoscaling 2d ``` 另外查看當前kubernetes集群支持的API版本還可以使用`kubectl api-versions`： ```bash $ kubectl api-versions apiextensions.k8s.io/v1beta1 apiregistration.k8s.io/v1beta1 apps/v1beta1 apps/v1beta2 authentication.k8s.io/v1 authentication.k8s.io/v1beta1 authorization.k8s.io/v1 authorization.k8s.io/v1beta1 autoscaling/v1 autoscaling/v2beta1 batch/v1 batch/v1beta1 certificates.k8s.io/v1beta1 custom-metrics.metrics.k8s.io/v1alpha1 extensions/v1beta1 monitoring.coreos.com/v1 networking.k8s.io/v1 policy/v1beta1 rbac.authorization.k8s.io/v1 rbac.authorization.k8s.io/v1beta1 storage.k8s.io/v1 storage.k8s.io/v1beta1 v1 ``` ## 參考 - [API Conventions](https://github.com/kubernetes/community/blob/master/contributors/devel/api-conventions.md#resources)