文本翻译自: https://itnext.io/working-with-the-kubernetes-api-587bc5941992
Kubernetes 公开了一个弱小的 API,可让您管制集群的各个方面。
大多数时候,它暗藏在 kubectl 前面,但没有人会阻止您间接应用它。
在本文中,您将学习如何应用 curl
或者您喜爱的编程语言向 Kubernetes API 发出请求。
但首先,让咱们回顾一下 Kubernetes API 的工作原理。
当您键入命令时,kubectl:
- 客户端校验申请。
- 在文件上生成 YAML(例如
kubectl run
)。 - 结构运行时对象。
此时,kubectl 还没有向集群收回任何申请。
下一步,它查问以后的 API 服务器并发现所有可用的 API 端点。
最初,kubectl 应用运行时对象和端点来协商正确的 API 调用。
如果您的资源是 Pod,kubectl 会读取 apiVersion
和 kind
字段并确保它们在集群中可用和受反对。
而后它发送申请。
了解在 Kubernetes 中 API 是分组的这很重要的。
为了进一步隔离多个版本,资源被版本化。
当初您曾经把握了基础知识,让咱们来看一个示例。
您能够应用 kubectl proxy
启动到 API 服务器的本地隧道。
然而如何检索所有 deployments 呢?
Deployments 属于 apps
组并且有一个 v1
版本。
您能够列出它们:
curl localhost:8001/apis/apps/v1/namespaces/{namespace}/deployments
列出所有正在运行的 pod 怎么样?
Pod 属于 ""
(空)组并且有一个 v1
版本。
您能够列出它们:
curl localhost:8001/api/v1/namespaces/{namespace}/pods
group 为空看起来有点奇怪——还有更多例外吗?
好吧,事实是有一种更简略的办法来构建 URL。
我通常应用 Kubernetes API 参考文档,因为门路都参差地列出了。
让咱们看另一个示例,但这次是在 API 参考的帮忙下。
如果你想收到 pod 更改的告诉怎么办?
在 API 中称为 watch
,命令为:
GET /api/v1/watch/namespaces/{namespace}/pods/{name}
太好了,但这所有有什么意义呢?
间接拜访 API 容许您构建脚本来主动执行工作。
或者您能够构建本人的 kubernetes 扩大。
我来给你展现。
这是一个约 130 行 Javascript 的小型 kubernetes 仪表板。
它调用了 2 个 API:
- 列出所有 pod
- watch pod 的变动
其余代码用于对节点进行分组和显示。
在 Kubernetes 中,将列出和更新资源联合起来十分广泛,以至于它成为一种称为 shared informer 的模式。
Javascript/Typescript API 有一个很好的 shared informer 的例子.
但它只是 2 个 GET 申请(和一些缓存)的奇异名称。
API 不止于读取资源。
您还能够创立新资源并批改现有资源。
例如,您能够批改部署的正本:
PATCH /apis/apps/v1/namespaces/{namespace}/deployments/{name}
为了进行试验,我建造了一些非常规的货色。
xlskubectl 是我尝试应用 Excel/Google 表格管制 kubernetes 集群。
该代码与上述 Javascript 代码十分类似:
- 它应用 shared informer
- 它轮询 google sheets 的更新
- 它将所有内容出现为单元格
这个示例是一个好主见吗? 可能并不是。
心愿它能帮忙您实现间接应用 Kubernetes API 的后劲。
这些代码都不是用 Go 编写的——您能够应用任何编程语言去调用 Kubernetes API。