Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
3c2224cad6 | ||
|
|
6bfa0b8c4c | ||
|
|
e2dae9ca90 | ||
|
|
58d9f79a42 | ||
|
|
fcb55084e0 | ||
|
|
9be38cf500 | ||
|
|
1d41d9d39c | ||
|
|
c7e2e493bb | ||
|
|
3c31e3435e | ||
|
|
b322ab1b39 | ||
|
|
56bcd7d514 | ||
|
|
cfe6efbad3 | ||
|
|
77899cf256 | ||
|
|
4df9f84eca | ||
|
|
fd46c89d19 |
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
trigger: always_on
|
||||||
|
description: Read the CLAUDE.md hierarchy via GEMINI.md before doing anything in this workspace
|
||||||
|
---
|
||||||
|
|
||||||
|
最初に、このディレクトリの `GEMINI.md` を読み、そこに列挙された CLAUDE.md を上から順にすべて読んで従うこと。
|
||||||
|
Read `GEMINI.md` in this directory first, then read and follow every CLAUDE.md it lists, in order.
|
||||||
@@ -1,4 +1,7 @@
|
|||||||
# n8n Helm Chart - CLAUDE.md
|
# 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 のみ可)。
|
||||||
|
|
||||||
## リポジトリ概要
|
## リポジトリ概要
|
||||||
|
|
||||||
@@ -6,17 +9,14 @@ n8n ワークフロー自動化ツールを Kubernetes 上にデプロイするH
|
|||||||
Raspberry Pi などのベアメタル上で動作する Kubernetes クラスタを想定した構成になっています。
|
Raspberry Pi などのベアメタル上で動作する Kubernetes クラスタを想定した構成になっています。
|
||||||
`n8nio/n8n` 公式マルチアーキテクチャイメージ(linux/arm64 対応)を使用します。
|
`n8nio/n8n` 公式マルチアーキテクチャイメージ(linux/arm64 対応)を使用します。
|
||||||
|
|
||||||
|
- **Gitea リポジトリ**: `ssh://git@192.168.9.65/helmchart/n8n.git`
|
||||||
|
- **主アプリ**: n8n(チャートのバージョン = n8n のバージョン。サブアプリは無いため、n8n 更新時は常にリリース)
|
||||||
|
|
||||||
## ARM 対応について
|
## ARM 対応について
|
||||||
|
|
||||||
`n8nio/n8n` は linux/arm64 に対応したマルチアーキテクチャイメージです。
|
`n8nio/n8n` は linux/arm64 に対応したマルチアーキテクチャイメージです。
|
||||||
Raspberry Pi 4 以降(arm64)で動作します。
|
Raspberry Pi 4 以降(arm64)で動作します。
|
||||||
|
|
||||||
## Git 情報
|
|
||||||
|
|
||||||
- **ユーザー名**: Claude
|
|
||||||
- **メールアドレス**: claude@cafepieters.com
|
|
||||||
- **リポジトリ**: ssh://git@192.168.9.65/helmchart/n8n.git
|
|
||||||
|
|
||||||
## チャート構成
|
## チャート構成
|
||||||
|
|
||||||
| リソース | 説明 |
|
| リソース | 説明 |
|
||||||
@@ -41,42 +41,9 @@ n8n のデータは `/home/node/.n8n` に保存されます。
|
|||||||
- デフォルト: SQLite(`/home/node/.n8n/database.sqlite`)
|
- デフォルト: SQLite(`/home/node/.n8n/database.sqlite`)
|
||||||
- 本番推奨: PostgreSQL(`n8n.database.type: postgresdb`)
|
- 本番推奨: PostgreSQL(`n8n.database.type: postgresdb`)
|
||||||
|
|
||||||
## 更新時のルール
|
## README 更新時の反映先
|
||||||
|
|
||||||
**チャートに何らかの変更を加えた場合、必ず `README.md` を最新状態に更新してからコミットすること。**
|
|
||||||
更新内容に応じて以下を反映する:
|
|
||||||
- イメージバージョン・設定値の変更 → values の表を更新
|
- イメージバージョン・設定値の変更 → values の表を更新
|
||||||
- テンプレート追加・削除 → チャート構成表を更新
|
- テンプレート追加・削除 → チャート構成表を更新
|
||||||
- 設定項目の追加・変更 → 設定リファレンス表を更新
|
- 設定項目の追加・変更 → 設定リファレンス表を更新
|
||||||
- 注意事項・制限事項の変更 → 該当セクションを更新
|
- 注意事項・制限事項の変更 → 該当セクションを更新
|
||||||
|
|
||||||
## リリースフローのルール
|
|
||||||
|
|
||||||
### バージョン番号の方針
|
|
||||||
- Helmチャートのバージョン番号(`Chart.yaml` の `version` / `appVersion`)は、**n8n のバージョン番号と同一**とする。
|
|
||||||
|
|
||||||
### 自動リリース条件
|
|
||||||
- **n8n バージョン更新時**: `values.yaml` と `Chart.yaml` を更新し、Gitタグ・Giteaリリース・Gitea Package Registry への発行まで行う。
|
|
||||||
|
|
||||||
### 手動リリース(臨時)
|
|
||||||
- 改修作業などで手動リリースが必要な場合は、バージョン末尾にアルファベットを付与する。
|
|
||||||
- 例: `2.19.2` → `2.19.2-a`, `2.19.2-b`
|
|
||||||
|
|
||||||
## ワークフロー構成
|
|
||||||
|
|
||||||
### `.gitea/workflows/image-update-and-release.yaml`
|
|
||||||
毎週月曜日 3:00 AM(JST 12:00 PM)に自動実行され、以下を行う:
|
|
||||||
1. Docker Hub から n8n の最新バージョンを取得
|
|
||||||
2. 更新がある場合は `values.yaml` と `Chart.yaml` を更新
|
|
||||||
3. Gitタグ・Giteaリリース・Gitea Package Registry への発行を実施
|
|
||||||
|
|
||||||
### `.gitea/workflows/helm-release.yaml`
|
|
||||||
`main` ブランチへのプッシュ時に自動実行。Gitea Package Registry にチャートを発行する。
|
|
||||||
|
|
||||||
## 必要な Gitea Secrets
|
|
||||||
|
|
||||||
| シークレット名 | 用途 |
|
|
||||||
|---|---|
|
|
||||||
| `GITEA_TOKEN` | Gitea API(リリース作成・タグ操作) |
|
|
||||||
| `REGISTRY_USER` | Gitea Package Registry ユーザー名 |
|
|
||||||
| `REGISTRY_TOKEN` | Gitea Package Registry トークン |
|
|
||||||
|
|||||||
+2
-2
@@ -2,8 +2,8 @@ apiVersion: v2
|
|||||||
name: n8n
|
name: n8n
|
||||||
description: A Helm chart for n8n workflow automation on Kubernetes (ARM/Raspberry Pi ready)
|
description: A Helm chart for n8n workflow automation on Kubernetes (ARM/Raspberry Pi ready)
|
||||||
type: application
|
type: application
|
||||||
version: "2.27.3"
|
version: "2.44.3"
|
||||||
appVersion: "2.27.3"
|
appVersion: "2.44.3"
|
||||||
keywords:
|
keywords:
|
||||||
- n8n
|
- n8n
|
||||||
- workflow
|
- workflow
|
||||||
|
|||||||
@@ -0,0 +1,24 @@
|
|||||||
|
# GEMINI.md — Antigravity (Gemini) 用エントリポイント(HelmChart\n8n)
|
||||||
|
|
||||||
|
このディレクトリのルールはすべて **`CLAUDE.md`** に記載されている。本ファイルにはルール本文を書かず、読むべき CLAUDE.md への参照だけを置く(正本は常に CLAUDE.md)。
|
||||||
|
|
||||||
|
## 必ず最初に実行すること
|
||||||
|
|
||||||
|
以下のファイルを**上から順に**読み込み、すべての指示に従うこと。上位ほど広い範囲に適用される共通ルールで、下位は上位を前提とした補足・例外である。
|
||||||
|
|
||||||
|
1. `P:\Claude\CLAUDE.md` — 全組織共通ルール(Git 運用・コミット書式・実行環境・情報記載の原則)
|
||||||
|
2. `P:\Claude\HelmChart\CLAUDE.md` — HelmChart 組織共通ルール
|
||||||
|
3. `P:\Claude\HelmChart\n8n\CLAUDE.md` — n8n リポジトリ固有ルール(このディレクトリ)
|
||||||
|
|
||||||
|
> Antigravity はワークスペース(または git ルート)直下のルールしか自動で読まず、親フォルダを遡らない。そのため上位階層のパスをここに明示している。`P:\Claude` はクラウド同期されており、デスクトップ・ノート PC とも同じパスで存在する。
|
||||||
|
|
||||||
|
## 読み替え
|
||||||
|
|
||||||
|
- CLAUDE.md 中の「Claude」「Claude Code」は、Antigravity で作業する場合は Gemini 自身のことと読み替える。
|
||||||
|
- Git のコミット者は Antigravity でも `user.name = Claude` / `user.email = claude@cafepieters.com` のまま使う(変更しない)。コミットメッセージに AI クレジットを付けない。
|
||||||
|
- Claude Code 固有の機能(`.claude/` 設定、スキル、メモリ等)に関する記述は無視してよい。
|
||||||
|
|
||||||
|
## 保守ルール
|
||||||
|
|
||||||
|
- ルールの追加・変更は **CLAUDE.md にのみ**行う。本ファイルと `.agents/rules/claude-md.md` は参照だけを保持し、内容を増やさない。
|
||||||
|
- CLAUDE.md を新しいディレクトリに追加したときは、同じ形式の `GEMINI.md` と `.agents/rules/claude-md.md` も併置する。
|
||||||
@@ -119,12 +119,15 @@ helm install my-n8n cafepieters/n8n \
|
|||||||
|
|
||||||
### リソース(Raspberry Pi 向けデフォルト)
|
### リソース(Raspberry Pi 向けデフォルト)
|
||||||
|
|
||||||
|
n8n 2.23 以降はメモリ消費が増加しています。`nodeHeapSizeMb` は `resources.limits.memory` の約 75% に設定してください。
|
||||||
|
|
||||||
| パラメータ | デフォルト |
|
| パラメータ | デフォルト |
|
||||||
|---|---|
|
|---|---|
|
||||||
| `resources.requests.cpu` | `250m` |
|
| `resources.requests.cpu` | `250m` |
|
||||||
| `resources.requests.memory` | `256Mi` |
|
| `resources.requests.memory` | `512Mi` |
|
||||||
| `resources.limits.cpu` | `1000m` |
|
| `resources.limits.cpu` | `1000m` |
|
||||||
| `resources.limits.memory` | `512Mi` |
|
| `resources.limits.memory` | `1Gi` |
|
||||||
|
| `nodeHeapSizeMb` | `768` |
|
||||||
|
|
||||||
## セキュアCookieの自動設定
|
## セキュアCookieの自動設定
|
||||||
|
|
||||||
@@ -237,6 +240,20 @@ helm upgrade my-n8n cafepieters/n8n \
|
|||||||
|
|
||||||
| バージョン | n8n | 変更内容 |
|
| バージョン | n8n | 変更内容 |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
|
| 2.44.3 | 2.44.3 | 自動更新 |
|
||||||
|
| 2.43.3 | 2.43.3 | 自動更新 |
|
||||||
|
| 2.42.2 | 2.42.2 | 自動更新 |
|
||||||
|
| 2.41.3 | 2.41.3 | 自動更新 |
|
||||||
|
| 2.40.3 | 2.40.3 | 自動更新 |
|
||||||
|
| 2.39.4 | 2.39.4 | 自動更新 |
|
||||||
|
| 2.37.10 | 2.37.10 | 自動更新 |
|
||||||
|
| 2.37.4 | 2.37.4 | 自動更新 |
|
||||||
|
| 2.36.5-a | 2.36.5 | OOM対応: メモリ制限 1Gi・NODE_OPTIONS ヒープ制限追加・WEBHOOK_URL 非推奨警告修正 |
|
||||||
|
| 2.36.5 | 2.36.5 | 自動更新 |
|
||||||
|
| 2.35.3 | 2.35.3 | 自動更新 |
|
||||||
|
| 2.34.4 | 2.34.4 | 自動更新 |
|
||||||
|
| 2.33.3 | 2.33.3 | 自動更新 |
|
||||||
|
| 2.33.0 | 2.33.0 | 自動更新 |
|
||||||
| 2.27.3 | 2.27.3 | 自動更新 |
|
| 2.27.3 | 2.27.3 | 自動更新 |
|
||||||
| 2.26.3 | 2.26.3 | 自動更新ワークフロー修正(GitHub Releases + Docker Hub ハイブリッドソース) |
|
| 2.26.3 | 2.26.3 | 自動更新ワークフロー修正(GitHub Releases + Docker Hub ハイブリッドソース) |
|
||||||
| 2.22.2 | 2.22.2 | 自動更新 |
|
| 2.22.2 | 2.22.2 | 自動更新 |
|
||||||
|
|||||||
@@ -41,6 +41,8 @@ spec:
|
|||||||
containerPort: 5678
|
containerPort: 5678
|
||||||
protocol: TCP
|
protocol: TCP
|
||||||
env:
|
env:
|
||||||
|
- name: NODE_OPTIONS
|
||||||
|
value: "--max-old-space-size={{ .Values.nodeHeapSizeMb }}"
|
||||||
- name: N8N_PORT
|
- name: N8N_PORT
|
||||||
value: "5678"
|
value: "5678"
|
||||||
- name: N8N_PROTOCOL
|
- name: N8N_PROTOCOL
|
||||||
@@ -48,7 +50,7 @@ spec:
|
|||||||
- name: N8N_HOST
|
- name: N8N_HOST
|
||||||
value: {{ .Values.n8n.host | quote }}
|
value: {{ .Values.n8n.host | quote }}
|
||||||
{{- if .Values.n8n.webhookUrl }}
|
{{- if .Values.n8n.webhookUrl }}
|
||||||
- name: WEBHOOK_URL
|
- name: N8N_WEBHOOK_URL
|
||||||
value: {{ .Values.n8n.webhookUrl | quote }}
|
value: {{ .Values.n8n.webhookUrl | quote }}
|
||||||
{{- end }}
|
{{- end }}
|
||||||
- name: GENERIC_TIMEZONE
|
- name: GENERIC_TIMEZONE
|
||||||
|
|||||||
+8
-3
@@ -7,7 +7,7 @@ replicaCount: 1
|
|||||||
image:
|
image:
|
||||||
registry: docker.io
|
registry: docker.io
|
||||||
repository: n8nio/n8n
|
repository: n8nio/n8n
|
||||||
tag: "2.27.3"
|
tag: "2.44.3"
|
||||||
pullPolicy: IfNotPresent
|
pullPolicy: IfNotPresent
|
||||||
|
|
||||||
imagePullSecrets: []
|
imagePullSecrets: []
|
||||||
@@ -64,13 +64,18 @@ ingress:
|
|||||||
# - n8n.local
|
# - n8n.local
|
||||||
|
|
||||||
# Resource limits suitable for Raspberry Pi
|
# Resource limits suitable for Raspberry Pi
|
||||||
|
# n8n 2.23+ requires more memory. Set nodeHeapSizeMb to ~75% of memory limit.
|
||||||
resources:
|
resources:
|
||||||
limits:
|
limits:
|
||||||
cpu: 1000m
|
cpu: 1000m
|
||||||
memory: 512Mi
|
memory: 1Gi
|
||||||
requests:
|
requests:
|
||||||
cpu: 250m
|
cpu: 250m
|
||||||
memory: 256Mi
|
memory: 512Mi
|
||||||
|
|
||||||
|
# Node.js heap size limit (MB). Should be ~75% of resources.limits.memory.
|
||||||
|
# 1Gi limit → 768MB heap leaves headroom for native code and buffers.
|
||||||
|
nodeHeapSizeMb: 768
|
||||||
|
|
||||||
autoscaling:
|
autoscaling:
|
||||||
enabled: false
|
enabled: false
|
||||||
|
|||||||
Reference in New Issue
Block a user