如何在 Ubuntu 上安装 K3s:轻量级 Kubernetes 集群搭建教程,模拟测试生产环境
Kubernetes 太重?资源不足?试试 K3s。本文将手把手教你如何在 Ubuntu 上快速安装 K3s,实现轻量级 Kubernetes 集群部署,适合边缘计算、物联网、个人测试和小型生产环境。
什么是 K3s?
K3s 是由 Rancher Labs 开发的一个轻量级 Kubernetes 发行版,兼容 Kubernetes API,安装包小于 100MB,启动快,运行内存需求低,非常适合在:
- 边缘设备(如树莓派、工控机)上运行
- 虚拟机或笔记本本地测试环境
- 快速原型验证或 CI/CD 场景
K3s 已通过 CNCF 认证,支持 Helm、Traefik、Ingress、LoadBalancer 等 Kubernetes 特性。
安装前准备
系统要求:
- Ubuntu 20.04 / 22.04 / Debian / CentOS 等
- 至少 2GB 内存(建议)
- 网络畅通(可以访问公网)
- root 或 sudo 权限
检查并更新系统:
复制
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl
Step 1:关闭 Swap(推荐)
Kubernetes 默认要求关闭 swap,K3s 也一样:
复制
sudo swapoff -a
sudo sed -i '/ swap / s/^/#/' /etc/fstab
可选:如果你不想关闭 swap,K3s 可以通过设置参数
--kubelet-arg fail-swap-on=false
跳过检查,本文后续会介绍。
Step 2:一键安装 K3s
使用官方脚本快速安装:
复制
curl -sfL https://get.k3s.io | sh -
安装成功后,K3s 会自动运行并注册为 Systemd 服务:
复制
systemctl status k3s
你可以使用以下命令验证集群状态:
复制
sudo kubectl get nodes
看到 Ready
状态说明安装成功。
Step 3:配置 kubectl 权限(非 root 用户)
默认 kubectl
配置文件在 /etc/rancher/k3s/k3s.yaml
,你可以拷贝到当前用户:
复制
mkdir -p $HOME/.kube
sudo cp /etc/rancher/k3s/k3s.yaml $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config
可选:使用国内镜像加速(中国用户推荐)
K3s 脚本支持使用阿里云镜像源:
复制
curl -sfL https://get.k3s.io | INSTALL_K3S_MIRROR=cn sh -
Step 4:允许开启 swap(可选)
如果你不想关闭 swap,可以这样安装:
复制
curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="--kubelet-arg fail-swap-on=false" sh -
或者编辑 Systemd:
复制
sudo systemctl edit k3s
加入以下内容:
复制
[Service]
ExecStart=
ExecStart=/usr/local/bin/k3s server --kubelet-arg fail-swap-on=false
然后执行:
复制
sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl restart k3s
卸载 K3s
如果你想删除 K3s,执行:
复制
sudo /usr/local/bin/k3s-uninstall.sh
K3s 安装常见问题
问题 | 解决方案 |
---|---|
kubeconfig 权限不足无法用 kubectl | 拷贝到 $HOME/.kube/config 并修改权限 |
无法连接镜像仓库(国外) | 使用 INSTALL_K3S_MIRROR=cn 安装 |
启用 swap 时安装失败 | 加 --kubelet-arg fail-swap-on=false |
相关资源推荐
作者:https://blog.xn--rpv331d.com/我不道啊
链接:https://blog.xn--rpv331d.com/我不道啊/blog/73
转载注意保留文章出处...
No data