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
+8
View File
@@ -1,3 +1,11 @@
{{- /*
【未使用】このファイルは出力されない。
下の if が参照する .Values.nginx.enabled は values.yaml に存在しないため、常に偽になる。
実際に使われる nginx 設定は templates/configmap.yaml(deployment.yaml が nginx.conf キーを
マウントしている)。カスタム設定として読まれるのは nginx.customConfig.snippet のみで、
このファイルだけが読む serverSnippet / httpSnippet は指定しても無視される。
nginx の設定を変更する場合は configmap.yaml を編集すること。
*/ -}}
{{- if .Values.nginx.enabled }}
apiVersion: v1
kind: ConfigMap