helm中部署nginx-test Chart 为示例

helm中部署nginx-test Chart 为示例

Chart基本结构由以下几个部分组成：

• charts 存放子Chart (Subchart) 的定义，Subchart 指的是当前 Chart 依赖的 Chart ， 在 requirements.yaml 中定义
• Chart.yaml 包含 Chart 信息的 YAML 文件， 包括 Chart 的版本、名称等，在 DCE Helm 插件中还包含 Chart 的 团队授权 信息 和 是否公开 的信息
• README.md 可选：Chart 的介绍信息等（该文件对于一个大型 Chart 来说十分重要）
• Requirements.yaml 可选：列举当前 Chart 的需要依赖的 Chart
• templates
• 该目录下存放 Chart 所有的 K8s 资源定义模板，通常不同的资源放在不同的文件中，DCE Helm 插件中自定义模板的 K8s 资源统一放在 all_sources.yaml 文件中
• _helpers.tpl ， 通常这个文件存放可重用的模板片段，该文件中的定义可以在 Chart 其它资源定义模板中使用
• NOTES.txt，可选：一段简短使用说明的文本文件，用于安装 Release 后提示用户使用
• values.yaml 当前 Chart 的默认配置的值

nginx-test Chart 为示例

[root@k1 helm]# helm create nginx-test

Creating nginx-test

templates 下的模板文件， 用于生成 Kubernetes 资源清单(manifests)

上面定义了 一个 deployments.yaml 和 service.yaml 资源文件，里面使用 {{ }} 符号的是 Go 模板语言的标准。其中可以通过：

• .Values 对象访问 values.yaml 文件的内容， 前面的dot(.) 表示从顶层命名空间开始，找到 Values 对象(下同)
• .Release、.Chart 开头的预定义值可用于任何的模板中
• .Chart 对象用来访问 Chart.yaml 文件的内容
• .Release 对象是 Helm的内置对象之一

命名模板(_helper.tpl) ：可以从上面看到有 {{ template "nginx-test.fullname" . }} 定义。该定义由 _helper.tpl 文件定义的字段来实现

该模板定义了 "nginx-test.name"、"nginx-test.fullname"、"nginx-test.chart" 等可重用模板部分，当模板引擎读取该文件时，它存储对 nginx-test.name等的引用， 直到调用 template "nginx-test.name" 为止。然后把值渲染到模板中。

注意 {{ template "nginx-test.chart" . }} 后面有个dot(.)，这是因为一个已命名的模板（用于创建 define) 被渲染时，它将接收由该 template 调用传入的范围（scope)。没有范围传入，在模板中无法访问任何内容，因此在：

{{- define "nginx-test.chart" -}}
这里面的 .Chart 将无法访问，导致在模板中无法看到内容，因为这里值为空
{{- end -}}

因此在模板中将 范围(scope) 传入即可正常使用：

# cat nginx-test/templates/service.yaml 
apiVersion: v1
kind: Service
metadata:
  name: {{ include "nginx-test.fullname" . }}

在末尾传递了 . 这样就可以使用 .Values 或者 .Chart 或其它范围(scope)

Chart 依赖（requirements.yaml)

该文件列举当前 Chart 所有的 依赖（subchart)。有几个字段是必要的：

• name: 依赖 Chart 的名称（必要）
• version: 依赖 Chart 的版本号（必要）
• repository: 依赖 Chart 的存储库完整URL，必须通过 helm repo add 添加 repository（存储库）到本地

##错误记录

Q1：helm repo update

Error: no repositories found. You must add one before updating

helm repo add stable https://kubernetes.oss-cn-hangzhou.aliyuncs.com/charts

helm repo update

helm repo list

Q2：执行helm init报错信息：

Error: https://kubernetes-charts.storage.googleapis.com is not a valid chart repository or cannot be reached: failed to fetch https://kubernetes-charts.storage.googleapis.com/index.yaml : 403 Forbidden

因访问权限原因导致

解决措施：创建丢失文件，再次执行helm init 即可

echo "" > /root/.helm/repository/repositories.yaml