K8s安装及使用Helm管理工具全过程

# 解压二进制安装包
tar xf helm-v3.8.0-linux-amd64.tar.gz

# 复制 helm 二进制文件 到bin目录下
cp -ar linux-amd64/helm /usr/local/bin/

# 验证安装，确认版本号
helm version

curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

helm version

# 临时启用
source <(helm completion bash)

# 永久启用
echo 'source  <(helm completion bash)' >> ~/.bashrc

# 1. 添加常用公开仓库
helm repo add bitnami https://charts.bitnami.com/bitnami  # 常用应用仓库
helm repo add stable http://mirror.azure.cn/kubernetes/charts  # 稳定版仓库
helm repo add aliyun https://kubernetes.oss-cn-hangzhou.aliyuncs.com/charts  # 阿里云仓库
helm repo add incubator https://charts.helm.sh/incubator  # 孵化版仓库
 
# 2. 更新仓库索引（获取最新 Chart 列表）
helm repo update
# 3. 查看已添加仓库
helm repo list
# 4. 删除无用仓库（如删除 incubator）
helm repo remove incubator
# 5. 搜索仓库中可安装的 Chart 【即软件包】列表（如搜索 stable 仓库的 Chart）
helm search repo stable
# 6. 在所有仓库中搜索 nginx 相关Chart
helm search repo nginx

helm [命令] [参数] [标志]

# 添加仓库
helm repo add [名称] [URL]
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo add stable https://charts.helm.sh/stable --force-update

# 参数说明：
# --force-update    : 强制更新已存在的仓库
# --username        : 私有仓库用户名
# --password        : 私有仓库密码
# --ca-file         : CA 证书文件
# --cert-file       : 证书文件
# --key-file        : 密钥文件

# 更新已添加所有仓库索引
helm repo update
# --fail-on-repo-not-found : 仓库不存在时报错

# 列出所有已添加的仓库
helm repo list
# -o, --output : 输出格式 (table|json|yaml)

# 删除仓库
helm repo remove [名称]

# 列出指定仓库下所有 charts
helm search repo [仓库名称]
# 在所有仓库中搜索匹配的 charts
helm search repo [软件名称]
# 指定仓库中搜索匹配的 charts
helm search repo [仓库名称/软件名称]
# 如下参数上面三条命令通用
# --versions       : 显示所有版本
helm search repo [仓库名称/软件名称] --versions
# --version        : 指定版本号或版本范围（范围必须配合--versions使用）
helm search repo [仓库名称/软件名称] --version [chart的版本号]
helm search repo [仓库名称/软件名称] --version [>=chart的版本号范围]
# -l, --devel      : 包含开发版本
helm search repo [仓库名称/软件名称] -l 
# --max-col-width  : 最大列宽
helm search repo [仓库名称/软件名称] --max-col-width 100

# 搜索中心仓库
helm search hub [软件名称]
## 搜索中心仓库中的nginx，并显示列宽为50
helm search hub nginx --max-col-width 50

# 搜索已添加的仓库
helm search repo [软件名称]|[仓库名称/软件名称]
# 示例
## 搜索bitnami仓库中所有的nginx包，并显示所有版本号
helm search repo bitnami/nginx --versions
## 搜索bitnami仓库中的nginx包，并指定版本号（chart版本号）
helm search repo bitnami/nginx --version "14.2.2"
## 搜索bitnami仓库中的nginx包，并指定版本范围（chart版本号）范围必须带--versions；
helm search repo bitnami/nginx --versions --version ">=14.0.0"
## 搜索bitnami仓库中所有的nginx包，并显示所有版本号，包含开发版本
helm search repo bitnami/nginx -l
## 搜索bitnami仓库中最新的nginx包并展示为100的列宽
helm search repo bitnami/nginx --max-col-width 100

# 参数详解：
# --versions       : 显示所有版本号
# --version        : 版本匹配（支持范围：>=1.2.3，必须配合--versions使用）
# --max-col-width  : 所搜结果展示的列宽
# -l, --devel      : 包含预发布版本（alpha, beta）
# -r, --regexp     : 使用正则表达式匹配
# --failed-parses  : 显示解析失败的条目

