ubuntu安装单机版kubernetes

最新推荐文章于 2025-10-25 09:46:09 发布

原创

最新推荐文章于 2025-10-25 09:46:09 发布 · 1.7w 阅读

5 ·

CC 4.0 BY-SA版权

这篇博客介绍了如何在Ubuntu 14.04上安装单机版Kubernetes，包括Docker、etcd的安装步骤，以及Kubernetes的部署过程。博主分享了在Ubuntu上安装遇到的问题和解决方法，特别是对于etcd启动配置的注意事项。

网上kubenetes的安装大多是基于CoreOS或CentOS，Ubuntu资料比较少，由于本人测试阶段操作系统用的是ubuntu，折腾了多半天的时间才把环境搭起来，在这里简单记录一下，供需要的朋友参考

环境描述

ubuntu：14.04

docker：1.4.1

etcd：0.4.6

kubernetes：0.8.1

单机安装方式

1、安装Docker

curl -s https://get.docker.io/ubuntu/ | sudo sh

2、安装etcd，见https://github.com/coreos/etcd/releases/

得到etcd的压缩包，解压后进入etcd目录，找到二进制可执行文件：etcd，拷贝到/opt/bin目录下

3、安装kubenetes

3.1这里使用已编

最低0.47元/天解锁文章

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

小爷有点狂

关注关注

2
点赞
踩
5

收藏

觉得还不错? 一键收藏
5
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

Ubuntu Linux Server安装Kubernetes

wys的专栏

09-02

810

Ubuntu Linux Server安装Kubernetes

kubernetes_installation：在Ubuntu 20.04上安装Kubernetes

02-25

在Ubuntu 20.04上安装Kubernetes 从下面提到的Docker和Kubernetes网站获取有关安装的详细信息。设置Docker和Kubernetes存储库：下载适用于Docker的GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - 添加Docker存储库 # Docker has release the repository for Ubuntu 20.04 Focal LTS. # we can get the latest release versions from https://docs.docker.com sudo add-apt-repository " deb [arch=amd64] https://download.docker.

5 条评论您还未登录，请先登录后发表或查看评论

Ubuntu下安装kubernetes实践

01-09

操作环境：Ubuntu16.04 kubernetes15.1 一、更改主机配置在主节点和工作节点都要执行进入root模式 sudo passwd root su 更改主机名，主节点改为master，工作节点改为worker vi /etc/hostname 更改hosts文件 vi /etc/hosts 127.0.0.1 localhost.localdomain master 改完之后需要reboot重启关闭swap分区、关闭防火墙、禁用Selinux swapoff -a ufw status ufw disable apt install selinux-utils

UbuntuK8S部署安装

weixin_72659170的博客

10-25

1043

呕心沥血,花费一周踩坑终于完成,有问题可咨询。

在Ubuntu上快速安装单机版Kubernetes

weixin_34342207的博客

08-25

1720

Kubernetes Kubernetes是一个开源的，用于管理云平台中多个主机上的容器化的应用，Kubernetes的目标是让部署容器化的应用简单并且高效（powerful）,Kubernetes提供了应用部署，规划，更新，维护的一种机制。准备 docker:k8s底层是基于docker的,所以你需要先安装docker. 禁掉s...

Ubuntu22.04 安装单机版kubernetes

lym003的博客

05-26

1263

记录一次Ubuntu安装单机版k8s，一次性成功。

Kubernetes-ubuntu-单机搭建

u010889990的专栏

03-10

2924

1.下载kubernetes编译好的：https://github.com/GoogleCloudPlatform/kubernetes/releases 2.解压得到kubenetes目录,进入/kubenetes/server/目录，解压 tar -zxvf kubernetes-server-linux-amd64.tar.gz，得到kubenetes目录，将/kube

Ubuntu Kubernetes 安装

lzy__123的博客

02-10

985

本文使用的机器是：Welcome to Ubuntu 18.04.5 LTS (GNU/Linux 5.4.0-121-generic x86_64)

Ubuntu安装kubernetes1.24集群(使用containerd)

weixin_37672801的博客

03-03

1422

初始化kubernetes：kubeadm init --help可以查看命令的具体参数用法。将kubeadm init成功执行后的kubeadm join信息，复制到node节点执行。3台虚拟机，1个master节点，2个node节点。

在 Ubuntu 22.04 上安装 Kubernetes（Kubeadm 安装方式）

DZSpace，专注于计算机科学与技术领域的技术博主，致力于分享实用知识与技巧，帮助读者快速掌握技术要点，共同探索计算机世界的无限可能。欢迎访问DZSpace的博客，一起学习进步！

01-21

2205

使用 Kubeadm、Containerd 和 Calico 网络插件搭建 Kubernetes 集群教程。

Kubernetes安装-Ubuntu版

迪八戈的博客

06-30

2532

Ubuntu系统使用kubeadm安装Kubernetes

