建立 NOTES.txt 檔案

在本節中,我們將探討 Helm 提供給圖表使用者的說明工具。在 helm installhelm upgrade 結束時,Helm 可以印出一個區塊的實用資訊給使用者。這些資訊可以使用範本高度自訂。

若要將安裝說明新增至圖表,只需建立一個 templates/NOTES.txt 檔案。此檔案是純文字檔,但會被視為範本處理,並且可以使用所有一般的範本函式和物件。

讓我們建立一個簡單的 NOTES.txt 檔案

Thank you for installing {{ .Chart.Name }}.

Your release is named {{ .Release.Name }}.

To learn more about the release, try:

  $ helm status {{ .Release.Name }}
  $ helm get all {{ .Release.Name }}

現在,如果我們執行 helm install rude-cardinal ./mychart,我們會在底部看到這則訊息

RESOURCES:
==> v1/Secret
NAME                   TYPE      DATA      AGE
rude-cardinal-secret   Opaque    1         0s

==> v1/ConfigMap
NAME                      DATA      AGE
rude-cardinal-configmap   3         0s


NOTES:
Thank you for installing mychart.

Your release is named rude-cardinal.

To learn more about the release, try:

  $ helm status rude-cardinal
  $ helm get all rude-cardinal

以這種方式使用 NOTES.txt 是向使用者提供有關如何使用其新安裝圖表的詳細資訊的好方法。強烈建議建立 NOTES.txt 檔案,但這並非必要項目。