helm pull [Repository/chart] [参数]
helm pull [仓库名称/软件名称] [参数]

# 下载最新版本nginx chart
helm pull bitnami/nginx
# 下载指定版本的nginx并解压；（不会下载tar包，会直接解压）
# 14.2.2为chart的版本号，需要先search进行查询需要的nginx版本号所对应的chart版本号
helm pull bitnami/nginx --version 14.2.2 --untar
# 下载指定版本的nginx并解压到指定目录；（不会下载tar包，会直接解压）
helm pull bitnami/nginx --version 14.2.2 --untar --untardir /data/helm/
# 指定仓库下载nginx指定版本
helm pull nginx --repo https://charts.bitnami.com/bitnami --version 14.2.2

# 参数：
--version        # 指定版本
--untar          # 下载后解压
--untardir       # 解压目标目录（默认当前目录）
--repo           # 指定下载仓库地址
--verify         # 验证签名
--prov           # 获取 provenance 文件

helm install [Release] [Repository/chart] [参数]
helm install [实例名称] [仓库名称/软件名称] [参数]

# 从仓库中安装
## 在bitnami仓库中查找nginx服务包并安装，实例名称命名为：my-nginx
## Helm会去 ~/.config/helm/repositories.yaml 找到bitnami对应的URL，然后下载nginx
helm install my-nginx bitnami/nginx
helm install my-nginx bitnami/nginx --version=14.2.2

# 从本地安装（需要先使用pull下载到本地/解压）
## 安装本地下载的nginx chart压缩包,实例名称为：my-nginx-local-tar
## 常用于：分发、离线安装、从别人那里获取的Chart包
helm install my-nginx-local-tar ./nginx-14.2.2.tgz
## 安装本地下载解压的nginx chart，实例名称命名为：my-nginx-local
## 常用于：开发调试、离线安装、自定义修改后的Chart
helm install my-nginx-local ./nginx

# 从URL安装（需直接指定tgz压缩包文件）
## 自定义写的chart，比如上传到github或者是oss里，然后通过这个连接去进行下载
## Helm会先下载这个文件，然后再安装
helm install my-nginx-url https://charts.bitnami.com/bitnami/nginx-14.2.2.tgz

# --set             : 设置值（支持多个）	
## 设置单个值：在安装的时候修改副本数
helm install my-nginx-set-1 ./nginx --set replicaCount=3
## 设置多个值：在安装的时候修改镜像仓库地址、镜像名称、镜像tag、探针检测端口
helm install my-nginx-set-2 ./nginx --set image.registry="" --set image.repository=nginx --set image.tag=1.25.0 --set containerPorts.http=80
## 修改创建完可使用：kubectl get pods -o wide 进行查看是否更改成功；
## 不需要看helm创建成功之后输出的提示，没有waring就不需要看，因为他读取的还是chart的元数据，所以使用set修改，显示的一直是元数据；

# --namespace (-n)  : 指定命名空间
# --create-namespace : 自动创建命名空间
## helm list查看的时候也需要使用-n指定命名空间或直接-A查看全部实例
helm install my-nginx-ns ./nginx -n my-nginx --create-namespace 

# --values (-f)     : 指定 values 文件（支持多个）
## 指定多个 values 文件，不会冲突，它们会按照顺序合并（后面的覆盖前面的）。
helm install my-app ./chart -f values-prod.yaml -f extra-values.yaml

# --set-string      : 强制设为字符串
helm install my-app ./chart --set-string env=production

# --set-file        : 从文件读取值
helm install my-app ./chart --set-file config=./config.yaml

# --set-json        : 使用 JSON 格式设置值
helm install my-app ./chart --set-json 'labels={"env":"prod"}' 

# --dry-run         : 模拟安装，不实际执行
# --debug           : 显示详细调试信息
helm install my-nginx-moni ./nginx --dry-run --debug

# --timeout         : 超时时间（默认 5m），一般组合使用
helm install my-nginx-timeout ./nginx --timeout 10m