在Ubuntu上安装和部署Kubernetes

Flask Web

07-15

666

通过以上步骤，您已在Ubuntu上成功安装和部署了Kubernetes集群，并部署了一个简单的Nginx示例应用。后续可根据需求进一步扩展集群功能，如添加监控、日志管理、自动扩缩容等。希望以上示例对您有所帮助！如有其他问题，欢迎继续提问。

Ubuntu 22.04 部署 Kubernetes v1.30

田记赛码的博客

12-15

1697

Ubuntu 22.04 部署 Kubernetes v1.30

Ubuntu 24.04 上安装 Kubernetes，超级详细的教程！

xiaochong0302的博客

07-05

6203

Kubernetes 是一个免费的开源容器编排工具，它允许基于容器的应用程序的自动化部署、扩展和管理。我们将介绍如何使用 Kubeadm 逐步在 Ubuntu 24.04 上安装 Kubernetes。

ubuntu14.04单机安装kubernetes

weixin_33735077的博客

03-22

175

http://blog.youkuaiyun.com/u011641865/article/details/73845460 编辑：vi /etc/profileexport PATH="$PATH:/home/wolfplus/google-cloud-sdk/bin"source /etc/profile 转载于:https://blog.51cto.com/zhaopeiyan/2089938...

Ubuntu安装Kubernetes1.22.2

2201_75694536的博客

12-29

512

本文整合了一些文章帮助安装单节点Kubernetes。

基于Ubuntu下安装kubernetes集群指南

张兆坤

06-29

5024

kubernetes已经是后台开发的必知必会的技能了，最快速的学习方法莫过于自己从零开始搭建集群环境，在上面做各种实验了。以下为笔者基于ubuntu22.04.2操作系统和kubernete1.27.3以及docker24.0.2搭建k8s集群的详细过程，尽量详尽，少留坑。

在Ubuntu安装Kubernetes

BenXCN的博客

02-18

1326

在Ubuntu上安装Kubernetes

ubuntu安装kubernetes

know_1的博客

03-05

431

【代码】ubuntu安装kubernetes。

ubuntu22安装单机版k8s

最新发布

11-07

