Ubuntu系统安装Kubernetes (K8s) 主要步骤包括:更新系统、安装必要依赖、配置Kubernetes仓库、安装Kubeadm、Kubelet和Kubectl、初始化集群、加入节点。在这些步骤中,初始化集群至关重要。通过kubeadm init
命令,您可以创建一个主节点并配置Pod网络。完成后,记得保存并使用输出的命令来让其他节点加入集群。这个过程不仅会帮助你成功部署K8s,还能确保你的集群在未来能轻松扩展和管理。
一、系统更新与依赖安装
确保您的Ubuntu系统是最新的,执行以下命令来更新软件包列表并升级所有安装的软件包:
sudo apt-get update
sudo apt-get upgrade -y
安装Kubernetes所需的基本工具和依赖项:
sudo apt-get install -y apt-transport-https ca-certificates curl
二、添加Kubernetes仓库
添加Google云的Kubernetes仓库,首先下载Google的GPG密钥并添加到apt-key:
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
然后,添加Kubernetes仓库源:
sudo bash -c 'cat <<EOF >/etc/apt/sources.list.d/kubernetes.list
deb http://apt.kubernetes.io/ kubernetes-xenial main
EOF'
更新apt包索引:
sudo apt-get update
三、安装Kubeadm、Kubelet和Kubectl
使用以下命令安装Kubernetes组件:
sudo apt-get install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl
kubelet
是在每个节点上运行的主代理,kubeadm
是用来初始化集群的工具,而 kubectl
是命令行工具,用于与Kubernetes集群通信。
四、禁用交换分区
Kubernetes要求禁用交换分区,执行以下命令:
sudo swapoff -a
sudo sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab
五、初始化Kubernetes集群
使用 kubeadm
初始化集群,建议您在主节点上执行以下命令:
sudo kubeadm init --pod-network-cidr=10.244.0.0/16
完成后,您会看到类似如下的输出信息,请注意保存用于节点加入的命令:
kubeadm join <master-ip>:<master-port> --token <token> --discovery-token-ca-cert-hash sha256:<hash>
配置kubectl命令行工具:
mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config
六、部署Pod网络
为了使Pods在集群中通信,需要部署Pod网络。这里使用Flannel作为示例:
kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml
七、加入其他节点到集群
在其他节点上运行初始化输出的kubeadm join
命令,示例如下:
sudo kubeadm join <master-ip>:<master-port> --token <token> --discovery-token-ca-cert-hash sha256:<hash>
八、验证集群安装
在主节点上运行以下命令以验证所有节点是否都已加入集群:
kubectl get nodes
输出应显示所有节点的状态为 Ready
。
九、常见问题及解决方法
节点未就绪:确保所有节点上都正确配置了Pod网络,并且swap已禁用。
证书问题:如果遇到证书问题,可以通过重新生成证书来解决:
sudo kubeadm init phase certs all --config kubeadm-config.yaml
网络问题:确认网络插件已正确部署并正在运行。
通过上述步骤,您应该能够在Ubuntu系统上成功安装并配置Kubernetes集群。确保遵循每一步,特别是初始化和网络配置,以保证集群的正常运行。
相关问答FAQs:
1. 在 Ubuntu 上安装 K8s 需要什么前置条件?
在 Ubuntu 上安装 Kubernetes(K8s)之前,需要确保系统满足一些前置条件。首先,使用的操作系统版本应为 Ubuntu 18.04 或更高版本。对于 Kubernetes,推荐至少有 2 GB 的 RAM 和 2 个 CPU 核心。确保系统的网络配置正常,能够访问外部互联网。接着,安装 Docker 或者其他容器运行时。Docker 是 Kubernetes 的默认容器运行时,可以通过以下命令安装:
sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl 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 服务已启动并设置为开机自启:
sudo systemctl start docker
sudo systemctl enable docker
此外,禁用 swap 也是必要的,因为 Kubernetes 在启用时要求禁用 swap。可以通过以下命令完成:
sudo swapoff -a
如果需要永久禁用,可以编辑 /etc/fstab
文件,注释掉相关的 swap 行。
2. 如何在 Ubuntu 上安装和配置 K8s 的集群?
在 Ubuntu 上安装和配置 Kubernetes 集群通常可以使用 kubeadm 工具。首先,安装 kubelet、kubeadm 和 kubectl。这些组件是 Kubernetes 的核心部分。可以使用以下命令安装:
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 -
cat <<EOF | sudo tee /etc/apt/sources.list.d/kubernetes.list
deb https://apt.kubernetes.io/ kubernetes-xenial main
EOF
sudo apt-get update
sudo apt-get install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl
安装完成后,可以使用 kubeadm init
命令来初始化 Kubernetes 控制平面。这个命令会输出一些重要的信息,包括如何将工作节点加入集群。通常,初始化命令如下:
sudo kubeadm init --pod-network-cidr=192.168.0.0/16
初始化完成后,按照输出的提示进行后续步骤。将当前用户添加到 kube
组,以便于后续使用 kubectl
命令:
mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config
为了使集群正常运行,还需安装网络插件,例如 Calico 或 Flannel。选择合适的网络插件并执行相应的安装命令即可。例如,安装 Calico:
kubectl apply -f https://docs.projectcalico.org/manifests/calico.yaml
3. 如何管理和维护 K8s 集群的运行状态?
管理和维护 Kubernetes 集群的健康状态是保证应用正常运行的重要环节。使用 kubectl
命令可以轻松地查看集群的状态。可以使用以下命令查看节点的状态:
kubectl get nodes
该命令会列出所有节点及其状态(Ready、NotReady 等)。对于 Pods 的管理,可以使用:
kubectl get pods --all-namespaces
此外,定期更新 K8s 版本也是维护的关键。使用以下命令可以检查当前安装的版本:
kubectl version --short
如果需要升级 Kubernetes,可以使用 kubeadm 进行版本升级。首先,更新 kubeadm
,然后使用 kubeadm upgrade
命令进行升级:
sudo apt-get update && sudo apt-get install -y kubeadm
sudo kubeadm upgrade plan
sudo kubeadm upgrade apply v1.XX.X
在升级完成后,记得更新 kubelet 和 kubectl:
sudo apt-get update && sudo apt-get install -y kubelet kubectl
sudo systemctl restart kubelet
定期监测集群的健康状态、资源使用情况和日志信息,确保系统平稳运行。使用 Kubernetes Dashboard 也是一个很好的选择,可以通过 Web 界面直观地查看集群状态。
关于 GitLab 的更多内容,可以查看官网文档:
官网地址: https://gitlab.cn
文档地址: https://docs.gitlab.cn
论坛地址: https://forum.gitlab.cn
原创文章,作者:极小狐,如若转载,请注明出处:https://devops.gitlab.cn/archives/53063