docs: nginx.customConfig の取り違えと client_max_body_size 重複を防ぐ記述に修正
Helm Chart Release / release-chart (push) Successful in 6s

あるプロジェクトから「serverSnippet が効かない」「snippet は古いキー」との
指摘があり調査した結果、指摘の前提は誤りだった。

- 実際に使われる templates/configmap.yaml が読むのは snippet で、values.yaml と
  README も snippet で一致している。
- serverSnippet / httpSnippet は、.Values.nginx.enabled が存在せず一度も出力
  されない configmap-nginx.yaml だけが読むキーで、values・README に載ったことが
  なく、指定しても黙って無視される。
- README 例6・例9 が snippet に client_max_body_size を書く手順になっており、
  v8.5.9-b 以降は uploadMaxSize の自動出力と重複して nginx が起動しない
  (2026-09-29 の障害の発生源)。例6 は location ~ \.php$ も重複定義していた。

挙動の変更はなくドキュメント・コメントのみ。
- values.yaml / README: 読まれるキーは snippet のみ、挿入先は server ブロック内、
  client_max_body_size は書かず uploadMaxSize を使うことを明記
- README 例6・例9 を uploadMaxSize 指定に修正
- configmap-nginx.yaml: 未使用であることを示す注記を追加

手動リリース 8.5.11-a。
This commit is contained in:
2026-10-20 20:38:07 +09:00
parent 5ab3428893
commit f8aaa5944d
5 changed files with 51 additions and 15 deletions
+10
View File
@@ -64,6 +64,16 @@ persistence:
size: 1Gi
nginx:
# 独自のnginx設定を、server { } ブロックの末尾へそのまま挿入する(templates/configmap.yaml)。
# 読まれるキーは snippet のみ。serverSnippet / httpSnippet は未使用の
# templates/configmap-nginx.yaml 専用で出力されないため、指定しても無視される。
# また挿入先は server ブロック内のため、http レベル専用のディレクティブ
# (limit_req_zone 等)は書けない。
#
# 【重複注意】以下はチャートが自動で出力するため snippet に書かない
# (書くと "directive is duplicate" 等で nginx が起動しなくなる):
# - client_max_body_size → uploadMaxSize で設定する
# - location = /sitemap.xml(Content-Typeの明示)
customConfig:
enabled: false
snippet: |-