# --wait            : 等待所有资源就绪
helm install my-nginx-wait ./nginx --wait --timeout 5m

# --atomic          : 安装失败时自动回滚
## 安装失败时进行回滚，成功则结束
helm install my-nginx-atomic ./nginx --set image.tag=1.25.0 --atomic
## 安装超过1分钟没有完成算是失败，进行回滚；
helm install my-nginx-atomic ./nginx --set image.tag=1.25.0 --timeout 1m --atomic

# --verify          : 验证包签名
helm install my-app ./chart --verify

# --no-hooks        : 跳过 hooks 执行
# 作用是不执行 Chart 中定义的 hooks（如 pre-install、post-install）
helm install my-app ./chart --no-hooks

# --replace         : 重新创建已删除的 release
helm install my-nginx-wait ./nginx --replace

# --disable-openapi-validation : 禁用 OpenAPI 验证
# 作用是跳过 Kubernetes API 的 OpenAPI 验证
# 适用于使用自定义 CRD、测试未正式发布的 API
helm install my-app ./chart --disable-openapi-validation

helm history [Release名称] [参数]

# 查看名为：my-nginx-set-1 的安装、更新历史记录
helm history my-nginx-set-1

# 参数：
# --max            : 最大显示行数
helm history my-nginx-set-1 --max 10

# -o, --output     : 输出格式
helm history my-nginx-set-1 -o json

helm upgrade [Release名称] [Chart] [标志]

# --set             : 设置值（支持多个）	
## 更新名为 my-nginx-set-1 的副本数，改成2个
helm upgrade my-nginx-set-1 ./nginx --set replicaCount=2

# --install (-i)    : 如果 release 不存在则安装
helm upgrade my-nginx-install-set ./nginx -i --set replicaCount=2

# --history-max     : 保存的最大历史版本数（默认10条）
helm upgrade my-nginx-install-set ./nginx --history-max 10

# --cleanup-on-fail : 更新失败后清理新创建资源（但不会回退）
helm upgrade my-nginx-install-set ./nginx --set image.tag=test --cleanup-on-fail

# --force           : 强制更新即使有冲突
# --reset-values    : 重置为 Chart 默认 values
# --reuse-values    : 复用上一版本的 values

# 其他同 install 的参数：
# --set, -f, --dry-run, --wait, --timeout, --atomic, --debug

helm rollback [Release名称] [history查看的版本号] [参数]

# 回滚到上一版本
helm rollback my-nginx-set
# 回滚 my-nginx-set 到版本 1
helm rollback my-nginx-set 1

# 参数：
# --wait            : 等待资源就绪
helm rollback my-app 2 --wait --timeout 5m

# 其他参数使用和install、upgrade相同
# --cleanup-on-fail : 失败时清理
# --force           : 强制回滚
# --recreate-pods   : 重建 Pods
# --no-hooks        : 跳过 hooks
# --dry-run         : 模拟回滚

helm uninstall [Release名称] [参数]

# 卸载一个Release
helm uninstall my-nginx-install-set-2
# 卸载多个Release
helm uninstall my-nginx-install-set-2 my-nginx-set-1

# --keep-history    : 保留历史记录
## 不会真正的删除，历史记录和Release还是会保留的，直接helm list也是看不到的，可以通过helm list --uninstalled看到
## 如何恢复？可以先使用history查看要恢复的版本，然后在使用rollback回退
helm uninstall my-nginx-set --keep-history

# --dry-run         : 模拟卸载
# --no-hooks        : 跳过 hooks

helm list [参数]

# ========== 范围筛选 ==========
# --all (-a)        : 显示所有 release（包括已卸载 [保留历史记录的]）
# 只能查看当前默认命名空间的所有release（包括已卸载 [保留历史记录的]）
helm list --all
helm list -a
# --all-namespaces (-A)：显示所有命名空间的 release
helm list -A
## 查看所有命名空间及已卸载[保留历史记录的]的所有release
helm list -aA
# --namespace (-n)  : 指定命名空间
helm list -n my-nginx


