创建一个NOTES.txt文件

该部分会介绍为chart用户提供说明的Helm工具。在helm installhelm upgrade命令的最后,Helm会打印出对用户有用的信息。 使用模板可以高度自定义这部分信息。

要在chart添加安装说明,只需创建templates/NOTES.txt文件即可。该文件是纯文本,但会像模板一样处理, 所有正常的模板函数和对象都是可用的。

让我们创建一个简单的NOTES.txt文件:

  1. Thank you for installing {{ .Chart.Name }}.
  2. Your release is named {{ .Release.Name }}.
  3. To learn more about the release, try:
  4. $ helm status {{ .Release.Name }}
  5. $ helm get all {{ .Release.Name }}

现在如果我们执行helm install rude-cardinal ./mychart 会在底部看到:

  1. RESOURCES:
  2. ==> v1/Secret
  3. NAME TYPE DATA AGE
  4. rude-cardinal-secret Opaque 1 0s
  5. ==> v1/ConfigMap
  6. NAME DATA AGE
  7. rude-cardinal-configmap 3 0s
  8. NOTES:
  9. Thank you for installing mychart.
  10. Your release is named rude-cardinal.
  11. To learn more about the release, try:
  12. $ helm status rude-cardinal
  13. $ helm get all rude-cardinal

使用NOTES.txt这种方式是给用户提供关于如何使用新安装的chart细节信息的好方法。尽管并不是必需的,强烈建议创建一个NOTES.txt文件。