debian k8s安装环境准备

一、硬件要求

• 至少2核CPU、2GB内存、20GB可用磁盘空间（生产环境建议更高配置，如4核CPU、8GB内存及以上）。

二、系统与软件准备

• 操作系统选择：建议使用Debian 12或11（LTS版本，稳定性更好）。
• 系统更新：安装前执行sudo apt update && sudo apt upgrade -y，确保系统包为最新版本。
• 依赖包安装：提前安装必要工具包，命令如下：
  sudo apt install -y apt-transport-https ca-certificates curl software-properties-common。

三、网络配置

• 静态IP与主机映射：为每个节点（Master/Worker）配置静态IP地址，并在所有节点的/etc/hosts文件中添加节点IP与主机名的映射（如192.168.1.10 master、192.168.1.11 node1），确保节点间可通过主机名通信。
• 防火墙设置：若启用防火墙（如ufw），需放行Kubernetes关键端口：
  • API Server：sudo ufw allow 6443/tcp
  • kubelet：sudo ufw allow 10250/tcp、sudo ufw allow 10255/tcp
  • kube-controller-manager：sudo ufw allow 10257/tcp
  • kube-scheduler：sudo ufw allow 10259/tcp
    配置完成后执行sudo ufw reload生效。

四、关键系统配置

• 关闭Swap分区：Kubernetes要求禁用Swap以确保kubelet正常运行，执行以下命令：
  sudo swapoff -a（临时关闭）
  sudo sed -i '/ swap / s/1/g' /etc/fstab（永久禁用，注释掉fstab中的swap行）。
• 内核参数调整：加载必要内核模块并配置sysctl参数，创建/etc/modules-load.d/containerd.conf文件并写入：
  overlay br_netfilter
  执行sudo modprobe overlay && sudo modprobe br_netfilter加载模块；
  创建/etc/sysctl.d/99-kubernetes-k8s.conf文件并写入：
  net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
  执行sudo sysctl --system使配置生效。

五、容器运行时安装（Containerd/Docker）

• 推荐使用Containerd（Kubernetes原生推荐）：
  1. 安装containerd：sudo apt update && sudo apt install -y containerd。
  2. 初始化配置：sudo mkdir -p /etc/containerd，执行sudo containerd init生成默认配置。
  3. 启动服务：sudo systemctl enable --now containerd。
• 可选：安装Docker（若需兼容旧版本Kubernetes）：
  1. 添加Docker源：curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg；
     echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list。
  2. 安装Docker：sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io。
  3. 启动服务：sudo systemctl start docker && sudo systemctl enable docker。

六、Kubernetes组件安装

• 添加Kubernetes官方APT源：
  curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -；
  echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list。
• 安装kubelet、kubeadm、kubectl：
  sudo apt update && sudo apt install -y kubelet kubeadm kubectl；
  锁定版本（避免自动升级导致兼容性问题）：sudo apt-mark hold kubelet kubeadm kubectl。