搭建 Kubernetes 集群的每个步骤详细的文档
文档 1: 前期准备
1.1 系统更新与基础工具安装
在所有 6 台 CentOS Stream 10 虚拟机上执行以下操作,确保系统为最新状态并安装必要的工具。
操作步骤:
-
更新系统软件包:
Bashsudo dnf update -y这会更新所有已安装的软件包到最新版本,确保系统稳定性和安全性。
-
安装常用工具(可选但推荐):
Bashsudo dnf install -y vim net-tools wget curl git这些工具在后续的配置和调试中会很有用。
1.2 禁用 SELinux
SELinux(Security-Enhanced Linux)的安全机制可能会干扰 Kubernetes 的正常运行,因此需要将其禁用。
操作步骤:
-
临时禁用 SELinux:
Bashsudo setenforce 0此命令会立即将 SELinux 设置为宽容模式(permissive),但重启后会失效。
-
永久禁用 SELinux:
Bashsudo sed -i 's/^SELINUX=enforcing$/SELINUX=permissive/' /etc/selinux/config这会修改 SELinux 的配置文件,使其在系统重启后也保持宽容模式。您可以选择将其设置为
disabled以完全禁用,但permissive模式通常也足够。
1.3 禁用 Firewalld
Firewalld 可能会阻止 Kubernetes 组件之间的网络通信,因此需要停止并禁用它。
操作步骤:
-
停止 Firewalld 服务:
Bashsudo systemctl stop firewalld -
禁用 Firewalld 开机启动:
Bashsudo systemctl disable firewalld为了简化集群搭建,禁用防火墙是最直接的方式。在生产环境中,您可能需要更精细地配置防火墙规则来允许必要的端口通信。
1.4 禁用 Swap
Kubernetes 官方要求禁用 Swap 内存,否则 kubelet 将无法启动。
操作步骤:
-
临时禁用 Swap:
Bashsudo swapoff -a此命令会立即关闭所有 Swap 分区。
-
永久禁用 Swap:
Bashsudo sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab这会注释掉
/etc/fstab文件中所有 Swap 分区的挂载配置,确保系统重启后 Swap 不会被再次启用。
1.5 配置内核参数
为了让 Kubernetes 能够正确地进行网络通信和容器管理,需要调整一些内核参数。特别是启用 IP 转发和桥接流量。
操作步骤:
-
加载必要的内核模块:
Bashcat <<EOF | sudo tee /etc/modules-load.d/k8s.conf overlay br_netfilter EOF sudo modprobe overlay sudo modprobe br_netfilter-
overlay模块支持容器的文件系统层叠功能。* -
br_netfilter模块用于将桥接流量传递给 iptables 进行处理,这是 Kubernetes 网络插件工作的基础。*
-
-
配置 sysctl 参数:
Bashcat <<EOF | sudo tee /etc/sysctl.d/k8s.conf net.bridge.bridge-nf-call-iptables = 1 net.bridge.bridge-nf-call-ip6tables = 1 net.ipv4.ip_forward = 1 EOF sudo sysctl --system-
net.bridge.bridge-nf-call-iptables和net.bridge.bridge-nf-call-ip6tables确保桥接网络流量能够被 iptables 处理,这是 Kubernetes 网络策略和服务的关键。* -
net.ipv4.ip_forward启用 IPv4 包转发,允许 Pod 之间以及 Pod 与外部之间的通信。* -
sudo sysctl --system会立即应用这些 sysctl 配置。*
-
1.6 配置主机名解析
为了让集群中的所有节点能够通过主机名相互通信,需要在 /etc/hosts 文件中添加所有节点的 IP 地址和主机名映射。
操作步骤:
-
编辑 /etc/hosts 文件:
在所有节点上,使用 sudo vim /etc/hosts 或其他编辑器打开 /etc/hosts 文件,并添加如下内容。请根据您的实际 IP 地址和计划的主机名进行修改。
# Master Node 192.168.1.10 k8s-master # Worker Nodes 192.168.1.11 k8s-worker1 192.168.1.12 k8s-worker2 192.168.1.13 k8s-worker3 192.168.1.14 k8s-worker4 192.168.1.15 k8s-worker5确保替换上述 IP 地址为您虚拟机的实际 IP 地址。
您可以通过 hostnamectl set-hostname <your-desired-hostname> 命令设置每个节点的主机名。例如,在 Master 节点上执行 sudo hostnamectl set-hostname k8s-master。
文档 2: 安装容器运行时 (Containerd)
Kubernetes 使用容器运行时来运行容器。Containerd 是一个行业标准的容器运行时,也是 Kubernetes 推荐的选择。以下步骤需要在所有节点上执行。
2.1 添加 Docker Yum 仓库
Containerd 通常会随 Docker Engine 一起发布,或者可以通过 Docker 官方仓库单独安装。这里我们利用 Docker 的 Yum 仓库来安装 Containerd。
操作步骤:
-
添加 Docker CE 的 Yum 仓库:
Bashsudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo此命令会为您的系统添加 Docker 的官方仓库配置,以便
dnf工具能够找到并安装 Docker 相关的软件包。
2.2 安装 Containerd
仓库添加完成后,现在可以安装 Containerd。
操作步骤:
-
安装 Containerd.io:
Bashsudo dnf install -y containerd.io-
containerd.io是 Docker 公司提供的 Containerd 包名。*
-
2.3 配置 Containerd
Kubernetes 要求 Containerd 使用 systemd 作为其 cgroup 驱动,以确保资源管理和监控的正确性。默认情况下,Containerd 可能不是这样配置的。
操作步骤:
-
创建 Containerd 默认配置文件:
Bashsudo mkdir -p /etc/containerd sudo containerd config default | sudo tee /etc/containerd/config.toml这会生成一个默认的
config.toml配置文件,并将其放置在/etc/containerd/目录下。 -
修改 Containerd 配置文件以使用 systemd cgroup 驱动:
Bashsudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml此命令会在
config.toml文件中查找SystemdCgroup = false这一行,并将其替换为SystemdCgroup = true。这是 Kubernetes 正常运行的必要配置。
2.4 启动并启用 Containerd 服务
完成配置后,启动 Containerd 服务并设置其开机自启动。
操作步骤:
-
启动 Containerd 服务:
Bashsudo systemctl start containerd -
设置 Containerd 开机自启动:
Bashsudo systemctl enable containerd您可以使用
sudo systemctl status containerd命令来检查服务状态,确保它正在运行且没有错误。
文档 3: 安装 Kubeadm、Kubelet 和 Kubectl
这些是 Kubernetes 集群的核心工具:
-
kubeadm: 用于初始化 Kubernetes 集群。 -
kubelet: 在集群中每个节点上运行的代理,用于管理 Pod 和容器。 -
kubectl: Kubernetes 命令行工具,用于与集群进行交互。
以下步骤需要在所有节点上执行。
3.1 添加 Kubernetes Yum 仓库
为了安装 Kubernetes 组件,您需要配置 Kubernetes 官方的 Yum 仓库。
操作步骤:
-
创建 Kubernetes 仓库文件:
Bashcat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo [kubernetes] name=Kubernetes baseurl=https://pkgs.k8s.io/core:/stable:/v1.30/rpm/ enabled=1 gpgcheck=1 gpgkey=ht
118



被折叠的 条评论
为什么被折叠?



