创建静态 Pod
静态 Pod 由特定节点上的 kubelet 守护程序直接管理,而无需 API 服务器 观察它们。与由控制平面管理的 Pod 不同(例如,部署);相反,kubelet 会监视每个静态 Pod(如果失败则重启它)。
静态 Pod 始终绑定到特定节点上的一个 Kubelet。
kubelet 会自动尝试在 Kubernetes API 服务器上为每个静态 Pod 创建一个 镜像 Pod。这意味着在节点上运行的 Pod 在 API 服务器上可见,但无法从那里控制。Pod 名称将在节点主机名后加上前导连字符。
注意
如果您正在运行集群式 Kubernetes 并使用静态 Pod 在每个节点上运行 Pod,那么您可能应该使用 守护进程集。注意
静态 Pod 不支持 临时容器。开始之前
您需要有一个 Kubernetes 集群,并且 kubectl 命令行工具必须配置为与您的集群通信。建议在至少有两个节点的集群上运行本教程,这些节点不充当控制平面主机。如果您还没有集群,您可以使用 minikube 创建一个,或者您可以使用以下 Kubernetes 游乐场之一
要检查版本,请输入kubectl version
。本页假设您使用的是 CRI-O 运行 Pod,并且您的节点运行的是 Fedora 操作系统。其他发行版或 Kubernetes 安装的说明可能有所不同。
创建静态 Pod
您可以使用 文件系统托管配置文件 或 网络托管配置文件 配置静态 Pod。
文件系统托管静态 Pod 清单
清单是特定目录中以 JSON 或 YAML 格式表示的标准 Pod 定义。在 kubelet 配置文件 中使用 staticPodPath: <the directory>
字段,该字段会定期扫描目录并在该目录中出现/消失 YAML/JSON 文件时创建/删除静态 Pod。请注意,kubelet 在扫描指定的目录时会忽略以点开头的文件。
例如,以下是将简单 Web 服务器作为静态 Pod 启动的方法
选择您要运行静态 Pod 的节点。在本例中,它是
my-node1
。ssh my-node1
选择一个目录,例如
/etc/kubernetes/manifests
,并将 Web 服务器 Pod 定义放在那里,例如/etc/kubernetes/manifests/static-web.yaml
# Run this command on the node where kubelet is running mkdir -p /etc/kubernetes/manifests/ cat <<EOF >/etc/kubernetes/manifests/static-web.yaml apiVersion: v1 kind: Pod metadata: name: static-web labels: role: myrole spec: containers: - name: web image: nginx ports: - name: web containerPort: 80 protocol: TCP EOF
在该节点上配置 kubelet,以便在 kubelet 配置文件 中设置
staticPodPath
值。
有关更多信息,请参见 通过配置文件设置 Kubelet 参数。一种备用且已弃用的方法是,在该节点上配置 kubelet 以使用命令行参数在本地查找静态 Pod 清单。要使用已弃用的方法,请使用以下参数启动 kubelet:
--pod-manifest-path=/etc/kubernetes/manifests/
参数。重新启动 kubelet。在 Fedora 上,您将运行
# Run this command on the node where the kubelet is running systemctl restart kubelet
网络托管静态 Pod 清单
kubelet 会定期下载 --manifest-url=<URL>
参数指定的,并将该文件解释为包含 Pod 定义的 JSON/YAML 文件。类似于 文件系统托管清单 的工作原理,kubelet 会按照预定的时间表重新获取清单。如果静态 Pod 列表发生更改,kubelet 会应用这些更改。
要使用此方法
创建一个 YAML 文件并将其存储在 Web 服务器上,以便您可以将该文件的 URL 传递给 kubelet。
apiVersion: v1 kind: Pod metadata: name: static-web labels: role: myrole spec: containers: - name: web image: nginx ports: - name: web containerPort: 80 protocol: TCP
通过运行
--manifest-url=<manifest-url>
配置选定节点上的 kubelet 以使用此网络清单。在 Fedora 上,编辑/etc/kubernetes/kubelet
以包含以下行KUBELET_ARGS="--cluster-dns=10.254.0.10 --cluster-domain=kube.local --manifest-url=<manifest-url>"
重新启动 kubelet。在 Fedora 上,您将运行
# Run this command on the node where the kubelet is running systemctl restart kubelet
观察静态 Pod 行为
当 kubelet 启动时,它会自动启动所有定义的静态 Pod。由于您已定义了一个静态 Pod 并重新启动了 kubelet,因此新的静态 Pod 应该已经在运行。
您可以通过运行以下命令查看正在运行的容器(包括静态 Pod)(在节点上)
# Run this command on the node where the kubelet is running
crictl ps
输出可能类似于
CONTAINER IMAGE CREATED STATE NAME ATTEMPT POD ID
129fd7d382018 docker.io/library/nginx@sha256:... 11 minutes ago Running web 0 34533c6729106
注意
crictl
输出镜像 URI 和 SHA-256 校验和。NAME
将更像是:docker.io/library/nginx@sha256:0d17b565c37bcbd895e9d92315a05c1c3c9a29f762b011a10c54a66cd53c9b31
。您可以在 API 服务器上看到镜像 Pod
kubectl get pods
NAME READY STATUS RESTARTS AGE
static-web-my-node1 1/1 Running 0 2m
注意
确保 kubelet 有权在 API 服务器中创建镜像 Pod。如果没有,则 API 服务器会拒绝创建请求。标签 从静态 Pod 传播到镜像 Pod。您可以像平常一样通过 选择器 等使用这些标签。
如果您尝试使用 kubectl
从 API 服务器删除镜像 Pod,kubelet 不会 删除静态 Pod
kubectl delete pod static-web-my-node1
pod "static-web-my-node1" deleted
您可以看到 Pod 仍在运行
kubectl get pods
NAME READY STATUS RESTARTS AGE
static-web-my-node1 1/1 Running 0 4s
回到 kubelet 正在运行的节点,您可以尝试手动停止容器。您会看到,一段时间后,kubelet 会注意到并自动重启 Pod
# Run these commands on the node where the kubelet is running
crictl stop 129fd7d382018 # replace with the ID of your container
sleep 20
crictl ps
CONTAINER IMAGE CREATED STATE NAME ATTEMPT POD ID
89db4553e1eeb docker.io/library/nginx@sha256:... 19 seconds ago Running web 1 34533c6729106
找到正确的容器后,您可以使用 crictl
获取该容器的日志
# Run these commands on the node where the container is running
crictl logs <container_id>
10.240.0.48 - - [16/Nov/2022:12:45:49 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.47.0" "-"
10.240.0.48 - - [16/Nov/2022:12:45:50 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.47.0" "-"
10.240.0.48 - - [16/Nove/2022:12:45:51 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.47.0" "-"
要详细了解如何使用 crictl
进行调试,请访问 使用 crictl 调试 Kubernetes 节点。
静态 Pod 的动态添加和删除
正在运行的 kubelet 会定期扫描配置的目录(在本例中为 /etc/kubernetes/manifests
),以查找更改,并根据该目录中出现/消失的文件添加/删除 Pod。
# This assumes you are using filesystem-hosted static Pod configuration
# Run these commands on the node where the container is running
#
mv /etc/kubernetes/manifests/static-web.yaml /tmp
sleep 20
crictl ps
# You see that no nginx container is running
mv /tmp/static-web.yaml /etc/kubernetes/manifests/
sleep 20
crictl ps
CONTAINER IMAGE CREATED STATE NAME ATTEMPT POD ID
f427638871c35 docker.io/library/nginx@sha256:... 19 seconds ago Running web 1 34533c6729106