K8s 二進(jìn)制部署工具箱一套不依賴 kubeadm 的 Kubernetes 二進(jìn)制部署方案組件全部拆開(kāi)獨(dú)立部署并配了一個(gè) Web 控制臺(tái)你只在一個(gè)地方操作——瀏覽器里的網(wǎng)頁(yè)。集群版本、節(jié)點(diǎn) IP / 主機(jī)名 / 角色、SSH 登錄密碼、CNI、網(wǎng)段、鏡像加速……全部在網(wǎng)頁(yè)填好點(diǎn)幾下按鈕后端直接在節(jié)點(diǎn)上執(zhí)行部署并把日志實(shí)時(shí)回傳不需要登錄服務(wù)器終端、不需要手改任何.sh文件。當(dāng)前內(nèi)置方案僅作示例展示Kubernetesv1.36.4/ Ubuntu 22.04 / 1 控制面 2 工作節(jié)點(diǎn) / Calico containerd。資源下載地址鏈接https://pan.quark.cn/s/ed2f4a893483提取碼XAnq1. 它解決了什么以前現(xiàn)在在服務(wù)器上跑一堆腳本自己看屏幕日志瀏覽器里點(diǎn)「一鍵部署」日志實(shí)時(shí)流式回傳先手改00-env.sh填 IPIP / 主機(jī)名 / 密碼都在網(wǎng)頁(yè)填腳本自動(dòng)代入自己ssh-copy-id配免密網(wǎng)頁(yè)填密碼后端自動(dòng)分發(fā)密鑰離線拷貝腳本包腳本直接落盤到目標(biāo)機(jī)/opt/k8s-install并執(zhí)行2. 目錄結(jié)構(gòu)k8s-deploy-kit/ ├── README.md ← 你在這里 ├── start-web.sh ← 在第一個(gè)控制面節(jié)點(diǎn)上啟動(dòng) Web 控制臺(tái)唯一需要的一次終端操作 ├── web/ ← Web 控制臺(tái)純前端 Python 標(biāo)準(zhǔn)庫(kù)后端無(wú)外部服務(wù)依賴 │ ├── index.html ← 配置界面 │ ├── server.py ← 后端靜態(tài)托管 SSH 編排 流式部署SSE │ ├── sshlib.py ← SSH 操作封裝基于 paramiko │ ├── assets/js/catalog.js ← 版本目錄新增版本只改這里 │ ├── assets/js/templates/ ← 腳本模板與配置解耦 │ └── tools/ ← selftest.js語(yǔ)法自檢、smoke.js頁(yè)面冒煙、build.js命令行渲染 ├── scripts/ ← 空占位目錄可選網(wǎng)頁(yè)「生成并寫入服務(wù)器」按鈕的落盤副本 └── offline/ ← 離線包說(shuō)明清單由頁(yè)面「離線清單」按鈕實(shí)時(shí)生成/檢查真正部署時(shí)腳本落在目標(biāo)機(jī)的/opt/k8s-install環(huán)境變量K8S_INSTALL_DIR可改scripts/只是留給你事后查看/導(dǎo)出的副本不參與執(zhí)行。??不要在倉(cāng)庫(kù)副本里直接跑腳本。倉(cāng)庫(kù)自帶的scripts/00-env.sh是默認(rèn) IP192.168.1.10/11/12。若你在~/k8s-deploy-kit/scripts里執(zhí)行本機(jī)真實(shí) IP 不在這份配置里角色會(huì)被判成worker于是報(bào)kube-controller-manager 只在控制面節(jié)點(diǎn)部署當(dāng)前角色worker。請(qǐng)始終在/opt/k8s-install網(wǎng)頁(yè)「一鍵部署」寫入的真實(shí)配置里執(zhí)行cd/opt/k8s-install./run-all.sh plan# 確認(rèn)本機(jī) IP 在配置的節(jié)點(diǎn)列表中cd/opt/k8s-install./run-all.sh step 08-deploy-controller-manager.sh??/opt/k8s-install里的腳本只在網(wǎng)頁(yè)點(diǎn)「一鍵部署 / 生成并寫入服務(wù)器」時(shí)才更新。手工./run-all.sh step xxx.sh跑的是磁盤上已存在的那份。所以改了參數(shù)后正確順序是先在網(wǎng)頁(yè)點(diǎn)「一鍵部署」它會(huì)先寫入最新腳本再執(zhí)行而不是直接手工重跑某一步。各腳本會(huì)自查關(guān)鍵項(xiàng)例如08會(huì)確認(rèn) systemd unit 里確實(shí)帶上了必需參數(shù)舊版會(huì)直接報(bào)錯(cuò)提醒。國(guó)內(nèi)鏡像加速地址https://docker.m.daocloud.io, https://hub-mirror.c.163.com, https://mirror.baidubce.com3. 標(biāo)準(zhǔn)流程全程網(wǎng)頁(yè)操作只需要一次終端操作在第一個(gè)控制面節(jié)點(diǎn)上啟動(dòng) Web 控制臺(tái)。其余全在瀏覽器里完成。第 1 步啟動(dòng) Web 控制臺(tái)僅此一次終端操作需要在控制節(jié)點(diǎn)安裝paramiko模塊 pip3installparamiko --break-system-packages# 在【第一個(gè)控制面節(jié)點(diǎn)】上執(zhí)行cd/opt/k8s-deploy-kit ./start-web.sh# 默認(rèn) 0.0.0.0:8777安全提示默認(rèn)監(jiān)聽(tīng)0.0.0.0僅限可信內(nèi)網(wǎng)。公網(wǎng)/多租戶環(huán)境請(qǐng)改用./start-web.sh 8777 127.0.0.1然后本地做 SSH 端口轉(zhuǎn)發(fā)ssh -N -L 8777:127.0.0.1:8777 root目標(biāo)機(jī)IP再訪問(wèn)http://127.0.0.1:8777?？刂婆_(tái)只在「測(cè)試連接 / 分發(fā)密鑰 / 部署」時(shí)用到節(jié)點(diǎn)密碼密碼僅存在于本次請(qǐng)求中不會(huì)寫入任何腳本或落盤文件。第 2 步筆記本瀏覽器打開(kāi)并配參打開(kāi)http://第一個(gè)控制面IP:8777在網(wǎng)頁(yè)里填「集群基礎(chǔ)」Tab集群名、K8s 版本、SSH 用戶默認(rèn)root、SSH 端口、SSH 密碼用于首次免密密鑰分發(fā)?！腹?jié)點(diǎn)規(guī)劃」Tab點(diǎn)「按節(jié)點(diǎn)數(shù)生成」自動(dòng)建表逐行填每臺(tái)機(jī)器的真實(shí) IP / 主機(jī)名 / 角色 / SSH 端口 / 登錄密碼密碼留空則用全局密碼。其它 Tab 按需調(diào)組件版本、CNI、網(wǎng)段、高可用 VIP、鏡像加速、審計(jì)日志等。右側(cè)「生成預(yù)覽」實(shí)時(shí)校驗(yàn)有錯(cuò)誤網(wǎng)段重疊、IPVS 已移除、跨次版本升級(jí)等會(huì)標(biāo)紅需先修正。第 3 步點(diǎn)按鈕全程網(wǎng)頁(yè)驅(qū)動(dòng)網(wǎng)頁(yè)頂部「運(yùn)維操作」工具欄按鈕作用測(cè)試連接用你填的密碼登錄各節(jié)點(diǎn)確認(rèn)可達(dá)分發(fā)密鑰在控制面生成 SSH 密鑰如沒(méi)有寫入各節(jié)點(diǎn)authorized_keys實(shí)現(xiàn)免密 SSH預(yù)檢全部各節(jié)點(diǎn)只讀預(yù)檢系統(tǒng) / 內(nèi)核 / cgroup v2 / 內(nèi)存 / 磁盤 / 缺命令離線清單列出需要提前下載的二進(jìn)制與鏡像 下載地址并檢查服務(wù)器離線目錄里已有哪些、缺哪些內(nèi)網(wǎng)部署用一鍵部署把腳本落盤到/opt/k8s-install→ 分發(fā)密鑰 → 執(zhí)行run-all.sh control-plane自動(dòng)分發(fā)腳本到 worker、遠(yuǎn)程初始化、批準(zhǔn) CSR、驗(yàn)收日志實(shí)時(shí)回傳拉入工作節(jié)點(diǎn)只執(zhí)行run-all.sh workers分發(fā) → 逐節(jié)點(diǎn)初始化 → 批準(zhǔn) CSR → 等待注冊(cè)。比整集群重來(lái)快得多任一節(jié)點(diǎn)失敗會(huì)立刻打印該節(jié)點(diǎn)的現(xiàn)場(chǎng)診斷node-diag一鍵診斷在控制面本機(jī)執(zhí)行diag.sh一次性收集 服務(wù)狀態(tài)/端口/節(jié)點(diǎn)/CSR/kubelet 日志/證書/CNI/鏡像 等排查證據(jù)不依賴 paramikoworker 沒(méi)加入集群kubectl get node只有 master→ 點(diǎn)「拉入工作節(jié)點(diǎn)」重跑它會(huì)明確告訴你每臺(tái)節(jié)點(diǎn)卡在哪containerd 沒(méi)裝上 / 證書沒(méi)分發(fā)到 / 連不上 6443 / CSR 沒(méi)批準(zhǔn)不再只丟一句節(jié)點(diǎn)數(shù)不足。想單獨(dú)看某臺(tái)節(jié)點(diǎn)在控制面執(zhí)行./run-all.sh diag-node 節(jié)點(diǎn)IP。順序建議先「測(cè)試連接」→「分發(fā)密鑰」→「預(yù)檢全部」都通過(guò)后再「一鍵部署」。內(nèi)網(wǎng)環(huán)境可在中間點(diǎn)一次「離線清單」確認(rèn)離線包齊全。部署中或部署后出現(xiàn)異常直接點(diǎn)「一鍵診斷」把輸出發(fā)出來(lái)即可定位問(wèn)題。部署耗時(shí)較長(zhǎng)日志會(huì)持續(xù)滾動(dòng)期間不要關(guān)閉頁(yè)面。就這樣沒(méi)有第 4 步。不需要ssh到服務(wù)器、不需要手改腳本、不需要拷文件。4. 部署前置條件項(xiàng)要求系統(tǒng)Ubuntu 22.04 / RHEL 9必須 cgroup v21.35 起不再支持 cgroup v1運(yùn)行時(shí)containerd2.xK8s 1.35 是最后一個(gè)支持 containerd 1.x 的版本網(wǎng)絡(luò)節(jié)點(diǎn)互通控制面能 SSH密碼或已免密到所有其它節(jié)點(diǎn)資源控制面 ≥ 2C4G工作節(jié)點(diǎn) ≥ 2C2G各 ≥ 40G 磁盤聯(lián)網(wǎng)需拉取二進(jìn)制與鏡像不通外網(wǎng)時(shí)用offline/見(jiàn)下Python目標(biāo)機(jī)有python3paramiko。必須預(yù)先安裝否則「測(cè)試連接/分發(fā)密鑰/一鍵部署」都會(huì)紅安裝 paramiko控制面節(jié)點(diǎn)執(zhí)行# 有外網(wǎng)sudoapt-getupdatesudoapt-getinstall-ypython3-pip pip3installparamiko# 或直接用 apt 包sudoapt-getinstall-ypython3-paramiko# 離線環(huán)境./install-deps.sh裝好后執(zhí)行python3 -c import paramiko; print(paramiko.__version__)確認(rèn)再重新啟動(dòng)./start-web.sh。把控制臺(tái)跑在哪臺(tái)機(jī)器上請(qǐng)跑在「第一個(gè)控制面節(jié)點(diǎn)」上因?yàn)樗诒镜貓?zhí)行run-all.sh并通過(guò) SSH 把腳本與憑據(jù)分發(fā)到其它節(jié)點(diǎn)。5. 離線部署內(nèi)網(wǎng)環(huán)境所有下載都會(huì)優(yōu)先看你配置的離線目錄找到本地文件就不聯(lián)網(wǎng)。默認(rèn)目錄/opt/k8s-offline網(wǎng)頁(yè)「高級(jí) → 離線包目錄」可改。5.1 三步搞定# 1) 在網(wǎng)頁(yè)點(diǎn)「離線清單」按鈕 —— 會(huì)列出需要哪些文件、每臺(tái)的下載地址并檢查服務(wù)器上已有哪些# 2) 在任意有外網(wǎng)的機(jī)器上按清單下載二進(jìn)制跑 offline/pull-images.sh 導(dǎo)出鏡像# 3) 把文件放到控制面節(jié)點(diǎn)的 /opt/k8s-offline再點(diǎn)一次「離線清單」確認(rèn)全綠5.2 目錄結(jié)構(gòu)/opt/k8s-offline/ ├── kubernetes-server-linux-amd64.tar.gz # dl.k8s.io ├── etcd-v3.6.13-linux-amd64.tar.gz # github.com/etcd-io/etcd ├── containerd-2.2.7-linux-amd64.tar.gz # github.com/containerd/containerd ├── runc.amd64 # github.com/opencontainers/runc ├── cni-plugins-linux-amd64-v1.7.1.tgz # github.com/containernetworking/plugins ├── crictl-v1.33.0-linux-amd64.tar.gz # github.com/kubernetes-sigs/cri-tools ├── cfssl_1.6.5_linux_amd64 # github.com/cloudflare/cfssl ├── cfssljson_1.6.5_linux_amd64 # github.com/cloudflare/cfssl ├── calico-v3.32.0.yaml # 可選項(xiàng)目 Calico 清單 └── images/ # 容器鏡像 tar用 ctr images import 導(dǎo)入 ├── pause.tar ├── calico.tar └── coredns.tar文件名必須完全一致腳本按文件名匹配。完整清單與逐條下載地址見(jiàn)生成后的offline/README.md或直接在網(wǎng)頁(yè)點(diǎn)「離線清單」按鈕查看/檢查。5.3 準(zhǔn)備鏡像offline/pull-images.sh會(huì)拉取 pause / Calico / CoreDNS 并導(dǎo)出為 tar# 在有外網(wǎng)、已裝 containerd 或 docker 的機(jī)器上執(zhí)行cd/opt/k8s-install./offline/pull-images.sh# 產(chǎn)物在 offline/images/多節(jié)點(diǎn)不用手動(dòng)拷run-all.sh control-plane里的distribute.sh all會(huì)自動(dòng)把整個(gè)離線目錄同步到所有節(jié)點(diǎn)。5.3.1 鏡像加速地址怎么寫很容易踩的坑網(wǎng)頁(yè)「鏡像與運(yùn)行時(shí) → 鏡像倉(cāng)庫(kù)加速」支持多個(gè)地址必須用半角逗號(hào),或換行分隔https://k8s.1ms.run, https://docker.1ms.run, https://ghcr.1ms.run ? 正確 https://k8s.1ms.runhttps://docker.1ms.runhttps://ghcr.1ms.run ? 全角逗號(hào)用全角逗號(hào)「」時(shí)containerd 會(huì)把整串當(dāng)成一個(gè) host報(bào)failed to resolve reference registry.k8s.io/coredns/coredns:1.12.1: Head https://k8s.1ms.run/%EF%BC%8Chttps://docker.1ms.run/...: dial tcp: lookup k8s.1ms.run: no such host%EF%BC%8C就是全角逗號(hào)的 URL 編碼?，F(xiàn)在的防護(hù)網(wǎng)頁(yè)在你離開(kāi)輸入框時(shí)會(huì)自動(dòng)把全角/、/換成半角生成腳本時(shí)也會(huì)再歸一化一次02-install-containerd.sh寫完配置后會(huì)containerd config dump校驗(yàn)并逐個(gè)體檢每個(gè)鏡像地址DNS HTTPS/v2/打印真正生效的endpoint12/13部署 CNI/CoreDNS 前會(huì)先判斷鏡像能不能拿到本地已有 → 直接用鏡像源可達(dá) → 在線拉否則立刻中止并給出辦法不再空等到超時(shí)./run-all.sh diag第 7 節(jié)匯總生效的鏡像地址、每個(gè)地址的可達(dá)性、組件鏡像地址、本地已有鏡像。如果鏡像源確實(shí)都用不了兩條出路① 把鏡像 tar 放進(jìn)${OFFLINE_DIR}/images/最穩(wěn)② 在網(wǎng)頁(yè)把CoreDNS 鏡像直接改成可達(dá)倉(cāng)庫(kù)的完整地址如registry.aliyuncs.com/...形式。5.4 自檢./run-all.sh offline# 或直接 ./offline-check.sh要求列出的必需文件全部存在run-all.sh control-plane / node / all在部署前也會(huì)自動(dòng)跑一次自檢不齊全就直接中止并提示不會(huì)跑到一半才報(bào)下載失敗。6. 升級(jí)網(wǎng)頁(yè)「升級(jí)」Tab 填目標(biāo)版本 → 生成15-upgrade.sh。行為備份二進(jìn)制與 etcd 快照 → 按 etcd → apiserver → controller-manager → scheduler → kube-proxy → kubelet 順序替換 → 任一組件起不來(lái)自動(dòng)回滾 → 工作節(jié)點(diǎn)默認(rèn) drain/uncordon。支持--dry-run?？绱伟姹旧?jí)會(huì)被校驗(yàn)攔下。升級(jí)也可在網(wǎng)頁(yè)里通過(guò)「一鍵部署」同款通道觸發(fā)或登節(jié)點(diǎn)手動(dòng)跑15-upgrade.sh。7. 維護(hù)這個(gè)工具箱新增 K8s 版本、組件版本、兼容規(guī)則都只改web/assets/js/catalog.jsshell 模板一個(gè)字不用動(dòng)。改完模板務(wù)必跑自檢nodeweb/tools/selftest.js# 5 套場(chǎng)景渲染 bash -n 語(yǔ)法校驗(yàn) 插值殘留掃描nodeweb/tools/smoke.js# 頁(yè)面啟動(dòng)流程冒煙詳細(xì)的版本目錄結(jié)構(gòu)、加新版本的三步操作見(jiàn)web/README.md。8. 三個(gè)必須知道的坑老教程的寫法在 1.36 上已經(jīng)跑不通containerd 必須 2.x—— 配置格式也變了version 3io.containerd.cri.v1.*kube-proxy 的 IPVS 模式已被移除1.35 棄用、1.36 刪除→ 只能用 iptables 或 nftableskubelet 移除了--pod-infra-container-image→ pause 鏡像只能配在 containerd 的pinned_images.sandbox這三條已寫成生成器的硬規(guī)則選錯(cuò)會(huì)在頁(yè)面里直接報(bào)錯(cuò)。