创建静态 Pod

    静态 Pod 始终都会绑定到特定节点的 Kubelet 上。

    kubelet 会尝试通过 Kubernetes API 服务器为每个静态 Pod 自动创建一个。 这意味着节点上运行的静态 Pod 对 API 服务来说是可见的,但是不能通过 API 服务器来控制。 Pod 名称将把以连字符开头的节点主机名作为后缀。

    说明:

    如果你在运行一个 Kubernetes 集群,并且在每个节点上都运行一个静态 Pod, 就可能需要考虑使用 DaemonSet 替代这种方式。

    说明:

    静态 Pod 的 不能引用其他 API 对象 (如:、 ConfigMap、 等)。

    说明:

    静态 Pod 不支持临时容器

    你必须拥有一个 Kubernetes 的集群,同时你的 Kubernetes 集群必须带有 kubectl 命令行工具。 建议在至少有两个节点的集群上运行本教程,且这些节点不作为控制平面主机。 如果你还没有集群,你可以通过 Minikube 构建一个你自己的集群,或者你可以使用下面任意一个 Kubernetes 工具构建:

    要获知版本信息,请输入 kubectl version.

    本文假定你在使用 来运行 Pod, 并且你的节点是运行着 Fedora 操作系统。 其它发行版或者 Kubernetes 部署版本上操作方式可能不一样。

    声明文件是标准的 Pod 定义文件,以 JSON 或者 YAML 格式存储在指定目录。路径设置在 Kubelet 配置文件staticPodPath: <目录> 字段,kubelet 会定期的扫描这个文件夹下的 YAML/JSON 文件来创建/删除静态 Pod。 注意 kubelet 扫描目录的时候会忽略以点开头的文件。

    例如:下面是如何以静态 Pod 的方式启动一个简单 web 服务:

    1. 选择一个要运行静态 Pod 的节点。在这个例子中选择 my-node1

    2. 选择一个目录,比如在 /etc/kubernetes/manifests 目录来保存 Web 服务 Pod 的定义文件,例如 /etc/kubernetes/manifests/static-web.yaml

      1. # 在 kubelet 运行的节点上执行以下命令
      2. mkdir -p /etc/kubernetes/manifests/
      3. cat <<EOF >/etc/kubernetes/manifests/static-web.yaml
      4. apiVersion: v1
      5. kind: Pod
      6. metadata:
      7. name: static-web
      8. labels:
      9. role: myrole
      10. spec:
      11. containers:
      12. - name: web
      13. image: nginx
      14. ports:
      15. - name: web
      16. protocol: TCP
      17. EOF
    3. 配置这个节点上的 kubelet,使用这个参数执行 --pod-manifest-path=/etc/kubelet.d/。 在 Fedora 上编辑 /etc/kubernetes/kubelet 以包含下面这行:

      或者在 中添加 staticPodPath: <目录>字段。

    4. 重启 kubelet。在 Fedora 上,你将使用下面的命令:

      1. # 在 kubelet 运行的节点上执行以下命令
      2. systemctl restart kubelet

    Web 网上的静态 Pod 声明文件

    Kubelet 根据 --manifest-url=<URL> 参数的配置定期的下载指定文件,并且转换成 JSON/YAML 格式的 Pod 定义文件。 与使用方式类似,kubelet 调度获取清单文件。 如果静态 Pod 的清单文件有改变,kubelet 会应用这些改变。

    按照下面的方式来:

    1. 创建一个 YAML 文件,并保存在 web 服务上,为 kubelet 生成一个 URL。

      1. apiVersion: v1
      2. kind: Pod
      3. metadata:
      4. name: static-web
      5. labels:
      6. role: myrole
      7. spec:
      8. containers:
      9. - name: web
      10. image: nginx
      11. ports:
      12. - name: web
      13. containerPort: 80
      14. protocol: TCP
    2. 通过在选择的节点上使用 --manifest-url=<manifest-url> 配置运行 kubelet。 在 Fedora 添加下面这行到 /etc/kubernetes/kubelet

      1. KUBELET_ARGS="--cluster-dns=10.254.0.10 --cluster-domain=kube.local --manifest-url=<manifest-url>"

    当 kubelet 启动时,会自动启动所有定义的静态 Pod。 当定义了一个静态 Pod 并重新启动 kubelet 时,新的静态 Pod 就应该已经在运行了。

    可以在节点上运行下面的命令来查看正在运行的容器(包括静态 Pod):

    1. crictl ps

    输出可能会像这样:

    1. CONTAINER IMAGE CREATED STATE NAME ATTEMPT POD ID
    2. 129fd7d382018 docker.io/library/nginx@sha256:... 11 minutes ago Running web 0 34533c6729106

    说明:

    会输出镜像 URI 和 SHA-256 校验和。NAME 看起来像: docker.io/library/nginx@sha256:0d17b565c37bcbd895e9d92315a05c1c3c9a29f762b011a10c54a66cd53c9b31

    可以在 API 服务上看到镜像 Pod:

    1. kubectl get pods
    1. NAME READY STATUS RESTARTS AGE
    2. static-web 1/1 Running 0 2m

    说明:

    要确保 kubelet 在 API 服务上有创建镜像 Pod 的权限。如果没有,创建请求会被 API 服务拒绝。

    静态 Pod 上的被传播到镜像 Pod。 你可以通过选择算符使用这些标签。

    如果你用 kubectl 从 API 服务上删除镜像 Pod,kubelet 不会移除静态 Pod:

    1. kubectl delete pod static-web

    可以看到 Pod 还在运行:

    1. kubectl get pods
    1. NAME READY STATUS RESTARTS AGE
    2. static-web 1/1 Running 0 4s
    1. # 在 kubelet 运行的节点上执行以下命令
    2. # 把 ID 换为你的容器的 ID
    3. crictl stop 129fd7d382018
    4. sleep 20
    5. crictl ps
    1. CONTAINER IMAGE CREATED STATE NAME ATTEMPT POD ID
    2. 89db4553e1eeb docker.io/library/nginx@sha256:... 19 seconds ago Running web 1 34533c6729106

    运行中的 kubelet 会定期扫描配置的目录(比如例子中的 /etc/kubernetes/manifests 目录)中的变化, 并且根据文件中出现/消失的 Pod 来添加/删除 Pod。

    1. # 这里假定你在用主机文件系统上的静态 Pod 配置文件
    2. # 在 kubelet 运行的节点上执行以下命令
    3. mv /etc/kubernetes/manifests/static-web.yaml /tmp
    4. sleep 20
    5. crictl ps
    6. # 可以看到没有 nginx 容器在运行
    7. mv /tmp/static-web.yaml /etc/kubernetes/manifests/