# دستورالعمل نگهداری n8n: پشتیبان، بازیابی، ارتقا (درس AUT-204-L01)

## ۱. چه چیزهایی پشتیبان می‌خواهند
| چه | چطور | کجا نگه داشته شود |
|---|---|---|
| پایگاه داده (ورک‌فلوها، Credentialهای رمزنگاری‌شده، اجراها) | `pg_dump` در `backup.sh` | پوشه پشتیبان + یک نسخه بیرون از سرور |
| ورک‌فلوها به‌صورت فایل خوانا | `export:workflow --backup` | Git (برای دیدن تغییرات) |
| Credentialها (رمزنگاری‌شده) | `export:credentials --all --separate` | کنار پشتیبان پایگاه داده |
| **کلید رمزنگاری** | فایل `secrets/n8n_encryption_key.txt` | **جدا** از پشتیبان‌ها، در مدیر راز یا گاوصندوق رمزنگاری‌شده |
| `.env` و `compose.yaml` و `Caddyfile` | Git (بدون راز) | مخزن |

قاعده: پشتیبان بدون کلید = Credentialهای بی‌استفاده. کلید کنار پشتیبان در یک جای عمومی = همه Credentialها لو رفته.

## ۲. زمان‌بندی
- روزانه: `backup.sh` (مثلاً با cron در ساعت کم‌کار) و نگهداری ۱۴ نسخه آخر.
- هفتگی: یک نسخه بیرون از سرور (سرور دیگر یا ذخیره‌ساز دیگر).
- ماهانه: **آزمون بازیابی** (بخش ۳). پشتیبانی که بازیابی‌اش آزموده نشده، پشتیبان نیست.

## ۳. آزمون بازیابی (روی سرور یا پوشه جدا، نه روی تولید)
1. یک پوشه تازه با همان `compose.yaml`، همان نسخه n8n و **همان کلید رمزنگاری**.
2. `docker compose up -d postgres` و سپس `pg_restore -U n8n -d n8n --clean < n8n-db.dump` (از راه `docker compose exec -T postgres`).
3. `docker compose up -d` و ورود به ویرایشگر.
4. بررسی: تعداد ورک‌فلوها برابر است؛ یک Credential را باز کن (اگر کلید غلط باشد، خطای «Credentials could not be decrypted» می‌گیری)؛ یک ورک‌فلو آزمایشی را دستی اجرا کن.
5. نتیجه و زمان بازیابی را ثبت کن.

## ۴. ارتقا
1. یادداشت‌های انتشار و تغییرات ناسازگار نسخه مقصد را بخوان (به‌خصوص اگر نسخه اصلی عوض می‌شود).
2. `backup.sh` و بررسی SHA256SUMS.
3. در `.env` فقط `N8N_VERSION` را عوض کن (نه `latest`).
4. `docker compose pull` و سپس `docker compose up -d`.
5. بررسی: `/healthz/readiness` پاسخ 200؛ لاگ n8n بدون خطای migration؛ اجرای دستی یک ورک‌فلو آزمایشی؛ اولین اجرای زمان‌بندی‌شده را ببین.
6. ثبت نسخه قبلی و تازه و تاریخ.

## ۵. برگشت (rollback)
- اگر پس از ارتقا خراب شد: نسخه قبلی را در `.env` بگذار **و** پایگاه داده را از پشتیبان پیش از ارتقا بازیابی کن. پایگاه داده‌ای که migration نسخه تازه رویش اجرا شده ممکن است با نسخه قبلی سازگار نباشد؛ فقط عوض‌کردن برچسب image کافی نیست.
- اجراهایی که بین ارتقا و برگشت انجام شده‌اند در پشتیبان قبلی نیستند؛ فهرستشان را از لاگ دربیاور.
