Helm

应用定义:Helm 入门和实战

使用 Helm 定义应用

从第三方 Helm Chart 开始

Helm 核心概念

Chart

K8s 应用安装包,包含应用的 K8s 对象用于创建实例

Release

使用默认或特定参数安装的 Helm 实例(运行中的实例)。

我们知道 Helm Chart 实际上是一个应用安装包,只有在安装(实例化)它时才会生效。它可以在同一个集群中甚至是同一个命名空间下安装多次,所以我们就需要为每次安装都起一个唯一的名字,这就是 Helm Release Name。

Repository

用于存储和分发的 Helm Chart 仓库(Git、OCI)

Helm 安装

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

https://helm.sh/docs/intro/install/

插一句:helm list 信息存在哪?

会有一个 secret——sh.helm.release.xxxxxxxx

Helm 常用命令

Demo: 从零创建 Helm Chart

helm create demo

Chart.yaml

apiVersion: v2 # API 版本,默认v2
name: demo # Helm Chart 名称
description: A Helm chart for Kubernetes # 描述
type: application # application 或 library,对于应用选择前者
version: 0.1.0 # Helm Chart 版本号
appVersion: "1.16.0" # 应用版本号
dependencies: # 依赖的其他 chart

其中,apiVersion 字段设置为 v2,代表使用 Helm 3 来安装应用。

name 表示 Helm Chart 的名称,当使用 helm install 命令安装 Helm Chart 时,指定的名称也就是这里配置的名称。

description 表示 Helm Chart 的描述信息,你可以根据需要填写。

type 表示类型,这里我们将其固定为 application,代表 Kubernetes 应用。

version 表示我们打包的 Helm Chart 的版本,当使用 helm install 时,可以指定这里定义的版本号。Helm Chart 的版本就是通过这个字段来管理的,当我们发布新的 Chart 时,需要更新这里的版本号。

appVersion 和 Helm Chart 无关,它用于定义应用的版本号,建立当前 Helm Chart 和应用版本的关系。

values.yaml

# 所有字段和值都可自定义,用来为模板提供值
replicaCount: 1
image:
    repository: nginx
    pullPolicy: IfNotPresent
    # Overrides the image tag whose default is the chart appVersion.
    tag: "v1.0"
imagePullSecrets: []
nameOverride: ""
fullnameOverride: ""

模板变量

# templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
spec:
  template:
    spec:
      containers:
      - name: {{ .Chart.Name }}
        image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
        # 该模板变量替换为 values.yaml 配置的值

Ingress 处理:使用命名空间变量

Helm 高级核心技术

内置变量

内置函数

依赖(Dependencies)

# Chart.yaml
dependencies:
- name: nginx
version: "1.2.3"
repository: "https://example.com/charts"
- name: memcached
version: "1.2.3"
repository: "file://../dependency_chart/memcached"

子 Chart(Sub Chart)

global:

salad: caesar

Hooks

Demo:Hooks

apiVersion: batch/v1
kind: Job
metadata:
  name: "{{ .Release.Name }}"
  annotations:
    # This is what defines this resource as a hook. Without this line, the
    # job is considered part of the release.
    "helm.sh/hook": post-install
    "helm.sh/hook-weight": "-5"
    "helm.sh/hook-delete-policy": hook-succeeded

Helm Cheat Sheet

# 安装 Helm Chart 或者执行升级,无需担心重复执行问题
$ helm upgrade --install <release name> --values <values file> <chart directory>
# 查看 Helm Chart values.yaml 配置信息
$ helm inspect values <CHART>
# 查看 Helm Repository Chart 列表
$ helm repo list
# 查看所有命名空间的 release
$ helm list --all-namespaces
# 升级应用前先更新依赖
$ helm upgrade <release> <chart> --dependency-update
# 回滚应用
$ helm rollback <release> <revision>