如何在Ubuntu部署K8s

下面给你一份在 Ubuntu 上部署 Kubernetes（K8s）的实用指南，适用于学习 / 测试环境，并附带生产环境建议。

一、环境准备（所有节点都要做）

1. 系统要求

• Ubuntu 20.04 / 22.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

5. 加载内核模块 & 网络参数

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）

1. 安装 containerd

sudo apt update
sudo apt install -y containerd

2. 生成默认配置

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

3. 修改 SystemdCgroup

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

4. 重启 containerd

sudo systemctl restart containerd
sudo systemctl enable containerd

三、安装 kubeadm / kubelet / kubectl

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

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 \
  --pod-network-cidr=10.244.0.0/16

初始化成功后：

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

保存好 kubeadm join 命令（用于加入 worker）。

五、安装网络插件（Flannel 示例）

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

检查：

kubectl get nodes
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

七、验证集群

kubectl get nodes
kubectl run test --image=nginx
kubectl get pods

八、生产环境建议

• 使用 containerd + CRI
• Master 至少 3 节点（高可用）
• 使用 Calico / Cilium 网络
• 启用 RBAC / NetworkPolicy
• 使用 Helm / ArgoCD
• 日志 & 监控：Prometheus + Grafana

九、常见问题

• node NotReady → 网络插件未装
• swap 未关 → kubelet 起不来
• 镜像拉不到 → 配置国内镜像源

如果你愿意，我可以：

• 给你 一键脚本
• 教你 K3s（更轻量）
• 部署 Dashboard / Ingress / Helm

你现在是 学习还是生产使用？