50 lines
2.5 KiB
Markdown
50 lines
2.5 KiB
Markdown
# 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 の表を更新
|
||
- テンプレート追加・削除 → チャート構成表を更新
|
||
- 設定項目の追加・変更 → 設定リファレンス表を更新
|
||
- 注意事項・制限事項の変更 → 該当セクションを更新
|