在Void Linux上部署和运行Kubernetes集群的完整指南从小众发行版到容器编排平台的实践探索

威震华夏关云长

引言

Void Linux是一个独特的Linux发行版，以其滚动发布模型、简洁的设计和runit init系统而闻名。虽然它在用户群体中相对小众，但其轻量级和高效的特性使其成为那些寻求不同于主流发行版选择的用户的理想选择。

Kubernetes（简称K8s）则是容器编排领域的事实标准，它提供了自动化部署、扩展和管理容器化应用程序的功能。将这两者结合—在Void Linux上运行Kubernetes集群—可能看似是一个小众组合，但它提供了一个有趣的机会，可以探索如何在一个非主流但高效的操作系统上构建强大的容器编排平台。

本指南将详细介绍如何在Void Linux上从零开始部署和运行一个功能完整的Kubernetes集群。我们将涵盖从准备工作到验证集群的每个步骤，并提供解决可能遇到的问题的方法。无论您是Void Linux的爱好者，还是对在不同操作系统上部署Kubernetes感兴趣的系统管理员，本指南都将为您提供所需的详细信息和实际操作步骤。

准备工作

在开始部署Kubernetes集群之前，我们需要进行一些准备工作。这包括确保我们的系统满足要求，配置网络，以及安装必要的软件包。

系统要求

首先，让我们确保我们的系统满足运行Kubernetes的基本要求：

1. 硬件要求：控制平面节点：至少2个CPU和2GB RAM工作节点：至少1个CPU和1GB RAM所有节点：至少20GB的可用磁盘空间
2. 控制平面节点：至少2个CPU和2GB RAM
3. 工作节点：至少1个CPU和1GB RAM
4. 所有节点：至少20GB的可用磁盘空间
5. 软件要求：Void Linux（本指南基于最新的滚动发布版本）具有sudo权限的非root用户
6. Void Linux（本指南基于最新的滚动发布版本）
7. 具有sudo权限的非root用户
8. 网络要求：所有节点之间必须能够通过网络通信确保以下端口在所有节点上开放：控制平面节点：6443, 2379-2380, 10250, 10259, 10257工作节点：10250, 30000-32767
9. 所有节点之间必须能够通过网络通信
10. 确保以下端口在所有节点上开放：控制平面节点：6443, 2379-2380, 10250, 10259, 10257工作节点：10250, 30000-32767
11. 控制平面节点：6443, 2379-2380, 10250, 10259, 10257
12. 工作节点：10250, 30000-32767

硬件要求：

• 控制平面节点：至少2个CPU和2GB RAM
• 工作节点：至少1个CPU和1GB RAM
• 所有节点：至少20GB的可用磁盘空间

软件要求：

• Void Linux（本指南基于最新的滚动发布版本）
• 具有sudo权限的非root用户

网络要求：

• 所有节点之间必须能够通过网络通信
• 确保以下端口在所有节点上开放：控制平面节点：6443, 2379-2380, 10250, 10259, 10257工作节点：10250, 30000-32767
• 控制平面节点：6443, 2379-2380, 10250, 10259, 10257
• 工作节点：10250, 30000-32767

• 控制平面节点：6443, 2379-2380, 10250, 10259, 10257
• 工作节点：10250, 30000-32767

安装必要的软件包

Void Linux使用XBPS作为其包管理器。让我们首先更新系统并安装一些必要的软件包：

2. # 更新系统
3. sudo xbps-install -Su
5. # 安装必要的软件包
6. sudo xbps-install -y curl wget git

复制代码

配置主机名和hosts文件

为了确保集群中的节点能够相互识别，我们需要正确配置主机名和hosts文件。

在每个节点上，设置主机名：

2. # 控制平面节点
3. sudo hostnamectl set-hostname k8s-master
5. # 工作节点1
6. sudo hostnamectl set-hostname k8s-worker1
8. # 工作节点2
9. sudo hostnamectl set-hostname k8s-worker2

复制代码

然后，编辑/etc/hosts文件，添加所有节点的IP地址和主机名：

2. sudo nano /etc/hosts

复制代码

添加以下内容（根据您的实际IP地址进行调整）：

2. 192.168.1.10 k8s-master
3. 192.168.1.11 k8s-worker1
4. 192.168.1.12 k8s-worker2

复制代码

禁用交换空间

Kubernetes要求所有节点上的交换空间被禁用。执行以下命令来临时禁用交换：

2. sudo swapoff -a

复制代码

要永久禁用交换，编辑/etc/fstab文件并注释掉与交换相关的行：

2. sudo nano /etc/fstab

复制代码

找到类似下面这一行：

2. /swapfile   none    swap    sw    0   0

复制代码

并在前面加上#来注释它：

2. #/swapfile   none    swap    sw    0   0