<think>我们将在Ubuntu 22.04上安装单机版Kubernetes（即只有一个master节点，不加入工作节点）。以下是详细步骤： ### 步骤1: 系统准备 1. **禁用交换空间**（Kubernetes要求）： ```bash sudo swapoff -a sudo sed -i '/ swap / s/^$.*$$/#\1/g' /etc/fstab # 永久禁用 ``` 2. **设置主机名**（可选，此处以`k8s-master`为例）： ```bash sudo hostnamectl set-hostname k8s-master ``` 3. **加载内核模块**： ```bash cat <<EOF | sudo tee /etc/modules-load.d/k8s.conf overlay br_netfilter EOF sudo modprobe overlay sudo modprobe br_netfilter ``` 4. **配置网络参数**： ```bash 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 ``` ### 步骤2: 安装容器运行时（containerd） 1. **安装依赖**： ```bash sudo apt update sudo apt install -y curl gnupg2 software-properties-common apt-transport-https ca-certificates ``` 2. **添加Docker仓库**： ```bash curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmour -o /etc/apt/trusted.gpg.d/docker.gpg sudo add-apt-repository -y "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" ``` 3. **安装containerd**： ```bash sudo apt update sudo apt install -y containerd.io ``` 4. **配置containerd**： ```bash sudo containerd config default | sudo tee /etc/containerd/config.toml >/dev/null sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml sudo systemctl restart containerd sudo systemctl enable containerd ``` ### 步骤3: 安装Kubernetes组件 1. **添加Kubernetes仓库**（使用阿里云镜像）： ```bash 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 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 ``` 2. **安装kubeadm, kubelet, kubectl**： ```bash sudo apt update sudo apt install -y kubelet kubeadm kubectl sudo apt-mark hold kubelet kubeadm kubectl # 锁定版本 ``` ### 步骤4: 初始化集群 ```bash sudo kubeadm init \ --apiserver-advertise-address=$(hostname -I | awk '{print $1}') \ --pod-network-cidr=192.168.0.0/16 \ --image-repository=registry.aliyuncs.com/google_containers ``` > 注意： > - `--apiserver-advertise-address` 使用本机IP（自动获取） > - `--pod-network-cidr` 使用Flannel网络插件的默认网段 > - 使用阿里云镜像仓库加速 ### 步骤5: 配置kubectl ```bash mkdir -p $HOME/.kube sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config sudo chown $(id -u):$(id -g) $HOME/.kube/config ``` ### 步骤6: 安装网络插件（Flannel） ```bash kubectl apply -f https://github.com/flannel-io/flannel/releases/latest/download/kube-flannel.yml ``` ### 步骤7: 验证安装 ```bash kubectl get nodes # 应显示STATUS为Ready kubectl get pods -n kube-system # 检查核心组件运行状态 ``` ### 常见问题解决 1. **初始化时端口占用**： ```bash sudo kubeadm reset -f sudo fuser -k 6443/tcp 10250/tcp # 释放关键端口 ``` 2. **镜像拉取失败**： ```bash # 手动拉取镜像（替换<image-name>） sudo crictl pull registry.aliyuncs.com/google_containers/<image-name> ``` 3. **节点处于NotReady状态**： - 检查网络插件是否安装成功 - 查看kubelet日志：`journalctl -xu kubelet` > 提示：单节点集群默认不会调度Pod，如需部署应用需去除master污点： > ```bash > kubectl taint nodes --all node-role.kubernetes.io/control-plane- > ``` ### 引用说明 - 系统准备步骤参考Kubernetes官方文档[^1] - 容器运行时配置采用containerd官方建议[^2] - 阿里云镜像源加速方案来自国内部署实践[^3] §§相关问题§§ 1. 如何彻底卸载Ubuntu上的Kubernetes集群？ 2. 单节点Kubernetes集群有哪些性能限制？ 3. 如何为Kubernetes配置持久化存储？ 4. 如何升级单节点Kubernetes版本？ 5. 在Kubernetes单节点上如何部署多节点应用？ </think>### Ubuntu 22.04 单机版 Kubernetes 安装指南 #### 一、系统准备 1. **禁用交换空间**（Kubernetes 强制要求）： ```bash sudo swapoff -a sudo sed -i '/ swap / s/^$.*$$/#\1/g' /etc/fstab # 永久禁用 ``` 2. **配置主机名解析**： ```bash echo "$(hostname -I | awk '{print $1}') $(hostname)" | sudo tee -a /etc/hosts ``` 3. **加载内核模块**： ```bash cat <<EOF | sudo tee /etc/modules-load.d/k8s.conf overlay br_netfilter EOF sudo modprobe overlay && sudo modprobe br_netfilter ``` 4. **设置网络参数**： ```bash 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. **安装依赖**： ```bash sudo apt update sudo apt install -y curl gnupg2 software-properties-common ``` 2. **添加 Docker 仓库**： ```bash curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null ``` 3. **安装 containerd**： ```bash sudo apt update sudo apt install -y containerd.io ``` 4. **配置 containerd**： ```bash sudo containerd config default | sudo tee /etc/containerd/config.toml sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml sudo systemctl restart containerd ``` #### 三、安装 Kubernetes 组件 1. **添加阿里云镜像源**： ```bash 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 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 ``` 2. **安装组件**： ```bash sudo apt update sudo apt install -y kubelet kubeadm kubectl sudo apt-mark hold kubelet kubeadm kubectl # 锁定版本 ``` #### 四、初始化单节点集群 ```bash sudo kubeadm init \ --apiserver-advertise-address=$(hostname -I | awk '{print $1}') \ --pod-network-cidr=10.244.0.0/16 \ --image-repository=registry.aliyuncs.com/google_containers \ --ignore-preflight-errors=NumCPU # 单机可忽略CPU检查 ``` > 📌 注意： > - `--apiserver-advertise-address` 使用本机IP > - `--pod-network-cidr` 使用 Flannel 的默认网段 > - 阿里云镜像加速避免超时问题[^3] #### 五、配置访问权限 ```bash mkdir -p $HOME/.kube sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config sudo chown $(id -u):$(id -g) $HOME/.kube/config # 允许在master节点部署Pod kubectl taint nodes --all node-role.kubernetes.io/control-plane- ``` #### 六、安装网络插件（Flannel） ```bash kubectl apply -f https://github.com/flannel-io/flannel/releases/latest/download/kube-flannel.yml ``` #### 七、验证安装 ```bash kubectl get nodes # 应显示 STATUS=Ready kubectl get pods -n kube-system # 检查核心组件 ``` #### 八、测试部署 ```bash kubectl create deployment nginx --image=nginx kubectl expose deployment nginx --port=80 --type=NodePort kubectl get svc nginx # 访问输出的端口号验证 ``` ### 常见问题解决 1. **初始化失败**： ```bash sudo kubeadm reset -f sudo rm -rf /etc/cni/net.d /etc/kubernetes/ ~/.kube/ ``` 2. **镜像拉取失败**： ```bash sudo kubeadm config images pull \ --image-repository=registry.aliyuncs.com/google_containers ``` 3. **端口占用冲突**： ```bash sudo fuser -k 6443/tcp 10250/tcp # 释放关键端口 ``` > 💡 **提示**：单节点集群适合开发测试，生产环境建议至少3节点[^1] ### 引用说明 - 内核参数配置参考 Kubernetes 官方文档[^1] - 阿里云镜像源加速方案来自国内部署实践[^3] - 单节点调度优化基于控制平面节点调度规则[^2]