Debian環境下K8S安裝指南

在Debian環境下安裝Kubernetes（K8S）集群是一個相對復雜的過程，需要仔細規劃和執行多個步驟。以下是一個詳細的安裝指南，基于Debian 12（Bookworm）版本。

硬件和環境要求

• CPU：至少2核
• 內存：至少2GB RAM
• 硬盤空間：至少20GB可用空間
• 網絡：穩定的互聯網連接，確保所有節點之間可以互相通信

安裝步驟

1. 設置主機名和更新hosts文件

在每個節點上設置主機名，并在/etc/hosts文件中添加相應的條目。

sudo hostnamectl set-hostname "k8s-master01.test.local"
# 在第一個工作節點運行
sudo hostnamectl set-hostname "k8s-worker01.test.local"
# 在第二個工作節點運行
sudo hostnamectl set-hostname "k8s-worker02.test.local"

# 在所有節點的 /etc/hosts 文件中添加以下條目:
192.168.16.20 k8s-master01.test.local k8s-master01
192.168.16.21 k8s-worker01.test.local k8s-worker01
192.168.16.22 k8s-worker02.test.local k8s-worker02

2. 關閉所有節點的swap分區

為了讓kubelet順利運行，建議禁用swap。

sudo swapoff -a
sudo sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab

3. 為k8s集群添加防火墻規則

如果你的Debian系統已啟用操作系統防火墻，請在主控節點和工作節點上分別允許以下端口。

# 在主控節點上運行
sudo ufw allow 6443/tcp
sudo ufw allow 2379/tcp
sudo ufw allow 2380/tcp
sudo ufw allow 10250/tcp
sudo ufw allow 10251/tcp
sudo ufw allow 10252/tcp
sudo ufw allow 10255/tcp
sudo ufw reload

# 在工作節點上運行
sudo ufw allow 10250/tcp
sudo ufw allow 30000:32767/tcp
sudo ufw reload

4. 在所有節點上安裝containerd運行時

containerd是Kubernetes支持的行業標準容器運行時。

# 設置內核參數
cat <<eof | sudo tee /etc/modules-load.d/containerd.conf
overlaybr_netfilter
eofs
sudo modprobe overlays
sudo modprobe br_netfilter

# 設置sysctl參數
cat <<eof | sudo tee /etc/sysctl.d/99-kubernetes-k8s.conf
net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
EOF
sudo sysctl -p /etc/sysctl.d/99-kubernetes-k8s.conf

5. 安裝Kubernetes工具

在所有節點上安裝kubeadm、kubelet和kubectl。

# 添加Kubernetes apt倉庫
curl https://mirrors.aliyun.com/kubernetes/apt/doc/apt-key.gpg | sudo apt-key add -
cat <<EOF | sudo tee /etc/apt/sources.list.d/kubernetes.list
deb https://mirrors.aliyun.com/kubernetes/apt/ kubernetes-xenial main
EOF
sudo apt-get update

# 安裝kubeadm、kubelet和kubectl
sudo apt-get install -y kubeadm kubelet kubectl
sudo systemctl enable kubelet.service
sudo systemctl start kubelet.service

6. 初始化主控節點

在主控節點上運行以下命令初始化集群。

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

7. 安裝網絡插件（例如Calico）

使用Calico設置Pod網絡。

kubectl apply -f https://docs.projectcalico.org/manifests/calico.yaml

8. 加入工作節點

在工作節點上運行以下命令加入集群。

sudo kubeadm join 192.168.16.20:6443 --token <token> --discovery-token-ca-cert-hash sha256:<hash>

驗證安裝

驗證Kubernetes集群是否正常運行。

kubectl get nodes

你應該能看到所有節點都處于Ready狀態。

注意事項

• 確保所有節點的時區一致，否則可能會導致時間同步問題。
• 在生產環境中，建議使用更穩定的網絡配置和防火墻規則。
• 定期更新Kubernetes集群和相關組件以保持安全和穩定性。

通過以上步驟，你應該能夠在Debian 12上成功安裝和配置一個Kubernetes集群。如果在安裝過程中遇到問題，請參考官方文檔或相關社區資源。