使用kubeadm部署kubernetes1.27.1版本教程
更新時(shí)間：2025年08月13日 09:08:16 作者：珂玥c
文章概述了K8s集群搭建的準(zhǔn)備與兩種部署方式：kubeadm（快速）和二進(jìn)制（手動(dòng)）,涵蓋單master配置、硬件要求、網(wǎng)絡(luò)設(shè)置及初始化流程,適用于測(cè)試環(huán)境,提供參考經(jīng)驗(yàn)
一、搭建前的準(zhǔn)備
1. 搭建k8s的平臺(tái)規(guī)劃
單master集群：只有一個(gè)master，管理多個(gè)node節(jié)點(diǎn)。
多master集群：擁有多個(gè)master，管理多個(gè)node節(jié)點(diǎn)。高可用模式。比單master集群多一個(gè)負(fù)載均衡的步驟。
test環(huán)境搭建，因此采用單master集群，如后續(xù)有需要可再增加master。
2. 服務(wù)器硬件配置要求
- master節(jié)點(diǎn)：
| 測(cè)試環(huán)境 | 生產(chǎn)環(huán)境 | |
| CPU | 2 | 8 |
| 內(nèi)存 | 4G | 16G |
| 硬盤(pán) | 20G | 100G |
- node節(jié)點(diǎn)：
| 測(cè)試環(huán)境 | 生產(chǎn)環(huán)境 | |
| CPU | 4 | 16 |
| 內(nèi)存 | 8G | 64G |
| 硬盤(pán) | 40G | 500G |
3. 搭建部署的方式
目前常見(jiàn)的有兩種方式：
1）kubeadm方式
- kubeadm是k8s的一個(gè)部署工具，部署方式比較簡(jiǎn)單。只需要用到兩個(gè)命令，kubeadm init（初始化）和 kubeadm join（將node節(jié)點(diǎn)加入到master中）?？梢钥焖俨渴餶8s集群。
- 優(yōu)點(diǎn)是快速，無(wú)需額外自己處理。比較常見(jiàn)且節(jié)約時(shí)間
官方鏈接：https://kubernetes.io/docs/reference/setup-tools/kubeadm/
2）二進(jìn)制方式
- 從 github 下載二進(jìn)制包，手動(dòng)部署每個(gè)組件，過(guò)程比較麻煩。
- 優(yōu)點(diǎn)是，遇到問(wèn)題后可以精準(zhǔn)定位，有利于后續(xù)維護(hù)。畢竟是自己一步一步操作的，更清楚里面的彎彎繞繞~
二、搭建流程
1. kubeadm搭建方式
大致流程：
1）創(chuàng)建一個(gè)master節(jié)點(diǎn) kubeadm init
2）將node節(jié)點(diǎn)加入到當(dāng)前集群中 kubeadm join <master節(jié)點(diǎn)的ip和端口>
3）配置網(wǎng)絡(luò)插件和測(cè)試k8s集群
機(jī)器配置：
- -- 準(zhǔn)備了一臺(tái)master，一臺(tái)node。硬件配置CPU 2核，內(nèi)存251G，硬盤(pán)500G
- -- 機(jī)器之間可以互相ping通，操作系統(tǒng)為CentOS7
- -- 禁止swap分區(qū)
- -- 可以拉取鏡像
master: 192.10.18.102 node: 192.10.18.103
a. 準(zhǔn)備工作，系統(tǒng)初始化
由于自己用的是之前配置好的舊物理機(jī)，所以跳過(guò)此流程。如果需要用虛擬機(jī)的話(huà)。要進(jìn)行安裝3臺(tái)Centos7.x的操作系統(tǒng)，之后進(jìn)行如下初始化：
- 1）關(guān)閉防火墻
systemctl stop firewalld systemctl disable firewalld
- 2）關(guān)閉selinux
sed -i 's/enforcing/disabled/' /etc/selinux/config #永久關(guān)閉 setenforce 0 #臨時(shí)關(guān)閉
- 3）關(guān)閉swap
swapoff -a #臨時(shí)關(guān)閉 sed -ri 's/."swap."/#&/' /etc/fstab #永久關(guān)閉
- 4）設(shè)置主機(jī)名
hostnamectl set-hostname <hostname>
- 5）只在master添加hosts
cat >> /etc/hosts << EOF ip master ip node1 ip node2 EOF
- 6）將橋接的ipv4流量傳遞到iptables的鏈，配置內(nèi)核參數(shù)和優(yōu)化
cat > /etc/sysctl.d/k8s.conf <<EOF net.bridge.bridge-nf-call-ip6tables = 1 net.bridge.bridge-nf-call-iptables = 1 net.ipv4.ip_forward = 1 EOF sysctl --system #生效命令
- 7）時(shí)間同步
yum install ntpdate -y ntpdate time.windows.com
- 8）安裝ipset、ipvsadm
yum -y install conntrack ipvsadm ipset jq iptables curl sysstat libseccomp wget vim net-tools git cat > /etc/modules-load.d/ipvs.conf <<EOF # Load IPVS at boot ip_vs ip_vs_rr ip_vs_wrr ip_vs_sh nf_conntrack nf_conntrack_ipv4 EOF systemctl enable --now systemd-modules-load.service ###注?。?！若此處失敗，可能是因?yàn)閮?nèi)核版本低導(dǎo)致的，可升級(jí)內(nèi)核后，再執(zhí)行此命令##### #確認(rèn)內(nèi)核模塊加載成功 lsmod |egrep "ip_vs|nf_conntrack_ipv4"
b. 升級(jí)內(nèi)核（根據(jù)自己情況進(jìn)行選擇，滿(mǎn)足時(shí)可不升級(jí)）
- 1）查看系統(tǒng)版本
cat /etc/redhat-release
- 2）查看當(dāng)前內(nèi)核版本
uname -r
- 3）檢查是否安裝ELRepo
yum --disablerepo="*" --enablerepo="elrepo-kernel" list available
看到error說(shuō)明沒(méi)有安裝ELRepo
- 4）升級(jí)安裝ELRepo
安裝
yum install -y https://www.elrepo.org/elrepo-release-7.el7.elrepo.noarch.rpm
或升級(jí)
rpm -Uvh https://www.elrepo.org/elrepo-release-7.el7.elrepo.noarch.rpm
- 5）查看可用安裝包， 長(zhǎng)期維護(hù)版本為lt，最新主線穩(wěn)定版為ml
yum --disablerepo="*" --enablerepo="elrepo-kernel" list available
- 6）安裝最新的內(nèi)核
yum --enablerepo=elrepo-kernel install -y kernel-lt
- 7）查看可用內(nèi)核版本及啟動(dòng)順序
awk -F\' '$1=="menuentry " {print i++ " : " $2}' /boot/grub2/grub.cfg- 8）安裝輔助工具（非必須，有些系統(tǒng)自帶該工具）：grub2-pc
yum install -y grub2-pc
- 9）設(shè)置內(nèi)核默認(rèn)啟動(dòng)順序
grub2-set-default 0
vim /etc/default/grub GRUB_DEFAULT=0 #這里從原來(lái)的saved改為0
- 10）生成grub配置文件
# 運(yùn)行g(shù)rub2-mkconfig命令來(lái)重新創(chuàng)建內(nèi)核配置
grub2-mkconfig -o /boot/grub2/grub.cfg
- 11）重啟機(jī)器
reboot
- 12）查看內(nèi)核版本是否正確
uname -r
- 13）安裝 yum-utils 工具
當(dāng)系統(tǒng)安裝的內(nèi)核大于3個(gè)時(shí)，會(huì)自動(dòng)刪除舊的內(nèi)核版本或自己查看已經(jīng)安裝的內(nèi)核后手動(dòng)yum remove -y 進(jìn)行刪除舊版本
yum install -y yum-utils
- 14）刪除舊的工具包
yum remove kernel-tools-libs.x86_64 kernel-tools.x86_64
- 15）安裝新版本的工具包
yum --disablerepo=\* --enablerepo=elrepo-kernel install -y kernel-lt-tools.x86_64
- 16）查看已安裝內(nèi)核
rpm -qa | grep kernel
c. 設(shè)置一下ipv4，否則會(huì)失敗（此處為坑，不設(shè)置無(wú)法初始化成功）
vim /etc/sysconfig/modules/ipvs.modules cat /etc/sysconfig/modules/ipvs.modules nf_conntrack systemctl enable --now systemd-modules-load.service lsmod |egrep "ip_vs|nf_conntrack_ipv4" lsmod |egrep "ip_vs|nf_conntrack_ipv"
d. 安裝containerd
1）安裝依賴(lài)軟件包
yum -y install yum-utils device-mapper-persistent-data lvm2
2）添加阿里Docker源
[root@k8s-master ~]
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
3）添加overlay和netfilter模塊
cat >>/etc/modules-load.d/containerd.conf <<EOF overlay br_netfilter EOF
modprobe overlay modprobe br_netfilter
4）安裝Containerd，這里安裝最新版本（1.5版本及以下不可使用）
yum -y install containerd.io
5）創(chuàng)建Containerd的配置文件
mkdir -p /etc/containerd containerd config default > /etc/containerd/config.toml sed -i '/SystemdCgroup/s/false/true/g' /etc/containerd/config.toml sed -i '/sandbox_image/s/registry.k8s.io/registry.aliyuncs.com\/google_containers/g' /etc/containerd/config.toml
6）啟動(dòng)containerd
systemctl enable containerd systemctl start containerd
e.安裝kubectl、kubelet、kubeadm
1）添加阿里kubernetes源
vim /etc/yum.repos.d/kubernetes.repo [kubernetes] name=Kubernetes baseurl=https://mirrors.aliyun.com/kubernetes/yum/repos/kubernetes-el7-x86_64/ enabled=1 gpgcheck=0 repo_gpgcheck=0 gpgkey=https://mirrors.aliyun.com/kubernetes/yum/doc/yum-key.gpg https://mirrors.aliyun.com/kubernetes/yum/doc/rpm-package-key.gpg
2）安裝kubectl、kubelet、kubeadm
查看所有的可用版本
yum list kubelet --showduplicates |grep 1.27
這里安裝當(dāng)前最新版本1.27.1
yum -y install kubectl-1.27.1 kubelet-1.27.1 kubeadm-1.27.1
設(shè)置開(kāi)機(jī)自啟kubelet（此時(shí)并沒(méi)有kubelet配置文件無(wú)法啟動(dòng)，正常狀況）
systemctl enable kubelet systemctl start kubelet
f. master節(jié)點(diǎn)進(jìn)行初始化操作
1）查看k8s v1.27.1初始化所需要的鏡像
kubeadm config images list --kubernetes-version=v1.27.1
2）初始化命令
kubeadm init --kubernetes-version=1.27.1 --apiserver-advertise-address=10.142.50.190 --image-repository registry.aliyuncs.com/google_containers --pod-network-cidr=10.244.0.0/16
注：pod的網(wǎng)段為: 10.244.0.0/16，api server地址為Master本機(jī)IP，網(wǎng)段可以自定義，不沖突即可。
參數(shù)詳解：
指定版本。（可按需修改版本）
- -- 設(shè)置了apiserver，即當(dāng)前節(jié)點(diǎn)的ip。
- -- 指定鏡像倉(cāng)庫(kù)地址，拉取鏡像。
- -- service-cidr是svc網(wǎng)絡(luò) kubectl get svc #查看svc信息
默認(rèn)使用10.96.0.0/12
- -- pod-network-cidr 是pod網(wǎng)絡(luò) kubectl get pods -o wide #查看pod網(wǎng)絡(luò)信息
- -- k8s內(nèi)部的pod節(jié)點(diǎn)之間網(wǎng)絡(luò)可以使用的IP段，不能和service-cidr寫(xiě)一樣，默認(rèn)使用10.244.0.0/16
此操作，等待時(shí)間較長(zhǎng)
3）成功返回信息，執(zhí)行返回內(nèi)容即可
Your Kubernetes control-plane has initialized successfully! To start using your cluster, you need to run the following as a regular user: mkdir -p $HOME/.kube sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config sudo chown $(id -u):$(id -g) $HOME/.kube/config Alternatively, if you are the root user, you can run: export KUBECONFIG=/etc/kubernetes/admin.conf You should now deploy a pod network to the cluster. Run "kubectl apply -f [podnetwork].yaml" with one of the options listed at: https://kubernetes.io/docs/concepts/cluster-administration/addons/ Then you can join any number of worker nodes by running the following on each as root: kubeadm join IP:6443 --token maod8l.w4g2cu2tl4er9gil \ --discovery-token-ca-cert-hash sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
master節(jié)點(diǎn)執(zhí)行
mkdir -p $HOME/.kube sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config sudo chown $(id -u):$(id -g) $HOME/.kube/config
node節(jié)點(diǎn)執(zhí)行
kubeadm join IP:6443 --token maod8l.w4g2cu2tl4er9gil \ --discovery-token-ca-cert-hash sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
2. 二進(jìn)制搭建流程
- a. 創(chuàng)建多臺(tái)虛擬機(jī)，安裝linux操作系統(tǒng)
- b. 操作系統(tǒng)初始化（各種關(guān)關(guān)關(guān)）
- c. 為etcd和apiserver自簽證書(shū)（相當(dāng)于門(mén)禁卡，保證互通）
- d. 部署etcd集群
- e. 部署master組件
kube-apiserver kube-controller-manager kube-scheduler etcd
- f. 部署node組件
kubelet kube-proxy docker etcd
- g. 部署集群網(wǎng)絡(luò)
總結(jié)
以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。
相關(guān)文章
K8s Pod調(diào)度機(jī)制詳解(從理論到生成實(shí)戰(zhàn)指南)
Kubernetes調(diào)度機(jī)制是集群的智能調(diào)度中樞,主要完成過(guò)濾和打分兩個(gè)決策,在生產(chǎn)環(huán)境中,核心調(diào)度策略包括資源調(diào)度、親和性調(diào)度、污點(diǎn)與容忍、拓?fù)浞植技s束等,本文介紹K8s Pod調(diào)度機(jī)制詳解(從理論到生成實(shí)戰(zhàn)指南),感興趣的朋友一起看看吧2025-03-03
使用sealos快速搭建K8s集群環(huán)境的過(guò)程
這篇文章主要介紹了使用sealos快速搭建K8s集群環(huán)境,主要包括sealos安裝方法，虛擬機(jī)設(shè)置方法，本文給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2022-09-09
Kubernetes?DNS解析實(shí)戰(zhàn)過(guò)程
Kubernetes中,Pod需Ready狀態(tài)才會(huì)被CoreDNS解析,而Service創(chuàng)建時(shí)即添加記錄,當(dāng)服務(wù)依賴(lài)Pod解析時(shí)易引發(fā)啟動(dòng)死循環(huán),通過(guò)設(shè)置Service的publishNotReadyAddresses為true,可解決此問(wèn)題,允許未就緒Pod的IP立即被解析2025-09-09
這篇文章主要介紹了k8s容器的內(nèi)存設(shè)置的踩坑記錄,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2025-07-07
這篇文章主要給大家介紹了關(guān)于K8S中五種控制器及使用的相關(guān)資料,控制器 又稱(chēng)之為工作負(fù)載,本文通過(guò)圖文以及實(shí)例代碼介紹的非常詳細(xì),需要的朋友可以參考下2021-12-12
k8s?service?nodePort無(wú)法訪問(wèn)的問(wèn)題解決
今天有一個(gè)項(xiàng)目做service nodeport轉(zhuǎn)發(fā),結(jié)果設(shè)置完之后發(fā)現(xiàn)外網(wǎng)訪問(wèn)失敗,下面這篇文章主要給大家介紹了關(guān)于k8s?service?nodePort無(wú)法訪問(wèn)的問(wèn)題解決,文中通過(guò)圖文介紹的非常詳細(xì),需要的朋友可以參考下2023-01-01
k8s實(shí)現(xiàn)身份認(rèn)證策略及過(guò)程解析
這篇文章主要為大家介紹了k8s實(shí)現(xiàn)身份認(rèn)證策略及過(guò)程解析，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2023-02-02
Ingress是一種向k8s集群外部的客戶(hù)端公開(kāi)服務(wù)的方法,下面這篇文章主要給大家介紹了關(guān)于k8s之ingress-nginx詳解和部署方案的相關(guān)資料,文中通過(guò)實(shí)例代碼介紹的非常詳細(xì),需要的朋友可以參考下2022-07-07
本文詳細(xì)介紹了如何部署Kubernetes集群,包括安裝Docker、配置阿里云YUM軟件源、安裝kubeadm、kubelet和kubectl,以及部署Kubernetes、安裝Pod網(wǎng)絡(luò)插件和將節(jié)點(diǎn)加入集群的過(guò)程,感興趣的朋友一起看看吧2025-03-03
K8s集群(kubeadm)CA證書(shū)過(guò)期的解決過(guò)程
在K8s集群中,CA證書(shū)和Token都會(huì)過(guò)期,導(dǎo)致新節(jié)點(diǎn)無(wú)法加入集群,需要備份舊證書(shū),重新生成新證書(shū)和配置文件,更新kubectl配置,重啟kubelet,重新加入工作節(jié)點(diǎn),驗(yàn)證集群節(jié)點(diǎn)狀態(tài)和健康狀況,確保K8s集群正常運(yùn)行2026-01-01