温馨提示×

ubuntu下k8s如何部署

小樊
38
2026-10-28 11:02:57
栏目: 智能运维

下面给你一份在 Ubuntu 下部署 Kubernetes(k8s)的实战指南,以 kubeadm 方式为主(最常用、官方推荐),适用于 Ubuntu 20.04 / 22.04。


一、环境准备

1. 机器要求

  • 至少 2 台 Ubuntu 机器(1 master + 1+ worker)
  • 每台:
    • 2 CPU 以上
    • 2GB 内存以上
    • 静态 IP
    • 能联网

2. 关闭 swap(必须)

sudo swapoff -a
sudo sed -i '/swap/d' /etc/fstab

3. 设置主机名(示例)

# master
sudo hostnamectl set-hostname k8s-master

# node1
sudo hostnamectl set-hostname k8s-node1

4. 配置 hosts

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

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

1. 安装依赖

sudo apt update
sudo apt install -y curl gnupg2 software-properties-common apt-transport-https ca-certificates

2. 安装 containerd

sudo apt install -y containerd

3. 配置 containerd

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

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

sudo systemctl restart containerd
sudo systemctl enable containerd

三、安装 kubeadm / kubelet / kubectl

sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl

sudo curl -fsSL https://mirrors.aliyun.com/kubernetes/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/kubernetes-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/kubernetes-archive-keyring.gpg] https://mirrors.aliyun.com/kubernetes/apt/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list

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

四、初始化 Master 节点

sudo kubeadm init \
  --apiserver-advertise-address=192.168.1.10 \
  --image-repository registry.aliyuncs.com/google_containers \
  --pod-network-cidr=10.244.0.0/16

初始化成功后,会输出类似:

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

五、安装网络插件(Calico 示例)

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

等待所有 Pod 变成 Running:

kubectl get pods -n kube-system

六、加入 Worker 节点

在 worker 节点执行 master 输出的 kubeadm join 命令:

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

在 master 查看节点:

kubectl get nodes

七、验证集群

kubectl cluster-info
kubectl get nodes

八、常见问题

1. node 状态 NotReady

  • 网络插件未安装
  • containerd 的 SystemdCgroup 未开启

2. kubeadm 重置

sudo kubeadm reset
sudo rm -rf $HOME/.kube

九、可选增强

  • 安装 Metrics Server
  • 使用 Helm
  • 单机测试可用 minikube / kind

如果你需要:

  • ✅ 单节点 k8s
  • ✅ 国内加速完整脚本
  • ✅ Ubuntu + K3s
  • ✅ 生产级高可用部署

告诉我你的使用场景,我可以直接给你定制方案。

0 踩