售前咨询400-838-0503

如何在Linux服务器上安装Kubernetes?

技术文档 2025-05-06 16:12

从零开始:Linux服务器上Kubernetes集群的完整安装指南

在当今云原生时代,Kubernetes已成为容器编排领域的事实标准。本文将详细介绍如何在Linux服务器上安装和配置Kubernetes集群,无论您是初学者还是有一定经验的开发者,都能通过本指南快速搭建自己的K8s环境。

准备工作

1.1 硬件要求

安装Kubernetes前,请确保您的Linux服务器满足以下最低要求:

  • CPU:至少2核
  • 内存:2GB以上(推荐4GB)
  • 磁盘空间:20GB可用空间
  • 网络:稳定的网络连接

1.2 系统要求

建议使用以下Linux发行版之一:

  • Ubuntu 16.04/18.04/20.04
  • CentOS 7/8
  • RHEL 7/8
  • Debian 9/10

确保系统已更新至最新版本:

# Ubuntu/Debian
sudo apt update && sudo apt upgrade -y

# CentOS/RHEL
sudo yum update -y

安装Docker容器运行时

Kubernetes需要容器运行时来管理容器,我们选择安装Docker CE:

2.1 Ubuntu/Debian系统安装Docker

sudo apt-get install -y apt-transport-https ca-certificates curl gnupg-agent software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io

2.2 CentOS/RHEL系统安装Docker

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
sudo systemctl enable docker

2.3 验证Docker安装

sudo docker run hello-world

安装Kubernetes组件

3.1 添加Kubernetes仓库

首先添加Kubernetes官方GPG密钥和仓库:

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install -y apt-transport-https curl
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list

# CentOS/RHEL
cat < /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF

3.2 安装Kubernetes组件

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl

# CentOS/RHEL
sudo yum install -y kubelet kubeadm kubectl
sudo systemctl enable --now kubelet

初始化Kubernetes集群

4.1 禁用交换分区

Kubernetes要求禁用交换分区:

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

4.2 初始化主节点

sudo kubeadm init --pod-network-cidr=10.244.0.0/16

初始化完成后,会显示加入集群的命令,请保存好此命令。

4.3 配置kubectl

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

安装网络插件

Kubernetes需要网络插件来实现Pod间通信,这里我们安装Flannel:

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

等待几分钟后,检查所有组件是否正常运行:

kubectl get pods --all-namespaces

加入工作节点

在其他服务器上重复上述步骤(不执行kubeadm init),然后使用初始化时生成的命令加入集群:

kubeadm join <主节点IP>:6443 --token  --discovery-token-ca-cert-hash sha256:

在主节点上验证节点状态:

kubectl get nodes

常见问题解决

6.1 cgroup驱动问题

如果遇到cgroup驱动不匹配问题,可以创建/etc/docker/daemon.json文件:

{
  "exec-opts": ["native.cgroupdriver=systemd"]
}

然后重启Docker:

sudo systemctl restart docker

6.2 端口冲突问题

确保以下端口未被占用:

  • 6443 (Kubernetes API server)
  • 2379-2380 (etcd server)
  • 10250 (Kubelet API)

总结

通过以上步骤,您已经在Linux服务器上成功搭建了一个Kubernetes集群。现在可以开始部署您的第一个应用了:

kubectl create deployment nginx --image=nginx
kubectl expose deployment nginx --port=80 --type=NodePort

Kubernetes的学习曲线可能较陡峭,但随着不断实践,您将逐渐掌握这个强大的容器编排工具。

如本公告涉及你的产品,或有不清楚之处,可提交工单确认。

提交工单