一个好的应用必定有一套好的文档,文档的质量往往和代码的质量成正比。而 Helm Chart 中的 README.md
文件就承担了文档的作用。
chart的自述文件README文件应该使用Markdown格式(README.md),一般应包含:
- chart提供的应用或服务的描述
- 运行chart的先决条件或要求
values.yaml
的可选项和默认值的描述- 与chart的安装或配置相关的其他任何信息
README.md
文件会包含hub和用户接口显示的chart的详细信息。
Helm-docs
helm-docs 可以根据 charts 内容自动生成 markdown 文件。该文件会包含有关 charts 的元数据,以及 value.yaml
中的参数,同时还可以引用子模板(默认为 README.md.gotmpl
),进一步定制生成的内容。
安装
helm-docs 使用 golang 开发,支持多平台:
wget https://github.com/norwoodj/helm-docs/releases/download/v1.5.0/helm-docs_1.5.0_Linux_x86_64.tar.gz
tar zxvf helm-docs_1.5.0_Linux_x86_64.tar.gz
mv helm-docs /usr/local/bin/helm-docs