复制代码

配置内核参数

Kubernetes需要一些特定的内核参数设置。创建一个新的配置文件：

2. sudo nano /etc/sysctl.d/k8s.conf

复制代码

添加以下内容：

2. net.bridge.bridge-nf-call-ip6tables = 1
3. net.bridge.bridge-nf-call-iptables = 1
4. net.ipv4.ip_forward = 1

复制代码

应用这些更改：

2. sudo sysctl --system

复制代码

安装Docker容器运行时

Kubernetes需要一个容器运行时来管理容器。Docker是最常见的选择，尽管Kubernetes也支持其他运行时如containerd和CRI-O。在本指南中，我们将使用Docker。

安装Docker

Void Linux在默认仓库中提供了Docker。安装它：

2. sudo xbps-install -y docker

复制代码

启动并启用Docker服务

Void Linux使用runit作为其init系统，因此服务管理与使用systemd的发行版有所不同。要启动并启用Docker服务：

2. # 创建Docker服务的符号链接以启用它
3. sudo ln -s /etc/sv/docker /var/service/
5. # 检查服务状态
6. sudo sv status docker

复制代码

如果服务正在运行，您应该看到类似run: docker: (pid 1234) 10s的输出。

配置Docker

为了确保Docker与Kubernetes正常工作，我们需要配置Docker使用systemd作为cgroup驱动。创建或编辑Docker的daemon配置文件：

2. sudo mkdir -p /etc/docker
3. sudo nano /etc/docker/daemon.json

复制代码

添加以下内容：

2. {
3.   "exec-opts": ["native.cgroupdriver=systemd"],
4.   "log-driver": "json-file",
5.   "log-opts": {
6.     "max-size": "100m"
7.   },
8.   "storage-driver": "overlay2"
9. }

复制代码

重新启动Docker服务以应用更改：

2. sudo sv restart docker

复制代码

验证Docker安装

运行一个简单的Docker命令来验证安装是否成功：

2. sudo docker run hello-world

复制代码

如果一切正常，您应该看到一条欢迎消息，表明Docker已正确安装并运行。

安装Kubernetes组件

现在我们已经准备好安装Kubernetes的核心组件：kubeadm、kubelet和kubectl。

添加Kubernetes仓库

Void Linux默认仓库中不包含Kubernetes软件包，因此我们需要添加一个第三方仓库。我们将使用由社区维护的Kubernetes仓库。

首先，创建一个新的仓库配置文件：

2. sudo nano /etc/xbps.d/kubernetes.conf

复制代码

添加以下内容：

2. repository=https://repo.voidlinux-ppc.org/current

复制代码

注意：由于Void Linux的滚动发布性质和Kubernetes的快速迭代，您可能需要查找最新的适用于Void Linux的Kubernetes仓库。上面的URL可能需要根据实际情况进行调整。

安装Kubernetes组件

更新软件包列表并安装Kubernetes组件：

2. sudo xbps-install -Sy
3. sudo xbps-install -y kubeadm kubelet kubectl

复制代码

启动并启用kubelet服务

与Docker类似，我们需要启动并启用kubelet服务：

2. sudo ln -s /etc/sv/kubelet /var/service/
3. sudo sv status kubelet

复制代码

此时，kubelet服务可能会因为尚未配置而无法启动，这是正常的。我们将在初始化控制平面节点后解决这个问题。

固定Kubernetes版本

为了避免意外的版本升级导致集群不稳定，我们建议固定Kubernetes组件的版本：

2. sudo xbps-pkgdb -m hold kubeadm kubelet kubectl

复制代码

初始化控制平面节点

现在我们准备初始化Kubernetes控制平面节点。这将是集群的第一个节点，负责管理整个集群的状态。

初始化集群

在控制平面节点（k8s-master）上，运行以下命令来初始化集群：

2. sudo kubeadm init --pod-network-cidr=10.244.0.0/16

复制代码

--pod-network-cidr参数指定了Pod网络的CIDR范围，这是网络插件所必需的。我们使用10.244.0.0/16，因为我们将使用Flannel作为网络插件，这是其默认范围。

初始化过程可能需要几分钟时间，因为它需要拉取必要的容器镜像并设置集群组件。

配置kubectl

初始化完成后，您将看到一些输出，包括如何配置kubectl和如何将工作节点加入集群的说明。按照输出中的指示配置kubectl：

2. mkdir -p $HOME/.kube
3. sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
4. sudo chown $(id -u):$(id -g) $HOME/.kube/config

复制代码

验证控制平面节点状态

检查控制平面节点的状态：

2. kubectl get nodes

复制代码

此时，节点状态应该显示为NotReady，因为我们还没有安装网络插件。

保存加入命令

