مهاجرت به n8n مدیریت شده

در این راهنما، جریان‌داده‌ها و Credentialها از یک n8n شخصی صادر و در n8n مدیریت‌شده هم‌روش وارد می‌شوند. این روش حساب‌های کاربران، تاریخچه اجرا، متغیرها و همه تنظیمات سطح Instance را منتقل نمی‌کند؛ این موارد باید جداگانه بررسی شوند.

پیش‌نیازها

• دسترسی owner و ترمینال به n8n مبدا
• یک سرویس فعال n8n مدیریت‌شده و دسترسی ترمینال و مدیریت فایل آن
• یک نسخه پشتیبان کامل از دیتابیس و پوشه داده مبدا
• بررسی سازگاری نسخه‌های n8n مبدا و مقصد و نودهای Community نصب‌شده
• فضای امن و موقت برای نگه‌داری فایل‌های خروجی

قابلیت‌های نسخه Enterprise

• امکان تنظیم متغیرهای محیطی اختصاصی
• امکان استفاده از قابلیت External Secrets
• امکان استفاده از فضای ذخیره‌سازی خارجی برای داده‌های Binary
• امکان دریافت لاگ‌ها از طریق Log streaming
• امکان مدیریت کاربران با ورود یکپارچه (SSO)
• امکان مدیریت نسخه با اتصال به Git

محدوده پشتیبانی سرویس مدیریت‌شده

• مشکلات مربوط به لایسنس و نصب سرویس
• مشکلات مربوط به لود شدن اپلیکیشن
• موارد تحریمی اپلیکیشن
• مشکلات مربوط به اتصال به دیتابیس
• آپدیت‌های امنیتی و به‌روزرسانی‌ها
• تازگی بکاپ‌ها

روش مهاجرت

مهاجرت این راهنما با ابزار خط‌فرمان n8n و از طریق export و import فایل‌های جریان‌داده و Credential انجام می‌شود.

گزینه --decrypted همه رمزها، توکن‌ها و کلیدهای API را به‌صورت متن خوانا داخل credentials.json می‌نویسد. دسترسی فایل محدود، انتقال آن رمزگذاری و فایل بلافاصله پس از واردکردن از مبدا، مقصد و سیستم واسط حذف می‌شود. این فایل نباید در Git، تیکت یا پیام‌رسان قرار گیرد.

گام اول: صادرکردن داده‌ها

از طریق n8n CLI، جریان‌داده‌ها و Credentialها در فایل‌های JSON صادر می‌شوند:

n8n export:workflow --all --output=workflows.json
n8n export:credentials --all --decrypted --output=credentials.json

گام دوم: واردکردن داده‌ها

از طریق مدیریت فایل‌ها در تنظیمات سرویس n8n در کنسول هم‌روش، فایل‌های صادرشده در مسیر /home/node/.n8n/ آپلود می‌شوند. سپس از ترمینال کانتینر، دستورات زیر اجرا می‌شوند:

n8n import:credentials --input=/home/node/.n8n/credentials.json
n8n import:workflow --input=/home/node/.n8n/workflows.json

بررسی نتیجه

پس از Import، تعداد جریان‌داده‌ها و Credentialها با مبدا مقایسه می‌شود. هر Credential با یک درخواست کم‌خطر آزمایش و متغیرها، Webhook URLها، Community Nodeها و دسترسی پروژه‌ها دوباره تنظیم می‌شوند. فایل credentials.json پس از پایان بررسی حذف می‌شود.