温馨提示×

如何Ubuntu部署K8s

小樊
34
2026-10-13 10:34:57
栏目: 智能运维

下面给你一个在 Ubuntu 上部署 Kubernetes(K8s)的实用指南,适用于学习 / 测试环境(单 Master 或多 Node),使用的是目前最主流的方案:kubeadm + containerd。


一、环境准备

1. 系统要求

  • Ubuntu 20.04 / 22.04
  • 2 核 CPU 以上
  • 2GB 内存以上(Master 建议 4GB)
  • 多台机器(1 Master + N Worker)

2. 关闭 swap(必须)

sudo swapoff -a
sudo sed -i '/swap/s/^/#/' /etc/fstab

3. 设置主机名(每台机器)

sudo hostnamectl set-hostname master
# worker 节点
sudo hostnamectl set-hostname node1

4. 配置 hosts(所有节点)

cat <<EOF | sudo tee -a /etc/hosts
192.168.1.10 master
192.168.1.11 node1
EOF

二、安装容器运行时(containerd)

1. 安装依赖

sudo apt update
sudo apt install -y ca-certificates curl gnupg

2. 安装 containerd

sudo apt install -y containerd

3. 生成配置

sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml

4. 修改 SystemdCgroup

sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml

5. 启动 containerd

sudo systemctl restart containerd
sudo systemctl enable containerd

三、安装 kubeadm / kubelet / kubectl

1. 添加 Kubernetes 源

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
sudo apt update

2. 安装组件

sudo apt install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl

四、初始化 Master 节点

sudo kubeadm init \
  --pod-network-cidr=10.244.0.0/16 \
  --cri-socket=unix:///run/containerd/containerd.sock

初始化完成后会输出:

kubeadm join 192.168.1.10:6443 --token xxxx --discovery-token-ca-cert-hash sha256:xxxx

保存好这条命令

配置 kubectl

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

五、安装网络插件(CNI)

推荐 Flannel(简单稳定):

kubectl apply -f https://github.com/flannel-io/flannel/releases/latest/download/kube-flannel.yml

检查:

kubectl get pods -n kube-system

六、加入 Worker 节点

在 worker 节点 执行:

sudo kubeadm join 192.168.1.10:6443 \
  --token xxxx \
  --discovery-token-ca-cert-hash sha256:xxxx \
  --cri-socket=unix:///run/containerd/containerd.sock

在 Master 查看节点:

kubectl get nodes

七、验证集群

kubectl run nginx --image=nginx
kubectl get pods

八、常见问题

1. 节点 NotReady

  • 网络插件未安装
  • containerd Cgroup 配置错误

2. token 过期

kubeadm token create --print-join-command

九、可选增强

  • 多 Master(高可用)
  • Helm
  • Dashboard
  • Ingress(nginx-ingress)

如果你愿意,可以告诉我:

  • Ubuntu 版本
  • 单节点还是多节点
  • 是否用于生产

我可以给你更精确的部署方案或脚本。

0 踩