# ========== 状态筛选 ==========
# --deployed        : 仅显示已部署的（默认）
helm list -A --deployed
# --failed          : 仅显示失败的
helm list -A --failed
# --pending         : 仅显示等待中的
helm list -A --pending
# --uninstalled     : 仅显示已卸载的（保留历史记录的）
helm list -A --uninstalled
# --superseded      : 仅显示已被替代的
helm list -A --superseded


# ========== 输出控制 ==========
# --max (-m)        : 限制返回数量（默认 256）
## 查看所有release包括已卸载[保留历史记录的]的并返回2条数据
helm list -A --max 2
# --offset          : 分页偏移量（配合 --max 使用）
helm list -A --max 10 --offset 20

# -q, --short       : 只显示名称
helm list -Aq

# -o, --output      : 输出格式 (table|json|yaml)
helm list -Ao json


# ========== 排序筛选 ==========
# -d, --date        : 按日期排序
helm list -Ad
# -r, --reverse     : 反向排序
helm list -Ar


# ========== 高级筛选 ==========
# --filter (-f)     : 正则表达式过滤
helm list -Af "my-nginx*"

# --selector (-l)   : 标签选择器
## 筛选带有 app=nginx 标签的 Release
helm list -aAl "app=nginx"

helm status [Release名称] [参数]

# 查看 my-nginx-set 的状态
helm status my-nginx-set

# --revision        : 查看特定版本
helm status my-nginx-set --revision 3

# --show-resources  : 显示资源清单
helm status my-nginx-set --show-resources

# -o, --output      : 输出格式 (table|json|yaml)
helm status my-nginx-set -o json

helm get [子命令] [Release名称] [参数]

# get all          : 获取所有信息
# 一次性获取 Release 的所有信息
helm get all my-nginx-install-set

# get hooks        : 获取 hooks
# 查看 Release 定义的 hooks（在特定时间点执行的任务，如数据库迁移）
helm get hooks my-nginx-install-set

# get manifest     : 获取生成的 K8s 资源 YAML
# 查看 Helm 根据 Chart 模板和 values 生成的最终 Kubernetes YAML 文件
helm get manifest my-nginx-install-set

# get notes        : 获取安装说明
# 获取 Chart 作者写的使用说明（就是 helm install 成功后显示的那段话）
helm get notes my-nginx-install-set

# get values       : 获取 values 配置
helm get values my-nginx-install-set

# --revision (-r)   : 指定版本号
helm get manifest my-nginx-install-set --revision 2

# --all (-a)        : 显示所有 values（包括默认值）  - 仅对 get values 有效
helm get values my-nginx-install-set --all
# --output (-o)     : 输出格式 (table|json|yaml)
helm get values my-nginx-install-set --all -o yaml

helm test [Release名称] [参数]

helm test my-nginx-install-set
helm test my-nginx-install-set --logs --timeout 5m

# 参数：
--logs        # 显示测试 Pod 日志
--timeout     # 超时时间

# 命令
helm create [路径/chart名称] [参数]

# 示例
## 创建一个名为test的chart，默认模板为nginx
helm create test
## 创建一个名为test2的chart，模板使用wordpress（需本地存在此模板）
helm create ./test2 --starter wordpress

# 参数：
--starter string   # 使用指定的 starter 模板
# 前提是本地的starters里必须存在这个模板
# 此参数的逻辑是：让 Helm 复制一个预先定义好的、名为 wordpress 的 Starter 模板，来生成新的 Chart 
# 如图这个模板不存在就会报错：Error: could not load /root/.local/share/helm/starters/wordpress: stat /root/.local/share/helm/starters/wordpress: no such file or directory

helm dependency [子命令] [路径/chart名称] [参数]

# 添加依赖到Chart.yaml中，根据 Chart.yaml 中的声明，下载或更新依赖到 charts/ 目录 
helm dependency update./test
# 列出刚刚添加的依赖，依赖的路径一般是再chart/charts里
helm dependency list ./test

