验证节点设置

节点一致性测试

“节点一致性测试”是一个容器化的测试框架,为节点提供系统验证和功能测试。该测试验证节点是否满足 Kubernetes 的最低要求;通过测试的节点有资格加入 Kubernetes 集群。

节点先决条件

要运行节点一致性测试,节点必须满足与标准 Kubernetes 节点相同的先决条件。至少,节点应安装以下守护进程:

  • CRI 兼容的容器运行时,例如 Docker、containerd 和 CRI-O
  • kubelet

运行节点一致性测试

要运行节点一致性测试,请执行以下步骤:

  1. 计算 kubelet 的 `--kubeconfig` 选项的值;例如:`--kubeconfig=/var/lib/kubelet/config.yaml`。由于测试框架启动一个本地控制平面来测试 kubelet,请使用 `https://:8080` 作为 API 服务器的 URL。您可能还想使用一些其他 kubelet 命令行参数:

    • `--cloud-provider`:如果您使用的是 `--cloud-provider=gce`,则应删除该标志以运行测试。
  2. 使用命令运行节点一致性测试

    # $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 镜像:

架构镜像
amd64node-test-amd64
armnode-test-arm
arm64node-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 镜像,包括节点一致性测试镜像和功能测试中使用的容器镜像。
  • 该测试会在节点上留下死容器。这些容器是在功能测试期间创建的。
上次修改时间:2024 年 10 月 17 日下午 6:09 PST:清理最佳实践:证书和节点一致性 (1d24167b04)