为节点通告扩展资源
本页面展示了如何为节点指定扩展资源。扩展资源允许集群管理员通告节点级别的资源,这些资源在 Kubernetes 中原本是未知的。
准备工作
你需要有一个 Kubernetes 集群,并且 kubectl 命令行工具已配置为与你的集群通信。建议你在至少有两个节点不作为控制平面主机的集群上运行本教程。如果你还没有集群,可以使用 minikube 创建一个,或者使用这些 Kubernetes 操场之一。
要检查版本,请输入 kubectl version
。
获取节点名称
kubectl get nodes
选择一个节点用于本次练习。
在一个节点上通告新的扩展资源
要在节点上通告新的扩展资源,请向 Kubernetes API 服务器发送 HTTP PATCH 请求。例如,假设你的一个节点连接了四个 dongle。以下是一个 PATCH 请求示例,它为你的节点通告了四个 dongle 资源。
PATCH /api/v1/nodes/<your-node-name>/status HTTP/1.1
Accept: application/json
Content-Type: application/json-patch+json
Host: k8s-master:8080
[
{
"op": "add",
"path": "/status/capacity/example.com~1dongle",
"value": "4"
}
]
请注意,Kubernetes 不需要知道 dongle 是什么或 dongle 的用途。前面的 PATCH 请求告诉 Kubernetes 你的节点有四个你称之为 dongle 的东西。
启动一个代理,以便你可以轻松地向 Kubernetes API 服务器发送请求
kubectl proxy
在另一个命令窗口中,发送 HTTP PATCH 请求。将 <your-node-name>
替换为你的节点名称。
curl --header "Content-Type: application/json-patch+json" \
--request PATCH \
--data '[{"op": "add", "path": "/status/capacity/example.com~1dongle", "value": "4"}]' \
https://:8001/api/v1/nodes/<your-node-name>/status
输出显示节点具有 4 个 dongle 的容量。
"capacity": {
"cpu": "2",
"memory": "2049008Ki",
"example.com/dongle": "4",
描述你的节点
kubectl describe node <your-node-name>
再次,输出显示了 dongle 资源。
Capacity:
cpu: 2
memory: 2049008Ki
example.com/dongle: 4
现在,应用程序开发人员可以创建请求一定数量 dongle 的 Pod。请参阅 为容器分配扩展资源。
讨论
扩展资源类似于内存和 CPU 资源。例如,就像节点有一定量的内存和 CPU 供节点上运行的所有组件共享一样,它也可以有一定数量的 dongle 供节点上运行的所有组件共享。就像应用程序开发人员可以创建请求一定量内存和 CPU 的 Pod 一样,他们也可以创建请求一定数量 dongle 的 Pod。
扩展资源对 Kubernetes 来说是不透明的;Kubernetes 对它们一无所知。Kubernetes 只知道一个节点有一定数量的这些资源。扩展资源必须以整数形式进行通告。例如,一个节点可以通告四个 dongle,但不能通告 4.5 个 dongle。
存储示例
假设一个节点有 800 GiB 的特殊磁盘存储。你可以为这种特殊存储创建一个名称,例如 example.com/special-storage。然后你可以以一定大小的块来通告它,例如 100 GiB。在这种情况下,你的节点将通告它有八个 example.com/special-storage 类型的资源。
Capacity:
...
example.com/special-storage: 8
如果你想允许对特殊存储进行任意请求,你可以以 1 字节大小的块来通告特殊存储。在这种情况下,你将通告 800Gi 个 example.com/special-storage 类型的资源。
Capacity:
...
example.com/special-storage: 800Gi
然后,一个容器可以请求任意数量的特殊存储字节,最多可达 800Gi。
清理
以下是一个 PATCH 请求,它从节点中移除了 dongle 通告。
PATCH /api/v1/nodes/<your-node-name>/status HTTP/1.1
Accept: application/json
Content-Type: application/json-patch+json
Host: k8s-master:8080
[
{
"op": "remove",
"path": "/status/capacity/example.com~1dongle",
}
]
启动一个代理,以便你可以轻松地向 Kubernetes API 服务器发送请求
kubectl proxy
在另一个命令窗口中,发送 HTTP PATCH 请求。将 <your-node-name>
替换为你的节点名称。
curl --header "Content-Type: application/json-patch+json" \
--request PATCH \
--data '[{"op": "remove", "path": "/status/capacity/example.com~1dongle"}]' \
https://:8001/api/v1/nodes/<your-node-name>/status
验证 dongle 通告是否已移除
kubectl describe node <your-node-name> | grep dongle
(你不应该看到任何输出)