# build 与 update 的区别：
# - update：根据 Chart.yaml 拉取最新兼容版本，并更新 Chart.lock 文件
# - build：严格根据 Chart.lock 锁定的版本进行重建，用于确保环境一致性
# 日常开发使用 update 即可，build 通常在 CI/CD 流水线中使用

helm template [Release名称] [Chart路径或名称] [参数]

# 基础用法：渲染本地 Chart
helm template my-app ./test

# 渲染时覆盖 values 配置（不会真正修改）
helm template my-app ./test --set replicaCount=3

# 使用自定义 values 文件
helm template my-app ./test -f my-values.yaml

# 只渲染特定资源（如只输出 Deployment）
helm template my-app ./test --show-only templates/deployment.yaml

# 调试模式：显示所有信息，包括渲染的变量
helm template my-app ./test --debug

# 从远程仓库渲染（需先添加仓库）
helm template my-app bitnami/nginx --set replicaCount=2

helm lint [Chart路径或名称] [参数]

# 参数：
--strict      # 严格模式，警告也当作错误
--values      # 指定 values 文件验证


# 示例
helm lint ./test
helm lint ./test --strict --values prod.yaml

helm verify [CHART路径] [参数]

# 验证一个本地 Chart 包
helm verify test-0.1.0.tgz

# 指定公钥环（keyring）进行验证
helm verify test-0.1.0.tgz --keyring ~/.gnupg/pubring.gpg

# 参数：
--keyring string   # 包含公钥的 keyring 文件路径，默认是 ~/.gnupg/pubring.gpg [citation:1]

helm package [Chart路径或名称] [参数]

# 将test的Chart打包，打包格式为：{Chart名称}-{Chart版本号}.tgz
helm package ./test
# 将test的Chart打包并指定版本号然后放到指定目录
helm package ./test --version 1.2.3 -d ./output

helm show [子命令] [Chart路径/Chart压缩包/仓库名/Chart名]

# 查看名为test的Chart压缩包的所有信息
helm show all output/test-1.2.3.tgz

# 查看名为test的Chart的配置 - Chart.yaml，格式化输出（进行标准排序、去除注释）
helm show chart test

# 查看名为test的Chart的values配置，全部输出包含注释
helm show values test-0.1.0.tgz

# 查看名为nginx的远程仓库的README
helm show readme bitnami/nginx

# 查看名为test的crds信息（需 Chart 内包含 crds/ 目录）
helm show crds test

# 登录
helm registry login [仓库地址] [参数]
# 登出
helm registry logout [仓库地址] [参数]

# 登录一个 OCI 仓库（用户名密码方式）
helm registry login oci://registry.example.com --username=admin --password=123456

# 登录时指定密码（或通过环境变量传递）
helm registry login oci://registry.example.com -u admin -p $REGISTRY_PASSWORD

# 登录时跳过 TLS 证书验证（用于测试环境）
helm registry login oci://registry.example.com --insecure

# 登出该仓库
helm registry logout oci://registry.example.com

# 登录阿里云 ACR 仓库（示例）
helm registry login oci://registry.cn-hangzhou.aliyuncs.com -u 阿里云账号

# 登录 Harbor 仓库（示例）
helm registry login oci://harbor.example.com -u admin -p Harbor12345

helm push [Chart压缩包] [目标仓库地址] [参数]

# 将打包好的 Chart 推送到 OCI 仓库
helm push test-0.1.0.tgz oci://registry.example.com/helm-charts

helm plugin [子命令] [插件名称或安装源] [参数]

helm env

HELM_BIN="helm"
HELM_CACHE_HOME="/root/.cache/helm"
HELM_CONFIG_HOME="/root/.config/helm"
HELM_DATA_HOME="/root/.local/share/helm"
HELM_DEBUG="false"
HELM_KUBEAPISERVER=""
HELM_KUBEASGROUPS=""
HELM_KUBEASUSER=""
HELM_KUBECAFILE=""
HELM_KUBECONTEXT=""
HELM_KUBETOKEN=""
HELM_MAX_HISTORY="10"
HELM_NAMESPACE="default"
HELM_PLUGINS="/root/.local/share/helm/plugins"
HELM_REGISTRY_CONFIG="/root/.config/helm/registry/config.json"
HELM_REPOSITORY_CACHE="/root/.cache/helm/repository"
HELM_REPOSITORY_CONFIG="/root/.config/helm/repositories.yaml"

