Kubernetes 是一个可移植、可扩展的开源平台，用于管理容器化的工作负载和服务，可促进声明式配置和自动化。 Kubernetes 拥有一个庞大且快速增长的生态，其服务、支持和工具的使用范围相当广泛。

Kubernetes 这个名字源于希腊语，意为“舵手”或“飞行员”。k8s 这个缩写是因为 k 和 s 之间有八个字符的关系。

目录

版本详细：Ubuntu 20.04 + k8s v1.28 + containerd + Flannel

处了特殊标注外，均需要在所有服务器上执行！！！

准备工作

• 两台服务器，一台master、一台worker。

禁用Swap

# 临时关闭
sudo swapoff -a
 
# 永久关闭：注释 /etc/fstab 中的 swap 行
sudo sed -i '/swap/s/^/#/' /etc/fstab

加载内核模块并配置网络参数

# 加载 overlay 和 br_netfilter 模块
cat <<EOF | sudo tee /etc/modules-load.d/k8s.conf
overlay
br_netfilter
EOF
 
sudo modprobe overlay
sudo modprobe br_netfilter
 
# 设置 sysctl 参数
cat <<EOF | sudo tee /etc/sysctl.d/k8s.conf
net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1
EOF
 
# 应用配置
sudo sysctl --system

安装Containerd

# 安装 containerd
sudo apt install -y containerd
 
# 生成默认配置文件
sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml
 
# 修改配置：启用 systemd cgroup driver 并使用阿里云镜像加速
sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml
sudo sed -i 's|registry.k8s.io|registry.aliyuncs.com/google_containers|g' /etc/containerd/config.toml
 
# 重启 containerd
sudo systemctl restart containerd
sudo systemctl enable containerd

添加 Kubernetes 仓库

# 1. 安装依赖
sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl
 
# 2. 手动创建 keyrings 目录（关键！）
sudo mkdir -p /etc/apt/keyrings
 
# 3. 下载并转换 GPG 密钥
curl -fsSL https://mirrors.aliyun.com/kubernetes-new/core/stable/v1.28/deb/Release.key | \
    sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
 
# 4. 添加仓库源
echo "deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://mirrors.aliyun.com/kubernetes-new/core/stable/v1.28/deb/ /" | \
    sudo tee /etc/apt/sources.list.d/kubernetes.list > /dev/null
 
# 5. 更新包列表
sudo apt-get update

安装k8s

sudo apt install -y kubelet kubeadm kubectl
# 锁定版本，防止意外升级
sudo apt-mark hold kubelet kubeadm kubectl



# 其他安装方式方式

sudo apt-get install -y kubelet=1.28.0-00 kubeadm=1.28.0-00 kubectl=1.28.0-00
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 \
  --ignore-preflight-errors=Swap

配置

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://raw.githubusercontent.com/flannel-io/flannel/master/Documentation/kube-flannel.yml

# 如果网络访问不到，可以下载到本地，然后安装 kubectl apply -f  kube-flannel.yml
# 确认 kube-flannel.yml 中的 net-conf.json 里的 Network 字段是 10.244.0.0/16，和上面初始化时中的pod-network-cidr保持一致

验证集群状态

kubectl get nodes

应该会看到节点处于 NotReady → 一段时间后变为 Ready 状态,具体时间得看个人情况，不要着急。

root@dell72:/home/gouyu# kubectl get nodes
NAME     STATUS     ROLES           AGE     VERSION
dell72   NotReady   control-plane   6m41s   v1.28.15

root@dell72:/home/gouyu# kubectl get nodes
NAME     STATUS   ROLES           AGE     VERSION
dell72   Ready    control-plane   3h43m   v1.28.15

worker 主机

主机初始化完成后自动输出的：

kubeadm join 192.168.199.72:6443 --token bclpt6.0aiiilmxtixmvl9y \
        --discovery-token-ca-cert-hash sha256:xxxxxxxx 

如果忘记保存或者不知道，回到 Master 节点，执行以下命令重新生成一条：

kubeadm token create --print-join-command

重置集群

sudo kubeadm reset