初始化输出中包含一个kubeadm join命令，用于将工作节点加入集群。保存此命令，我们稍后将需要它。它看起来类似于：

2. kubeadm join <control-plane-ip>:6443 --token <token> --discovery-token-ca-cert-hash <hash>

复制代码

安装网络插件

Kubernetes需要一个网络插件来处理Pod之间的网络通信。有许多选择，包括Calico、Flannel、Weave Net等。在本指南中，我们将使用Flannel，因为它简单且易于设置。

安装Flannel

应用Flannel的YAML配置：

2. kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml

复制代码

验证网络插件安装

等待几分钟，然后检查Pod状态：

2. kubectl get pods --all-namespaces

复制代码

您应该看到kube-system命名空间中的所有Pod都处于Running状态，包括flannel相关的Pod。

再次检查节点状态：

2. kubectl get nodes

复制代码

现在，控制平面节点的状态应该显示为Ready。

加入工作节点

现在我们已经准备好将工作节点加入集群。在每个工作节点上，执行之前保存的kubeadm join命令。

加入工作节点

在工作节点（k8s-worker1和k8s-worker2）上，运行：

2. sudo kubeadm join <control-plane-ip>:6443 --token <token> --discovery-token-ca-cert-hash <hash>

复制代码

将<control-plane-ip>、<token>和<hash>替换为实际值。

验证工作节点加入

在控制平面节点上，检查节点状态：

2. kubectl get nodes

复制代码

您应该看到所有节点（控制平面和工作节点）都列在输出中，并且它们的状态最终应该变为Ready。

验证集群

现在我们已经有了一个功能完整的Kubernetes集群，让我们验证它是否正常工作。

检查系统Pod

首先，检查所有系统Pod是否正常运行：

2. kubectl get pods --all-namespaces

复制代码

您应该看到kube-system命名空间中的所有Pod都处于Running状态。

部署测试应用

让我们部署一个简单的Nginx应用来测试集群：

2. kubectl create deployment nginx --image=nginx
3. kubectl expose deployment nginx --port=80 --type=NodePort

复制代码

检查部署和服务状态

检查部署状态：

2. kubectl get deployments
3. kubectl get pods

复制代码

检查服务状态：

2. kubectl get services

复制代码

测试应用

获取NodePort并访问Nginx服务：

2. # 获取服务详情
3. kubectl describe service nginx
5. # 在输出中找到NodePort，例如：NodePort: <port>/TCP

复制代码

然后，使用任何节点的IP地址和NodePort访问Nginx服务：

2. curl http://<node-ip>:<node-port>

复制代码

您应该看到Nginx的默认欢迎页面。

部署示例应用

现在我们已经验证了集群的基本功能，让我们部署一个更复杂的应用程序来展示Kubernetes的强大功能。我们将部署一个简单的WordPress网站，使用MySQL作为数据库。

创建MySQL部署

首先，创建一个MySQL部署和服务。创建一个名为mysql-deployment.yaml的文件：

2. apiVersion: apps/v1
3. kind: Deployment
4. metadata:
5.   name: mysql
6.   labels:
7.     app: mysql
8. spec:
9.   replicas: 1
10.   selector:
11.     matchLabels:
12.       app: mysql
13.   template:
14.     metadata:
15.       labels:
16.         app: mysql
17.     spec:
18.       containers:
19.       - name: mysql
20.         image: mysql:5.7
21.         ports:
22.         - containerPort: 3306
23.         env:
24.         - name: MYSQL_ROOT_PASSWORD
25.           value: "password"
26.         - name: MYSQL_DATABASE
27.           value: "wordpress"
28.         - name: MYSQL_USER
29.           value: "wordpress"
30.         - name: MYSQL_PASSWORD
31.           value: "wordpress"
32.         volumeMounts:
33.         - name: mysql-persistent-storage
34.           mountPath: /var/lib/mysql
35.       volumes:
36.       - name: mysql-persistent-storage
37.         persistentVolumeClaim:
38.           claimName: mysql-pv-claim
39. ---
40. apiVersion: v1
41. kind: Service
42. metadata:
43.   name: mysql
44. spec:
45.   ports:
46.   - port: 3306
47.   selector:
48.     app: mysql
49.   clusterIP: None

复制代码

创建MySQL持久卷

创建一个名为mysql-pv.yaml的文件：

2. apiVersion: v1
3. kind: PersistentVolume
4. metadata:
5.   name: mysql-pv
6. spec:
7.   capacity:
8.     storage: 20Gi
9.   accessModes:
10.     - ReadWriteOnce
11.   persistentVolumeReclaimPolicy: Retain
12.   hostPath:
13.     path: /data/mysql
14. ---
15. apiVersion: v1
16. kind: PersistentVolumeClaim
17. metadata:
18.   name: mysql-pv-claim
19. spec:
20.   accessModes:
21.     - ReadWriteOnce
22.   resources:
23.     requests:
24.       storage: 20Gi