my-chart/                      # Chart 根目录（名称与Chart名一致）
├── Chart.yaml                 # Chart 元数据文件（必需）
├── values.yaml                # 默认配置文件（必需）
├── values.schema.json         # values.json 校验文件（可选）
├── templates/                 # 模板目录（必需）
│   ├── NOTES.txt              # 安装后显示的说明信息（可选）
│   ├── _helpers.tpl           # 辅助函数定义（可选）
│   ├── deployment.yaml        # Deployment 模板
│   ├── service.yaml           # Service 模板
│   ├── configmap.yaml         # ConfigMap 模板
│   ├── secret.yaml            # Secret 模板
│   ├── hpa.yaml               # HPA 模板
│   ├── ingress.yaml           # Ingress 模板
│   └── tests/                 # 测试模板目录（可选）
│       └── test-connection.yaml
├── charts/                    # 子Chart依赖目录（可选）
│   ├── mysql/                 # 依赖的mysql Chart
│   └── redis/                 # 依赖的redis Chart
├── crds/                      # 自定义资源定义CRD（可选）
│   └── crd.yaml
└── templates/                 
    └── NOTES.txt              # 安装后的帮助信息

apiVersion: v2              # Chart API 版本（v1已废弃，用v2）
name: my-app                # Chart 名称（必须与目录名一致）
version: 1.2.3              # Chart 版本（语义化版本）
description: "我的应用"     # 一句话描述
type: application           # application（应用）/ library（库）
appVersion: "2.0.0"         # 实际应用的版本
icon: "https://example.com/icon.png"  # 图标URL

# 维护者信息
maintainers:
  - name: zhangsan
    email: zhangsan@example.com
    url: https://zhangsan.com

# 关键字（用于搜索）
keywords:
  - web
  - nginx

# 依赖关系（v2格式）
dependencies:
  - name: mysql
    version: "8.x.x"
    repository: "https://charts.bitnami.com/bitnami"
    condition: mysql.enabled    # 条件依赖
    tags: ["database"]           # 标签分组
    import-values:               # 导入子Chart的values
      - child: mysql
        parent: db

# 废弃版本
deprecated: false

# 家目录URL
home: "https://github.com/example/my-app"

# 源码仓库
sources:
  - "https://github.com/example/my-app"

# 副本数
replicaCount: 3

# 镜像配置
image:
  # 镜像仓库地址（可选）
  registry: docker.1ms.run
  # 镜像名称/路径
  repository: nginx
  # 镜像版本标签（指的是具体版本，比如nginx:1.24.0，那么tag就是1.24.0）
  tag: latest
  # 镜像拉取策略，和k8s是一样的，如果本地没有就从仓库拉取，本地有就用本地的
  pullPolicy: IfNotPresent

# 镜像拉取密钥
imagePullSecrets: []
nameOverride: ""
fullnameOverride: ""

# Service配置
service:
  type: ClusterIP
  port: 80
  targetPort: 8080
  annotations: {}

# Ingress配置
ingress:
  enabled: false
  className: nginx
  annotations: {}
  hosts:
    - host: chart-example.local
      paths:
        - path: /
          pathType: Prefix

# 资源配置
resources:
  limits:
    cpu: 500m
    memory: 512Mi
  requests:
    cpu: 250m
    memory: 256Mi

# 节点选择器
nodeSelector: {}

# 容忍度
tolerations: []

# 亲和性
affinity: {}

# 环境变量
env:
  - name: ENVIRONMENT
    value: production

# 持久化存储
persistence:
  enabled: true
  size: 10Gi
  storageClass: standard

# Pod注解
podAnnotations: {}

