CLAUDE.md — n8n Helm Chart

共通ルール（要約） — 詳細は P:\Claude\CLAUDE.md（全体共通）と P:\Claude\HelmChart\CLAUDE.md（Helm チャート共通: リリースフロー・ワークフロー・Gitea Secrets）を参照。作業前に pull ／機能変更時は README 更新／作業単位ごとに commit → push まで／コミットに AI クレジットを付けない／ pull で入った変更を revert しない／ Helm はローカル実行不可（Python のみ可）。

リポジトリ概要

n8n ワークフロー自動化ツールを Kubernetes 上にデプロイするHelmチャートです。 Raspberry Pi などのベアメタル上で動作する Kubernetes クラスタを想定した構成になっています。 n8nio/n8n 公式マルチアーキテクチャイメージ（linux/arm64 対応）を使用します。

Gitea リポジトリ: ssh://git@192.168.9.65/helmchart/n8n.git
主アプリ: n8n（チャートのバージョン = n8n のバージョン。サブアプリは無いため、n8n 更新時は常にリリース）

ARM 対応について

n8nio/n8n は linux/arm64 に対応したマルチアーキテクチャイメージです。 Raspberry Pi 4 以降（arm64）で動作します。

チャート構成

リソース	説明
Deployment	n8n 本体（シングルコンテナ）
Service	LoadBalancer / ClusterIP（ポート 5678）
PVC	n8n データ（ワークフロー・認証情報・SQLite DB）永続化
Secret	暗号化キー・Basic認証パスワード・DBパスワード
Ingress	オプション（nginx ingress controller 対応）
HPA	オプション（※SQLiteモード時はスケールアウト非推奨）
PDB	Pod Disruption Budget
NetworkPolicy	オプション

データ永続化

n8n のデータは /home/node/.n8n に保存されます。 persistence.enabled: true（デフォルト）で PVC に永続化されます。 persistence.enabled: false の場合、Pod 再起動でデータが失われます。

データベース

デフォルト: SQLite（/home/node/.n8n/database.sqlite）
本番推奨: PostgreSQL（n8n.database.type: postgresdb）

README 更新時の反映先

イメージバージョン・設定値の変更 → values の表を更新
テンプレート追加・削除 → チャート構成表を更新
設定項目の追加・変更 → 設定リファレンス表を更新
注意事項・制限事項の変更 → 該当セクションを更新

2.5 KiB Raw Permalink Blame History Unescape Escape