验证节点设置
节点一致性测试
**节点一致性测试**是一个容器化的测试框架,为节点提供系统验证和功能测试。该测试验证节点是否满足 Kubernetes 的最低要求;通过测试的节点才有资格加入 Kubernetes 集群。
节点先决条件
要运行节点一致性测试,节点必须满足与标准 Kubernetes 节点相同的先决条件。至少,节点应安装以下守护程序
- 与 CRI 兼容的容器运行时,例如 Docker、Containerd 和 CRI-O
- Kubelet
运行节点一致性测试
要运行节点一致性测试,请执行以下步骤
- 确定 kubelet 的
--kubeconfig
选项的值;例如:--kubeconfig=/var/lib/kubelet/config.yaml
。因为测试框架启动了一个本地控制平面来测试 kubelet,所以使用http://localhost:8080
作为 API 服务器的 URL。您可能还想使用其他一些 kubelet 命令行参数
--cloud-provider
:如果您正在使用--cloud-provider=gce
,则应删除该标志以运行测试。
- 使用以下命令运行节点一致性测试
# $CONFIG_DIR is the pod manifest path of your Kubelet.
# $LOG_DIR is the test output path.
sudo docker run -it --rm --privileged --net=host \
-v /:/rootfs -v $CONFIG_DIR:$CONFIG_DIR -v $LOG_DIR:/var/result \
registry.k8s.io/node-test:0.2
为其他架构运行节点一致性测试
Kubernetes 还为其他架构提供了节点一致性测试 Docker 镜像
架构 | 镜像 |
---|---|
amd64 | node-test-amd64 |
arm | node-test-arm |
arm64 | node-test-arm64 |
运行选定测试
要运行特定测试,请使用要运行的测试的正则表达式覆盖环境变量 FOCUS
。
sudo docker run -it --rm --privileged --net=host \
-v /:/rootfs:ro -v $CONFIG_DIR:$CONFIG_DIR -v $LOG_DIR:/var/result \
-e FOCUS=MirrorPod \ # Only run MirrorPod test
registry.k8s.io/node-test:0.2
要跳过特定测试,请使用要跳过的测试的正则表达式覆盖环境变量 SKIP
。
sudo docker run -it --rm --privileged --net=host \
-v /:/rootfs:ro -v $CONFIG_DIR:$CONFIG_DIR -v $LOG_DIR:/var/result \
-e SKIP=MirrorPod \ # Run all conformance tests but skip MirrorPod test
registry.k8s.io/node-test:0.2
节点一致性测试是 节点端到端测试 的容器化版本。默认情况下,它会运行所有一致性测试。
理论上,如果正确配置容器并挂载所需的卷,则可以运行任何节点端到端测试。但**强烈建议只运行一致性测试**,因为运行非一致性测试需要更复杂的配置。
注意事项
- 测试会在节点上留下一些 Docker 镜像,包括节点一致性测试镜像和功能测试中使用的容器镜像。
- 测试会在节点上留下失效的容器。这些容器是在功能测试期间创建的。
上次修改时间:2023 年 9 月 12 日下午 2:45(太平洋标准时间):"验证节点设置页面是否将 Docker 作为容器运行时提及" (09e58a5589)