Резервне копіювання та відновлення n8n: вправа в ізольованому середовищі
Попрактикуйте резервне копіювання й відновлення n8n на SQLite з тією самою версією: перевірте склад екземпляра, облікові дані та файли в ізольованому середовищі.
Перевірено за наведеними джерелами .
Ваше завдання з резервного копіювання та відновлення n8n
Ця редакційна вправа пропонує відпрацювати резервне копіювання та відновлення n8n: відновити зупинений екземпляр в окремому цільовому середовищі, а потім перевірити його склад, збережені тестові облікові дані та потрібні файли. Запропоновану процедуру не виконували й не перевіряли.
У прикладі розглядається самостійно розгорнутий одиночний екземпляр із SQLite та засобами публікації й скасування публікації, задокументованими для n8n 2.0. Команди відновлення PostgreSQL, відновлення черги, налаштування зовнішнього сховища та міграції між версіями виходять за межі цієї вправи. Документація n8n зазначає, що під час запуску застосовуються ще не виконані міграції бази даних; однакові версії — це обмеження нашої вправи, а не гарантія сумісності. Наведена офіційна документація не має дати публікації та відображає її стан на момент перевірки; дати перевірки джерел біля посилань не є датами публікації.
Починайте лише з цільового середовища, яке адміністратор підготував відповідно до наведених нижче вимог. Мережева ізоляція залежить від вашої інфраструктури; її реалізація виходить за межі наданої документації. На нашу думку, практика відновлення найкорисніша, коли ізоляція є передумовою, а не чимось, що учасникам доводиться вигадувати на ходу.
Sources: n8n-docs/docs/deploy/host-n8n/keep-n8n-running/backup-and-restore.md at main · n8n-io/n8n-docs · GitHub, n8n-docs/docs/deploy/host-n8n/configure-n8n/use-the-command-line.md at main · n8n-io/n8n-docs · GitHub, n8n/.agents/skills/db-migrations/SKILL.md at master · n8n-io/n8n · GitHub
Підготуйте тестовий сценарій і перелік складових резервної копії
Перш ніж зупиняти вихідний екземпляр, підготуйте безпечний робочий процес із вузлом HTTP Request, який використовує збережені облікові дані для наданого адміністратором тестового сервісу. Явно виберіть режим автентифікації та облікові дані. Визначте очікувану відповідь і переконайтеся, що запити без автентифікації відхиляються. Це запропоновані вхідні дані для вправи, а не перевірений інструмент тестування.
Зафіксуйте переліки робочих процесів і користувачів, версію n8n, шляхи до сховищ і параметри розгортання. Якщо вправа охоплює дані файлової системи, виберіть відомий файл і зафіксуйте його очікуваний вміст. Скористайтеся наведеним нижче переліком, щоб відрізнити розглянуту резервну копію SQLite від додаткових складових, які можуть знадобитися для вашого розгортання.
| Складова | Що зберегти | Межі вправи |
|---|---|---|
| Папка .n8n | Усю папку, включно з даними SQLite за замовчуванням | Розглянута процедура |
| Ключ шифрування | Початковий файл конфігурації або відповідне значення N8N_ENCRYPTION_KEY | Потрібен для облікових даних |
| Параметри розгортання | Конфігурацію, потрібну для відтворення розгортання | Обов’язкові вхідні дані |
| Додаткове сховище | Налаштовані сховища бінарних даних і даних виконань | Додайте, якщо налаштовано |
| Користувацькі вузли | Потрібні каталоги користувацьких вузлів | Додайте, якщо налаштовано |
| База даних PostgreSQL | Резервну копію бази даних разом з іншими складовими | Поза межами розглянутої процедури |
Документація n8n зазначає, що експорт робочих процесів і облікових даних через CLI не містить користувачів, ролей, історії виконань, змінних і налаштувань екземпляра. Вважайте такий експорт частковим набором даних, а не заміною резервної копії екземпляра.
Sources: n8n-docs/docs/deploy/host-n8n/keep-n8n-running/backup-and-restore.md at main · n8n-io/n8n-docs · GitHub, skills/skills/n8n-credentials-and-security-official/references/HTTP_REQUEST_WITH_AUTH.md at main · n8n-io/skills · GitHub
Створіть копію та відновіть зупинений екземпляр
Дотримуйтеся цієї запропонованої послідовності під час тренування з резервного копіювання та відновлення n8n.
- Зупиніть вихідний екземпляр n8n перед копіюванням SQLite і папки .n8n.
- Скопіюйте всю папку користувача та збережіть дані за зафіксованими додатковими шляхами, каталоги користувацьких вузлів, параметри розгортання й ключ шифрування.
- Відновіть ці складові в зупиненому, заздалегідь ізольованому цільовому середовищі, використовуючи окреме сховище.
- Відновіть конфігурацію розгортання, адаптувавши шляхи й адреси до цільового середовища та зберігши відповідний ключ шифрування.
- Налаштувавши CLI на відновлену цільову базу даних, виконайте n8n unpublish:workflow --all перед запуском цільового екземпляра.
- Запустіть ізольований цільовий екземпляр і перейдіть до вибраних перевірок.
У моделі публікації та скасування публікації n8n 2.0 скасування публікації є додатковим засобом контролю запуску: воно не забезпечує мережевої ізоляції та не перешкоджає навмисному ручному виконанню. Документація CLI також попереджає, що після імпорту раніше активних робочих процесів в екземпляри без multi-main тригери cron можуть працювати до перезапуску, тож деактивація під час імпорту не замінює ізоляції.
Не використовуйте в цій вправі експорт розшифрованих облікових даних: він розкриває секрети у відкритому тексті.
Sources: n8n-docs/docs/deploy/host-n8n/keep-n8n-running/backup-and-restore.md at main · n8n-io/n8n-docs · GitHub, n8n-docs/docs/deploy/host-n8n/configure-n8n/use-the-command-line.md at main · n8n-io/n8n-docs · GitHub
Перевірте відновлення та з’ясуйте причини збоїв
Оцініть відновлений екземпляр за наведеними нижче редакційними критеріями завершення. На нашу думку, самої видимості полотна робочого процесу недостатньо, щоб зупинитися; вправа має вимагати доказів того, що відновленими складовими справді можна користуватися.
Якщо автентифікація не вдається, перевірте початковий ключ шифрування, режим автентифікації HTTP Request, тип облікових даних і вибрані облікові дані. Документація n8n зазначає, що облікові дані можуть ігноруватися, якщо автентифікацію не ввімкнено. Якщо бракує файлів або вузлів, перш ніж змінювати робочий процес, порівняйте відновлені розташування та каталоги користувацьких вузлів із вашим переліком.
Sources: n8n-docs/docs/deploy/host-n8n/keep-n8n-running/backup-and-restore.md at main · n8n-io/n8n-docs · GitHub, skills/skills/n8n-credentials-and-security-official/references/HTTP_REQUEST_WITH_AUTH.md at main · n8n-io/skills · GitHub
Зафіксуйте, що підтверджує тренування
Завершіть вправу з резервного копіювання та відновлення n8n записом про відновлення: ідентифікатор резервної копії, версія вихідного екземпляра, відновлені шляхи, результати перевірок і невирішені збої. Завершення підтверджує лише вибрані перевірки; воно не засвідчує охоплення всіх робочих процесів, облікових даних або зовнішніх залежностей.
Запитання для роздумів: відсутність якої складової завадила б іншому адміністратору повторити відновлення? Корисна відповідь називає цю складову, її місце в процедурі резервного копіювання та спосіб перевірки під час наступного тренування. Оновіть цю процедуру, перш ніж вважати вправу завершеною.