复制代码

创建WordPress部署

创建一个名为wordpress-deployment.yaml的文件：

2. apiVersion: apps/v1
3. kind: Deployment
4. metadata:
5.   name: wordpress
6.   labels:
7.     app: wordpress
8. spec:
9.   replicas: 1
10.   selector:
11.     matchLabels:
12.       app: wordpress
13.   template:
14.     metadata:
15.       labels:
16.         app: wordpress
17.     spec:
18.       containers:
19.       - name: wordpress
20.         image: wordpress:latest
21.         ports:
22.         - containerPort: 80
23.         env:
24.         - name: WORDPRESS_DB_HOST
25.           value: mysql
26.         - name: WORDPRESS_DB_PASSWORD
27.           value: "wordpress"
28.         - name: WORDPRESS_DB_USER
29.           value: "wordpress"
30.         - name: WORDPRESS_DB_NAME
31.           value: "wordpress"
32. ---
33. apiVersion: v1
34. kind: Service
35. metadata:
36.   name: wordpress
37. spec:
38.   type: NodePort
39.   ports:
40.   - port: 80
41.     protocol: TCP
42.   selector:
43.     app: wordpress

复制代码

应用配置

应用所有这些配置：

2. kubectl apply -f mysql-pv.yaml
3. kubectl apply -f mysql-deployment.yaml
4. kubectl apply -f wordpress-deployment.yaml

复制代码

检查部署状态

检查Pod和服务的状态：

2. kubectl get pods
3. kubectl get services

复制代码

访问WordPress

获取WordPress服务的NodePort：

2. kubectl describe service wordpress

复制代码

使用任何节点的IP地址和NodePort访问WordPress：

2. http://<node-ip>:<node-port>

复制代码

您应该看到WordPress的安装页面。完成安装后，您将拥有一个完全功能的WordPress网站，运行在您的Kubernetes集群上。

常见问题和故障排除

在Void Linux上部署Kubernetes可能会遇到一些特定的问题。本节将介绍一些常见问题及其解决方案。

kubelet无法启动

如果kubelet服务无法启动，检查日志以获取更多信息：

2. sudo sv status kubelet
3. sudo tail -f /var/log/kubelet.log

复制代码

常见原因包括：

• Docker未运行或配置不正确
• cgroup驱动不匹配
• 网络配置问题

节点状态为NotReady

如果节点状态长时间显示为NotReady，可能是网络插件问题。检查kube-system命名空间中的Pod状态：

2. kubectl get pods --namespace=kube-system

复制代码

如果网络插件Pod未运行或出现错误，尝试重新安装网络插件。

Pod无法启动

如果Pod无法启动，使用describe命令获取更多信息：

2. kubectl describe pod <pod-name>

复制代码

检查事件部分以获取错误信息。常见问题包括：

• 镜像拉取失败
• 资源不足
• 配置错误

服务无法访问

如果服务无法访问，检查以下几点：

• 服务类型是否正确（ClusterIP、NodePort、LoadBalancer）
• Pod是否正常运行
• 网络策略是否阻止访问
• 防火墙规则是否允许流量

kubeadm join失败

如果工作节点无法加入集群，检查以下几点：

• 控制平面节点是否可达
• 令牌是否有效
• 网络连接是否正常
• 防火墙是否阻止了必要的端口

如果令牌已过期，可以在控制平面节点上生成新令牌：

2. sudo kubeadm token create --print-join-command

复制代码

结论

在本指南中，我们详细介绍了如何在Void Linux上部署和运行一个功能完整的Kubernetes集群。从准备工作到验证集群，我们涵盖了每个步骤，并提供了解决可能遇到的问题的方法。

Void Linux作为一个小众但高效的发行版，提供了一个有趣的环境来运行Kubernetes。虽然它可能不像Ubuntu或CentOS那样有广泛的文档和社区支持，但其简洁的设计和滚动发布模型使其成为那些寻求不同选择的用户的理想选择。

通过本指南，您不仅学会了如何在Void Linux上部署Kubernetes，还了解了如何部署和管理应用程序，以及如何解决常见问题。这些知识将帮助您在任何Linux发行版上更有效地使用Kubernetes。

随着容器技术的不断发展，Kubernetes作为容器编排平台的重要性只会增加。无论您是系统管理员、开发人员还是DevOps工程师，掌握Kubernetes都将成为一项宝贵的技能。而了解如何在不同的操作系统上部署和管理Kubernetes，将使您在面对各种环境和挑战时更加灵活和自信。

我们希望本指南能够帮助您在Void Linux上成功部署和运行Kubernetes集群，并鼓励您进一步探索这两个强大的技术。