温馨提示×

Ubuntu怎样安装K8s集群

小樊
40
2026-10-13 10:35:56
栏目: 智能运维

下面给你一份在 Ubuntu 上从零安装 Kubernetes(K8s)集群的实用指南,适用于 Ubuntu 20.04 / 22.04,使用 kubeadm(官方推荐方式)。


一、环境准备

1. 机器规划(示例)

角色 主机名 IP
Master k8s-master 192.168.1.10
Worker k8s-node1 192.168.1.11

最低配置:2 CPU、2G 内存
所有节点都要操作,除非特别说明


2. 系统设置(所有节点)

# 设置主机名
sudo hostnamectl set-hostname k8s-master   # node上改成对应名字

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

# 加载内核模块
cat <<EOF | sudo tee /etc/modules-load.d/k8s.conf
overlay
br_netfilter
EOF

sudo modprobe overlay
sudo modprobe br_netfilter

# 网络参数
cat <<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

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

K8s 1.24+ 不再支持 docker,推荐 containerd

sudo apt update
sudo apt install -y containerd

# 生成默认配置
sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml

# 使用 systemd cgroup
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

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

echo "deb [signed-by=/etc/apt/keyrings/kubernetes.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 \
  --pod-network-cidr=10.244.0.0/16 \
  --image-repository=registry.aliyuncs.com/google_containers

成功后会看到:

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

配置 kubectl

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

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

kubectl apply -f https://raw.githubusercontent.com/flannel-io/flannel/master/Documentation/kube-flannel.yml

等待:

kubectl get nodes

六、加入 Worker 节点

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

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

七、验证集群

kubectl get nodes
kubectl get pods -A

八、常见问题

1. token 过期

kubeadm token create --print-join-command

2. 想用 Docker?

可安装 cri-dockerd,但不推荐新手使用。

3. 单机测试

kubectl taint nodes --all node-role.kubernetes.io/control-plane-

如果你愿意,我可以:

  • 给你 一键脚本
  • 讲 kubeadm vs 二进制安装
  • 教你 部署 Dashboard / Ingress / Helm

你打算用于 学习 / 生产 / 本地虚拟机?

0 踩