【笔记ing】Helm-3 主题-1 Chart

Chart

Helm使用的包格式称为chart。chart就是一个描述Kubernetes相关资源的文件集合。单个chart可以用来部署一些简单的,类似于memcache pod,或者某些复杂的HTTP服务器以及web全栈应用、数据库、缓存等等。

chart是作为特定目录布局的文件被创建的。它们可以打包到要部署的版本存档中。

如果您想下载和查看一个发布的chart,但不安装它,您可以用这个命令:helm pull chartrepo/chartname。

该文档解释说明了chart格式,并提供了用Helm构建chart的基本指导。

Chart文件结构

chart是一个组织在文件目录中的集合。目录名称就是chart名称(没有版本信息)。因为描述WordPress的chart可以存储在wordpress/目录中。

在这个目录中,Helm期望可以匹配以下结构:

wordpress/

  Chart.yaml  # 包含了chart信息的YAML文件

  LICENSE  # 可选:包含chart许可证的纯文本文件

  README.md  # 可选:可读的READEME文件

  values.yaml  # chart 默认的配置值

  values.schema.json  # 可选:一个使用JSON结构的values.yaml文件

  charts/  # 包含chart依赖的其他chart

  crds/  # 自定义资源的定义

  templates/  # 模板目录,当和values结合时,可生成有效的Kubernetes manifest文件

  templates/NOTES.txt  # 可选:包含简要使用说明的纯文本文件

wordpress/
  Chart.yaml          # 包含了chart信息的YAML文件
  LICENSE             # 可选: 包含chart许可证的纯文本文件
  README.md           # 可选: 可读的README文件
  values.yaml         # chart 默认的配置值
  values.schema.json  # 可选: 一个使用JSON结构的values.yaml文件
  charts/             # 包含chart依赖的其他chart
  crds/               # 自定义资源的定义
  templates/          # 模板目录, 当和values 结合时,可生成有效的Kubernetes manifest文件
  templates/NOTES.txt # 可选: 包含简要使用说明的纯文本文件

Helm保留使用charts/,crds/,templates/目录,以及列举出的文件名。其他文件保持原样。

Chart.yaml 文件

Chart.yaml文件时chart必需的。包含了以下字段:

apiVersion: chart API版本(必需)

name: chart名称(必需)

version: 语义化2 版本(必需)

kubeVersion: 兼容Kubernetes版本的语义化版本(可选)

description: 一句话对这个项目的描述(可选)

type: chart类型(可选)

keywords:

  - 关于项目的一组关键字(可选)

home: 项目home页面的URL(可选)

sources:

  - 项目源码的URL列表(可选)

dependencies:  # chart 必要条件列表(可选)

  -name: chart名称(nginx)

    version: chart版本("1.2.3")

    repository: (可选)仓库URL("https://example.com/charts")或别名("@repo-name")

    condition: (可选)解析为布尔值的yaml路径,用于启用/禁用chart(e.g. subchart1.enabled)

    tags: # (可选)

      - 用于一次启用/禁用 一组chart的tag

    import-values: #(可选)

      - ImportValue保存原值到导入父键的映射。每项可以是字符串对着一对子/父列表项

    alias: (可选)chart中使用的别名。当你要多次添加相同的chart时会很有用

maintainers: #(可选)

    - name: 维护者名字(每个维护者都需要)

      email: 维护者邮箱(每个维护者可选)

      url: 维护者URL(每个维护者可选)

icon: 用作icon的SVG或PNG图片URL(可选)

appVersion: 包含的应用版本(可选)。不需要是语义化,建议使用引号

deprecated: 不被推荐的chart(可选,布尔值)

annotations: 

  example: 按名称输入的批注列表(可选)。

apiVersion: chart API 版本 (必需)
name: chart名称 (必需)
version: 语义化2 版本(必需)
kubeVersion: 兼容Kubernetes版本的语义化版本(可选)
description: 一句话对这个项目的描述(可选)
type: chart类型 (可选)
keywords:
  - 关于项目的一组关键字(可选)
home: 项目home页面的URL (可选)
sources:
  - 项目源码的URL列表(可选)
dependencies: # chart 必要条件列表 (可选)
  - name: chart名称 (nginx)
    version: chart版本 ("1.2.3")
    repository: (可选)仓库URL ("https://example.com/charts") 或别名 ("@repo-name")
    condition: (可选) 解析为布尔值的yaml路径,用于启用/禁用chart (e.g. subchart1.enabled )
    tags: # (可选)
      - 用于一次启用/禁用 一组chart的tag
    import-values: # (可选)
      - ImportValue 保存源值到导入父键的映射。每项可以是字符串或者一对子/父列表项
    alias: (可选) chart中使用的别名。当你要多次添加相同的chart时会很有用
maintainers: # (可选)
  - name: 维护者名字 (每个维护者都需要)
    email: 维护者邮箱 (每个维护者可选)
    url: 维护者URL (每个维护者可选)
icon: 用做icon的SVG或PNG图片URL (可选)
appVersion: 包含的应用版本(可选)。不需要是语义化,建议使用引号
deprecated: 不被推荐的chart (可选,布尔值)
annotations:
  example: 按名称输入的批注列表 (可选).

从v3.3.2,不再允许额外的字段。推荐的方法是在annotations中自定义元数据。

Chart和版本控制

每个chart都必须有个版本号。版本必须遵循 语义化版本2 标准。不像经典Helm,Helm v2以及后续版本会使用版本号作为发布标记。仓库中的包通过名称加版本号识别。

Semantic Versioning 2.0.0 | Semantic Versioning

比如nginx chart的版本字段version: 1.2.3按照名称被设置为:

nginx-1.2.3.tgz

更多复杂的语义化版本2都是支持的,比如version: 1.2.3-alpha.1+ef365。但系统明确禁止非语义化版本名称。

注意:鉴于经典Helm和部署管理器在使用chart时都非常倾向于GitHub,Helm v2和后续版本不再依赖或需要GitHub甚至是Git。因此,它完全不使用Git SHA进行版本控制。

Chart.yaml 文件中的version字段被很多Helm工具使用,包括CLI。当生成一个包时,helm package命令可以用Chart.yaml文件中找到的版本号作为包名中的token。系统假设chart包名中的版本号可以与Chart.yaml文件中的版本号匹配。如果不满足这一假设会导致错误。

☆ apiVersion 字段

对于至少需要Helm 3的chart,apiVerison字段应该是v2.Chart支持之前apiVersion设置为v1的Helm版本,并且在Helm 3中仍然可安装。

v1到v2的改变:

1、dependencies字段定义了chart的依赖,针对于v1版本的chart被放置在分隔开的requirements.yaml文件中(查看 Chart依赖 )。

Helm | Chart

2、type字段,用于识别应用和库类型的chart(查看 Chart类型 )。

Helm | Chart

☆ appVersion字段

仅用于本人学习

来源:Helm | Docs

你可能感兴趣的:(Helm,云原生,kubernetes,k8s)