# 安全上下文
securityContext: {}

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "my-chart.fullname" . }}
  labels:
    {{- include "my-chart.labels" . | nindent 4 }}
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      {{- include "my-chart.selectorLabels" . | nindent 6 }}
  template:
    metadata:
      labels:
        {{- include "my-chart.selectorLabels" . | nindent 8 }}
    spec:
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
          imagePullPolicy: {{ .Values.image.pullPolicy }}
          ports:
            - containerPort: 80
              name: http
          env:
            {{- toYaml .Values.env | nindent 12 }}
          resources:
            {{- toYaml .Values.resources | nindent 12 }}

# 条件判断
{{- if .Values.persistence.enabled }}
volumeMounts:
  - name: data
    mountPath: /data
{{- end }}

# 循环遍历
{{- range .Values.env }}
- name: {{ .name }}
  value: {{ .value }}
{{- end }}

# 定义变量
{{- $fullName := include "my-chart.fullname" . -}}

# 管道操作
{{ .Values.image.tag | default "latest" | quote }}

{{/*
展开 Chart 的完整名称
*/}}
{{- define "my-chart.fullname" -}}
{{- .Release.Name }}-{{ .Chart.Name | trunc 63 | trimSuffix "-" }}
{{- end }}

{{/*
定义通用标签
*/}}
{{- define "my-chart.labels" -}}
helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
app.kubernetes.io/name: {{ .Chart.Name }}
app.kubernetes.io/instance: {{ .Release.Name }}
app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
app.kubernetes.io/managed-by: {{ .Release.Service }}
{{- end }}

{{/*
选择器标签
*/}}
{{- define "my-chart.selectorLabels" -}}
app.kubernetes.io/name: {{ .Chart.Name }}
app.kubernetes.io/instance: {{ .Release.Name }}
{{- end }}

恭喜您成功安装 {{ .Chart.Name }}！

1. 获取服务地址：
  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ .Chart.Name }}" -o jsonpath="{.items[0].metadata.name}")
  kubectl --namespace {{ .Release.Namespace }} port-forward $POD_NAME 8080:80

2. 访问应用：
  http://localhost:8080

3. 了解更多：
  https://github.com/example/{{ .Chart.Name }}

dependencies:
  - name: mysql
    version: "9.x.x"
    repository: "https://charts.bitnami.com/bitnami"
    condition: mysql.enabled        # 通过条件控制是否安装
    tags: ["database"]              # 通过标签分组
  - name: redis
    version: "16.x.x"
    repository: "https://charts.bitnami.com/bitnami"
    condition: redis.enabled
    tags: ["cache"]

# 更新依赖（下载到 charts/ 目录）
helm dependency update ./my-chart

# 列出依赖
helm dependency list ./my-chart

# 构建依赖（从 Chart.lock 重建）
helm dependency build ./my-chart

# 创建一个新 Chart 模板
helm create my-chart

# 创建后自动生成标准目录结构
my-chart/
├── Chart.yaml
├── values.yaml
├── charts/
├── templates/
│   ├── deployment.yaml
│   ├── service.yaml
│   ├── hpa.yaml
│   ├── ingress.yaml
│   └── tests/
└── .helmignore

# 检查 Chart 语法
helm lint ./my-chart

# 本地渲染模板（不安装）
helm template my-release ./my-chart --debug

# 验证 values 是否符合 schema
helm install my-release ./my-chart --dry-run --debug

# 打包成 .tgz 文件
helm package ./my-chart

# Helm 在打包时会自动将 Chart 版本号添加到文件名中，格式为：
<Chart名称>-<Chart版本号>.tgz
# 输出：my-chart-1.2.3.tgz

# 安装本地 Chart
helm install my-release ./my-chart-1.2.3.tgz

版本格式：主版本号.次版本号.修订号
   v2.1.3
   │ │ │
   │ │ └── 修订号（bug修复，兼容）
   │ └──── 次版本号（新增功能，兼容）
   └────── 主版本号（不兼容的修改）

# Chart.yaml 中的版本约束
dependencies:
  - name: mysql
    version: ">= 8.0.0, < 9.0.0"  # 范围约束
    repository: "https://..."

  - name: redis
    version: "^16.0.0"             # ^16.x.x（兼容16的所有版本）
    repository: "https://..."