website/cn/docs/admin/node-conformance.md

3.3 KiB
Raw Blame History

approvers title
Random-Liu
节点设置校验
  • TOC {:toc}

节点合规性测试

节点合规性测试 是一个容器化的测试框架,提供了针对节点的系统验证和功能测试。 该测试主要检测节点是否满足 Kubernetes 的最低要求,通过检测的节点有资格加入 Kubernetes 集群。

限制

在 Kubernetes 1.5版本中,节点合规性测试存在以下限制:

  • 节点合规性测试只支持 Docker 作为容器运行时环境。

节点的前提条件

为运行节点合规性测试,节点必须满足与标准的 Kubernetes 节点同样的前提条件。最基本地, 节点应安装以下组件:

  • 容器运行时 (Docker)
  • Kubelet

运行节点合规性测试

执行以下步骤来运行节点合规性测试:

  1. 因为测试框架会启动一个本地的 master 来测试 Kubelet 所以将 Kubelet 指向本机 `--api-servers="http://localhost:8080"。 还有一些其他 Kubelet 参数可能需要注意:
  • --pod-cidr 如果使用 kubenet 需要为 Kubelet 任意指定一个 CIDR 例如 --pod-cidr=10.180.0.0/24
  • --cloud-provider 如果使用 --cloud-provider=gce,需要移除这个参数来运行测试。
  1. 执行以下命令来运行节点合规性测试:
# $CONFIG_DIR 是 Kubelet 的 manifest 文件路径。
# $LOG_DIR 是测试结果输出的路径。
sudo docker run -it --rm --privileged --net=host \
  -v /:/rootfs -v $CONFIG_DIR:$CONFIG_DIR -v $LOG_DIR:/var/result \
  k8s.gcr.io/node-test:0.2

针对其他硬件体系结构运行节点合规性测试

Kubernetes 也为其他硬件体系结构的系统提供了节点合规性测试的 Docker 镜像:

Arch Image
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 \ # 只运行MirrorPod测试
  k8s.gcr.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 \ # 运行除MirrorPod外的所有测试
  k8s.gcr.io/node-test:0.2

节点合规性测试是节点端到端测试的一个容器化的版本。 默认情况下, 它会运行所有的合规性测试用例。

理论上,只要合理地配置容器和挂载所需的卷,就可以运行任何的节点端到端测试用例。 但是这里 强烈建议只运行合规性测试,因为运行非合规性测试需要很多复杂的配置。

注意事项

  • 测试会在节点上遗留一些Docker镜像 包括节点合规性测试本身的镜像,和功能测试相关的镜像。
  • 测试会在节点上遗留一些死的容器。这些容器是在功能测试的过程中创建的。