K8S Helm應(yīng)用部署與依賴治理實(shí)戰(zhàn)教程
一、引言
在 Kubernetes 應(yīng)用部署實(shí)踐中，開(kāi)發(fā)者常面臨三大核心挑戰(zhàn)：
1. 環(huán)境配置漂移
開(kāi)發(fā)、測(cè)試、生產(chǎn)環(huán)境需維護(hù)多套高度相似的 Kubernetes 資源聲明文件（YAML）。同步修改時(shí)易出現(xiàn)人工遺漏與配置失準(zhǔn)。
2.版本回退失控
組件升級(jí)后因兼容性問(wèn)題需快速回滾時(shí)，缺乏原子化的版本快照與變更追蹤機(jī)制。
3.依賴治理低效
應(yīng)用依賴的中間件（如 Redis/MySQL）需人工管理啟動(dòng)順序與版本耦合，維護(hù)成本高且易引發(fā)環(huán)境不一致。
Helm作為 Kubernetes 的包管理工具，通過(guò)以下機(jī)制實(shí)現(xiàn)應(yīng)用部署的標(biāo)準(zhǔn)化治理：
• 聲明式模板與參數(shù)解耦
將 Kubernetes 資源抽象為可復(fù)用的 Chart 模板，通過(guò) Values 文件實(shí)現(xiàn)多環(huán)境配置動(dòng)態(tài)注入。
• 版本控制與發(fā)布追蹤
基于 Release 記錄每次部署的全量狀態(tài)，支持原子化回滾至任意歷史版本。
• 依賴聲明與生命周期編排
通過(guò)子 Chart 聲明式定義組件依賴關(guān)系，實(shí)現(xiàn)版本鎖定與啟動(dòng)順序自動(dòng)編排。
二、Helm 的核心機(jī)制解析
2.1 Helm 架構(gòu)與核心要素
Helm 是 Kubernetes 的包管理器，其核心邏輯可以類比為：將一組 Kubernetes 資源模板（Chart）+ 一組參數(shù)配置（Values），組合生成標(biāo)準(zhǔn)的資源清單，然后交由 Kubernetes 創(chuàng)建或更新對(duì)象。
Helm 核心概念
Chart 項(xiàng)目結(jié)構(gòu)
一個(gè)典型的 Chart 項(xiàng)目結(jié)構(gòu)如下：
myapp-chart/ # 主chart，負(fù)責(zé)部署應(yīng)用
├── Chart.yaml # 元數(shù)據(jù)：名稱、版本、依賴聲明
├── values.yaml # 默認(rèn)參數(shù)配置
├── charts/ # 子Chart的存放目錄（用于依賴管理）
└── templates/ # 資源模板目錄
├── deployment.yaml
├── service.yaml
└── _helpers.tpl # 模板輔助函數(shù)Helm 工作流程
1.模板渲染：解析模板文件（Go Template 語(yǔ)法），將 values.yaml中的參數(shù)動(dòng)態(tài)注入，生成標(biāo)準(zhǔn) manifest YAML 文件。
2.依賴處理：讀取 Chart.yaml中的依賴配置，遞歸拉取子 Chart，構(gòu)建完整依賴樹(shù)。
3.資源部署：通過(guò) Kubernetes API 與集群通信，創(chuàng)建或更新資源，并記錄為一個(gè)新的 Release。
每一次 install或 upgrade操作，都會(huì)生成一條 Release 記錄，支持隨時(shí)回滾。
2.2 Helm 的標(biāo)準(zhǔn)化設(shè)計(jì)范式
1.模板抽象機(jī)制
Helm 使用 Go Template 模板語(yǔ)法將參數(shù)與資源分離，實(shí)現(xiàn)資源模板的復(fù)用和定制。
(1) 動(dòng)態(tài)變量注入
通過(guò) .Values.xxx引用配置項(xiàng)：
# templates/deployment.yaml
spec:
replicas: {{ .Values.replicaCount }}
image: {{ .Values.image.repository }}:{{ .Values.image.tag }}(2) 條件渲染控制
支持按條件渲染資源（如是否啟用 Ingress）：
{{- if .Values.ingress.enabled }}
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: {{ .Chart.Name }}
{{- end }}2.多環(huán)境配置策略
為了適配開(kāi)發(fā)、測(cè)試、生產(chǎn)等不同環(huán)境，Helm 支持靈活的參數(shù)覆蓋機(jī)制。
(1) 配置文件疊加
可以使用多個(gè) -f參數(shù)指定多個(gè)配置文件，實(shí)現(xiàn)層級(jí)覆蓋：
helm install myapp ./chart \ -f values-base.yaml \ -f values-prod.yaml
例如，values-base.yaml設(shè)置通用配置，values-prod.yaml只需覆蓋部分生產(chǎn)環(huán)境特有參數(shù)。
最終生效的配置 = values-base.yaml被values-prod.yaml覆蓋后的結(jié)果。
(2) 參數(shù)優(yōu)先級(jí)規(guī)則
Helm 的參數(shù)解析優(yōu)先級(jí)如下（從高到低）：
命令行 --set > 指定的 values 文件 > 默認(rèn) values.yaml
可臨時(shí)通過(guò)命令行 --set key=value快速覆蓋任何配置項(xiàng)，適用于調(diào)試或自動(dòng)化腳本場(chǎng)景。
3.Chart 版本管理體系
(1) Chart 版本號(hào)（version）
用于控制模板自身的版本，遵循語(yǔ)義化版本規(guī)范（SemVer）：
# Chart.yaml version: 2.1.5 # 模板版本（每次結(jié)構(gòu)變更需更新） appVersion: "3.8.0" # 被部署應(yīng)用的版本（非必需同步）
(2) Release 回滾機(jī)制
每次部署會(huì)生成新的 Release，可通過(guò)命令回退到任意版本：
helm history myapp -n prod # 查看歷史記錄 helm rollback myapp 2 # 回滾到第 2 個(gè)版本
2.3 依賴治理機(jī)制解析
在實(shí)際項(xiàng)目中，很多應(yīng)用依賴數(shù)據(jù)庫(kù)、緩存等第三方組件。Helm 提供了完整的依賴管理方案。
1.子 Chart 管理
(1) 依賴聲明
在主 Chart 的 Chart.yaml中聲明依賴：
# Chart.yaml
dependencies:
- name: mysql
version: "9.8.0"
repository: "https://charts.bitnami.com/bitnami"
condition: mysql.enabled # 可通過(guò)配置控制啟動(dòng)(2) 下載依賴
使用如下命令更新并下載 mysql 子 Chart 到 charts/目錄下：
helm dependency update ./chart
2.版本約束策略
3.命名沖突與依賴隔離
如果多個(gè)子 Chart 使用了相同的名稱，可以使用 alias重命名避免沖突：
dependencies:
- name: postgresql
alias: user-db
version: "11.6.12"此時(shí)在模板中可通過(guò) .Values.user-db引用該組件的參數(shù)配置。
三 、Helm 多環(huán)境部署管理實(shí)戰(zhàn)
3.1 環(huán)境準(zhǔn)備
1.安裝必要工具
Mac/Linux 用戶
# 安裝 Docker 并啟動(dòng)服務(wù)（容器運(yùn)行時(shí)基礎(chǔ)） brew install --cask docker open /Applications/Docker.app # macOS 需手動(dòng)啟動(dòng) Docker Desktop # 安裝 Kubernetes 工具鏈（僅 Helm 相關(guān)） brew install kubectl kind helm # 驗(yàn)證核心工具版本 echo "?? 關(guān)鍵工具版本：" docker --version # 預(yù)期輸出: Docker version 24.x+ kubectl version --client # 預(yù)期輸出: Client Version: v1.28.x helm version --short # 預(yù)期輸出: v3.12.x
2.創(chuàng)建本地 Kubernetes 集群
# 使用 Kind 快速創(chuàng)建單節(jié)點(diǎn)集群（輕量級(jí)） kind create cluster --name helm-lab --image=kindest/node:v1.28.0 # 驗(yàn)證集群基礎(chǔ)狀態(tài) kubectl cluster-info
3.配置實(shí)驗(yàn)命名空間
# 創(chuàng)建隔離環(huán)境（避免污染 default 命名空間） kubectl create ns helm-demo # 設(shè)置默認(rèn)操作空間（后續(xù)命令自動(dòng)作用于此空間） kubectl config set-context --current --namespace=helm-demo
4.一鍵環(huán)境驗(yàn)證
echo " 環(huán)境健康檢查：" kubectl get nodes # 預(yù)期輸出 STATUS=Ready helm list -A # 確認(rèn)無(wú)殘留 Helm Release docker ps # 查看 Kind 容器是否運(yùn)行
關(guān)鍵工具說(shuō)明
3.2 場(chǎng)景與目標(biāo)
使用 Helm 實(shí)現(xiàn)典型微服務(wù)系統(tǒng)的多環(huán)境部署。該系統(tǒng)包含以下服務(wù)及其依賴：
• frontend：前端服務(wù)，負(fù)責(zé)與用戶交互，獨(dú)立部署
• backend：后端服務(wù)，負(fù)責(zé)處理業(yè)務(wù)邏輯，依賴 Redis 緩存
• Redis：緩存服務(wù)，作為子 Chart 引入
通過(guò) Helm 實(shí)現(xiàn)以下目標(biāo)：
• 配置標(biāo)準(zhǔn)化：通過(guò)父 Chart 統(tǒng)一管理 frontend和 backend的部署模板
• 環(huán)境隔離：使用 values-dev.yaml和 values-prod.yaml管理環(huán)境差異
• 依賴治理：通過(guò)子 Chart 管理 Redis 依賴
• 版本控制：支持 Helm 版本回滾
3.3 項(xiàng)目目錄結(jié)構(gòu)
如下為典型 Helm 多環(huán)境部署結(jié)構(gòu)圖
myapp/
├── Chart.yaml # 父 Chart 元數(shù)據(jù)
├── values.yaml # 全局默認(rèn)配置
├── values-dev.yaml # 開(kāi)發(fā)環(huán)境覆蓋配置
├── values-prod.yaml # 生產(chǎn)環(huán)境覆蓋配置
├── charts/ # 子 Chart 目錄（存放 Redis 依賴）
└── templates/ # 核心模板
├── frontend.yaml # 前端服務(wù)模板
├── backend.yaml # 后端服務(wù)模板
└── _helpers.tpl # 模板函數(shù)庫(kù)主要文件說(shuō)明：
• Chart.yaml：Helm Chart 元數(shù)據(jù)，定義應(yīng)用的基本信息。
• values.yaml：通用配置文件，提供默認(rèn)值。
• values-dev.yaml：開(kāi)發(fā)環(huán)境配置，覆蓋默認(rèn)值。
• values-prod.yaml：生產(chǎn)環(huán)境配置，覆蓋默認(rèn)值。
• charts/：存放子 Chart（如 Redis）的目錄。
• templates/：存放 Kubernetes 資源模板，定義具體的服務(wù)部署配置。
3.4 實(shí)戰(zhàn)步驟
步驟 1：創(chuàng)建 Helm Chart
# 初始化 Chart 結(jié)構(gòu) helm create myapp rm -rf myapp/templates/* # 清空默認(rèn)模板（從頭開(kāi)始）
步驟 2：定義 Chart 元數(shù)據(jù)
# myapp/Chart.yaml
apiVersion: v2 # Helm Chart API 版本（v2 是當(dāng)前穩(wěn)定版）
name: myapp # Chart 名稱（必須全小寫(xiě)，無(wú)空格）
description: 多環(huán)境Web應(yīng)用示例
version: 1.0.0 # Chart 版本（必須遵循 SemVer 規(guī)范）
appVersion: "1.0" # 應(yīng)用本身的版本（字符串類型）
# 定義依賴組件（可包含多個(gè)子Chart）
dependencies:
- name: redis # 官方Redis Chart名稱
version: "17.0.0" # 嚴(yán)格指定版本號(hào)（避免版本漂移）
repository: "https://charts.bitnami.com/bitnami" # 官方倉(cāng)庫(kù)地址
condition: redis.enabled # 是否啟用此依賴（由values.yaml中的redis.enabled控制）
依賴操作演示
# 執(zhí)行后會(huì)在 charts/ 目錄生成 redis-17.0.0.tgz
helm dependency update myapp
# 查看目錄結(jié)構(gòu)
tree myapp/charts/
myapp/charts/
└── redis-17.0.0.tgz # 下載的依賴包（二進(jìn)制格式）步驟 3：編寫(xiě)模板文件
前端服務(wù)模板
# myapp/templates/frontend.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: {{ .Chart.Name }}-frontend
labels:
app: frontend
spec:
replicas: {{ .Values.frontend.replicas }}
selector:
matchLabels:
app: frontend
template:
metadata:
labels:
app: frontend
spec:
containers:
- name: frontend
image: "{{ .Values.frontend.image.repository }}:{{ .Values.frontend.image.tag }}"
ports:
- containerPort: 80
env:
- name: REDIS_HOST
value: {{ .Chart.Name }}-redis-master # 引用 Redis 服務(wù)名稱
---
apiVersion: v1
kind: Service
metadata:
name: {{ .Chart.Name }}-frontend
spec:
type: {{ .Values.frontend.service.type }}
ports:
- port: 80
targetPort: 80
selector:
app: frontend后端服務(wù)模板
# myapp/templates/backend.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: {{ .Chart.Name }}-backend
spec:
replicas: {{ .Values.backend.replicas }}
strategy:
rollingUpdate:
maxSurge: 1
maxUnavailable: 0
template:
spec:
containers:
- name: backend
image: "{{ .Values.backend.image }}"
resources:
requests:
cpu: {{ .Values.backend.resources.requests.cpu }}
---
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
name: {{ .Chart.Name }}-backend-hpa
spec:
scaleTargetRef:
apiVersion: apps/v1
kind: Deployment
name: {{ .Chart.Name }}-backend
minReplicas: {{ .Values.backend.hpa.minReplicas }}
maxReplicas: {{ .Values.backend.hpa.maxReplicas }}
metrics:
- type: Resource
resource:
name: cpu
target:
type: Utilization
averageUtilization: {{ .Values.backend.hpa.cpuUtilization }}步驟 4：配置參數(shù)文件
默認(rèn)參數(shù)
# myapp/values.yaml
frontend:
replicas: 2
image:
repository: nginx
tag: stable
service:
type: ClusterIP
backend:
image: myapp/backend:v1
replicas: 3
resources:
requests:
cpu: 100m
hpa:
minReplicas: 2
maxReplicas: 5
cpuUtilization: 50
redis:
enabled: true開(kāi)發(fā)環(huán)境覆蓋
# myapp/values-dev.yaml
frontend:
replicas: 1
service:
type: NodePort # 開(kāi)發(fā)環(huán)境暴露 NodePort
backend:
hpa:
cpuUtilization: 80 # 開(kāi)發(fā)環(huán)境提高擴(kuò)縮容閾值
生產(chǎn)環(huán)境覆蓋
# myapp/values-prod.yaml
frontend:
replicas: 3
image:
tag: latest # 生產(chǎn)使用最新鏡像
backend:
replicas: 5
resources:
requests:
cpu: 500m # 生產(chǎn)環(huán)境增加資源步驟 5：安裝部署開(kāi)發(fā)環(huán)境
helm install myapp ./myapp -n helm-demo \ -f myapp/values.yaml \ -f myapp/values-dev.yaml \ --set backend.image=myapp/backend:dev-latest # 命令行覆蓋鏡像標(biāo)簽
步驟 6：驗(yàn)證部署
1.驗(yàn)證 Helm Release 狀態(tài)
helm list -n helm-demo NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION myapp helm-demo 1 2023-08-20 14:30:15.123456 +0800 CST deployed myapp-1.0.0 1.0
關(guān)鍵點(diǎn)驗(yàn)證
• STATUS = deployed：Release 成功部署
• CHART = myapp-1.0.0：Chart 版本與定義一致
2.驗(yàn)證 Kubernetes 資源生成
kubectl get all -n helm-demo NAME READY STATUS RESTARTS AGE pod/myapp-frontend-7c5d8f8bdf 1/1 Running 0 2m pod/myapp-backend-5d7d6c8b5f 1/1 Running 0 2m NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/myapp-frontend ClusterIP 10.96.123.45 <none> 80/TCP 2m NAME READY UP-TO-DATE AVAILABLE AGE deployment.apps/frontend 1/1 1 1 2m deployment.apps/backend 1/1 1 1 2m NAME REFERENCE TARGETS MINPODS MAXPODS REPLICAS AGE horizontalpodautoscaler.autoscaling/myapp-backend-hpa Deployment/backend 0%/50% 2 5 1 2m
關(guān)鍵點(diǎn)驗(yàn)證
• Pod：所有應(yīng)用容器處于 Running 狀態(tài)
• Service：前端服務(wù)類型為 NodePort（來(lái)自 values-dev.yaml覆蓋）。
• HPA：CPU 利用率閾值為 80%（來(lái)自dev 覆蓋）。
3.驗(yàn)證參數(shù)注入效果
檢查前端副本數(shù)（來(lái)自 values-dev.yaml覆蓋）
kubectl get deployment myapp-frontend -n helm-demo -o=jsonpath='{.spec.replicas}'
1 # 開(kāi)發(fā)環(huán)境覆蓋為 1 個(gè)副本（默認(rèn)為 2）
檢查后端鏡像標(biāo)簽（命令行動(dòng)態(tài)覆蓋）
kubectl get deployment myapp-backend -n helm-demo -o=jsonpath='{.spec.template.spec.containers[0].image}'
myapp/backend:dev-latest # 來(lái)自 --set 參數(shù)覆蓋4.驗(yàn)證依賴管理（子 Chart 狀態(tài)）
檢查 Redis 子 Chart 啟用情況 helm get values myapp -n helm-demo | grep redis.enabled redis.enabled: true 查看 Redis 服務(wù)狀態(tài) kubectl get svc -n helm-demo | grep redis myapp-redis-master ClusterIP 10.96.234.56 <none> 6379/TCP 2m
關(guān)鍵點(diǎn)驗(yàn)證
• Redis 服務(wù)名稱包含 myapp前綴（Chart 名稱隔離）
• 端口 6379正常開(kāi)放（來(lái)自子 Chart 默認(rèn)配置）
至此，我們已通過(guò) Helm 實(shí)現(xiàn)了一個(gè)典型微服務(wù)系統(tǒng)的多環(huán)境部署流程。
注：_helpers.tpl 函數(shù)模版庫(kù) 將在下篇講解。
3.5 Helm 實(shí)踐小結(jié)
關(guān)鍵經(jīng)驗(yàn)：
• 配置隔離：使用 values-dev.yaml/ values-prod.yaml實(shí)現(xiàn)環(huán)境差異。
• 依賴管理：子 Chart 引入 Redis，實(shí)現(xiàn)服務(wù)與數(shù)據(jù)庫(kù)的一體化部署。
• 模板復(fù)用：借助 _helpers.tpl統(tǒng)一標(biāo)簽與命名，提升可維護(hù)性。
• 版本控制：每次部署生成獨(dú)立 Release，可回滾、追蹤，保障發(fā)布安全。
注意事項(xiàng)：
• 避免配置文件冗余，保持差異項(xiàng)聚焦。
• 固定依賴版本，防止不兼容風(fēng)險(xiǎn)。
• 使用 --namespace保持資源隔離。
• 配置文件建議納入 Git，支持多人協(xié)作與變更追蹤。
四、總結(jié)
4.1 核心重點(diǎn)
Helm 在 Kubernetes 應(yīng)用管理中的價(jià)值：
• 標(biāo)準(zhǔn)化封裝：通過(guò) Chart 實(shí)現(xiàn)跨環(huán)境部署的統(tǒng)一打包。
• 靈活配置管理：支持多套 Values 實(shí)現(xiàn)環(huán)境差異與個(gè)性化控制。
• 依賴與復(fù)用機(jī)制：通過(guò)子 Chart 管理依賴組件，提升集成效率。
• 版本控制體系：支持版本回滾、差異對(duì)比與發(fā)布?xì)v史追蹤，增強(qiáng)發(fā)布安全性。
到此這篇關(guān)于K8S Helm 入門與實(shí)戰(zhàn) - 應(yīng)用部署與依賴治理的文章就介紹到這了,更多相關(guān)K8S Helm應(yīng)用部署內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
文章介紹了Kubernetes中親和力和反親和力的調(diào)度策略,包括節(jié)點(diǎn)和Pod的硬性、軟性規(guī)則,用于實(shí)現(xiàn)Pod與節(jié)點(diǎn)的標(biāo)簽匹配、區(qū)域均衡負(fù)載及避免單節(jié)點(diǎn)過(guò)載等場(chǎng)景,強(qiáng)調(diào)標(biāo)簽匹配和副本數(shù)限制對(duì)調(diào)度結(jié)果的影響2025-08-08
這篇文章主要介紹了k8s常用命令大全,本文給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2023-03-03
k8s更新迭代比較快，apiVersion也在不斷變化中，每個(gè)版本的對(duì)應(yīng)的apiVersion略有不同，這篇文章主要介紹了K8S apiVersion對(duì)照表,需要的朋友可以參考下2022-07-07
Kubernetes存儲(chǔ)系統(tǒng)數(shù)據(jù)持久化管理詳解
這篇文章主要為大家介紹了Kubernetes存儲(chǔ)系統(tǒng)數(shù)據(jù)持久化管理詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-11-11
K8S部署Kafka界面管理工具(kafkamanager)方法詳解
這篇文章主要介紹了K8S部署Kafka界面管理工具(kafkamanager)方法詳解,需要的朋友可以參考下2022-01-01
這篇文章主要介紹了K8S集群需要開(kāi)放的端口說(shuō)明,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2025-05-05
二進(jìn)制方式安裝?Kubernetes1.18.3版本實(shí)現(xiàn)腳本
這篇文章主要為大家介紹了二進(jìn)制方式安裝Kubernetes1.18.3版本實(shí)現(xiàn)腳本，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-03-03
k8s部署問(wèn)題解決方案(節(jié)點(diǎn)狀態(tài)為 NotReady)
kubectl get nodes顯示節(jié)點(diǎn)NotReady,因kube-flannel鏡像拉取失敗,手動(dòng)拉取鏡像并修改名稱版本后,K8s自動(dòng)重試,最終恢復(fù)節(jié)點(diǎn)狀態(tài)為Ready,相關(guān)Pod也變?yōu)镽unning2025-07-07
Rainbond上部署API?Gateway?Kong及環(huán)境配置教程
這篇文章主要為大家介紹了Rainbond上部署API?Gateway?Kong及環(huán)境配置教程，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-04-04
云服務(wù)器Jenkins部署Springboot項(xiàng)目及Vue項(xiàng)目的詳細(xì)過(guò)程
本文詳細(xì)介紹了如何在云服務(wù)器上使用Jenkins部署Springboot和Vue項(xiàng)目,包括創(chuàng)建Springboot項(xiàng)目并上傳到Git倉(cāng)庫(kù)、安裝Maven和配置Maven插件、安裝Gitee插件、配置Jenkins任務(wù)以及創(chuàng)建自由風(fēng)格項(xiàng)目等步驟,感興趣的朋友一起看看吧2025-02-02