در این مقاله
مهاجرت به n8n 3.0 را با تغییر برچسب ایمیج شروع نکنید. ابتدا گردش‌کارها، داده پایدار، Credentialها و روش بازیابی را بررسی کنید. در زمان تهیه این راهنما، ۳۱ اکتبر ۲۰۲۶، نسخه جدید بتا است؛ انتشار پایدار برای اوایل دسامبر برنامهریزی شده و هنوز نباید آن را انتخاب پیش‌فرض یک سامانه عملیاتی حساس دانست. هدف این مقاله ساختن مسیر آزمایش است، نه تشویق به ارتقای فوری.
سناریوی ما یک گردشکار پشتیبانی است: Webhook پیام ساختگی می‌گیرد، از مدل متنی پاسخ پیشنهادی می‌خواهد و نتیجه را برای بازبینی ذخیره می‌کند. این گردشکار پرداخت نمی‌کند، سفارش تغییر نمی‌دهد و به مشتری واقعی پیام نمی‌فرستد. همین مرز اجازه می‌دهد تفاوت نسخه‌ها را بدون مخلوط‌کردن آزمون با عملیات کسب‌وکار ببینیم.
نسخه جدید چه تغییری می‌دهد و چه وعده‌ای نمی‌دهد؟
طبق اعلام رسمی n8n 3.0، تمرکز این انتشار روی پایداری، امنیت و حذف مسیرهای قدیمی است. تغییر نسخه اصلی به معنی وجود تغییرات ناسازگار است؛ پس «همان گردشکار قبلی بالا آمد» معیار کافی نیست. بعضی نودها، تنظیمات و رفتارهای اجرا باید پیش از انتقال بررسی شوند. معرفی قابلیت‌های AI دیگر n8n را هم نباید خودکار به این انتشار نسبت داد.
سه وضعیت را جدا ثبت کنید: نسخه نصب‌شده اکنون، نسخه آزمایشی مقصد و نسخه‌ای که برای انتشار اصلی تأیید می‌کنید. از برچسب متغیر برای محیط کنترل‌شده استفاده نکنید. تاریخ بررسی و لینک یادداشت انتشار را کنار گزارش بنویسید تا هنگام انتشار نسخه پایدار، معلوم باشد کدام نتیجه هنوز معتبر است و چه چیزی دوباره باید آزموده شود.
موجودی فعلی را پیش از تغییر بنویسید
فهرست گردش‌کارهای فعال، Triggerها، اتصال‌های بیرونی، وابستگی به فایل و محل ذخیره خروجی را تهیه کنید. برای هر مورد، مالک کسب‌وکار و پیامد توقف را بنویسید. یک کار شبانه که فقط گزارش داخلی می‌سازد با Webhook ثبت سفارش اهمیت یکسان ندارد. ترتیب آزمایش را بر همین اساس انتخاب کنید، نه بر اساس کوتاه‌بودن نام گردشکار.
مقدار کلید و رمز را در این فهرست ننویسید؛ فقط نام Credential، مسئول نگهداری و روش جایگزینی آن لازم است. متغیرهای محیط، نسخه دیتابیس و قرارداد شبکه هم باید شناخته شوند. برای مدل اجرایی چندپردازشی، راهنمای Queue Mode در n8n را کنار این فهرست بگذارید. تفاوت نقش نمونه اصلی و Worker در زمان ارتقا اهمیت عملی دارد.
Migration Report را در هر دو سطح بررسی کنید
راهنمای سازنده، Migration Report را در نسخه 2.39 و جدیدتر معرفی می‌کند. ابتدا آخرین مسیر مناسب نسخه ۲ را با یادداشت انتشار خودش بررسی کنید، سپس از Settings وارد گزارش شوید. یافتههای گردشکار و یافتههای تنظیمات نمونه دو فهرست جدا هستند. سبزشدن یکی به معنی رفع دیگری نیست و پنهان‌بودن یک مورد به معنی بی‌اهمیت‌بودن آن نیست.
اصلاح خودکار را مانند تغییر کد بازبینی کنید. تفاوت ورودی، خروجی، شرایط شاخه‌ها و نام فیلدها را ثبت کنید و نسخه اصلاح‌شده را با داده ثابت اجرا کنید. گزارش رسمی می‌گوید بعضی اصلاح‌ها نسخه جدید گردشکار می‌سازند؛ بنابراین وجود اصلاح پیشنهادی را با انتشار آن اشتباه نگیرید. برای جزئیات مسیر تصمیم، راهنمای آمادگی n8n 3.0 مرجع تکمیلی است.
بکاپ قابل بازیابی از چه اجزایی تشکیل می‌شود؟
فایل خروجی یک گردشکار به‌تنهایی بکاپ کامل نمونه نیست. دیتابیس، داده باینری پایدار، تنظیمات و مرجع امن کلید رمزگذاری Credentialها باید در برنامه بازیابی دیده شوند. کپی‌کردن داده در حالی که چند جزء هم‌زمان تغییر می‌کنند ممکن است مجموعه ناسازگار بسازد. روش سازگار با دیتابیس و شیوه استقرار خودتان را انتخاب کنید و زمان مرجع نسخه پشتیبان را ثبت کنید.
بازیابی را در نمونه جدا انجام دهید و فقط مشاهده فایل بکاپ را موفقیت ندانید. ورود، نمایش گردشکار، خواندن Credential آزمایشی و یک اجرای بدون اثر بیرونی باید کار کنند. کلید رمزگذاری را در مخزن کد، پیام‌رسان یا خروجی لاگ نگذارید. اگر مسئولیت تهیه یا بازیابی بکاپ بین تیم شما و میزبان تقسیم شده، همین تقسیم را پیش از شروع به‌صورت روشن تأیید کنید.
نظرات کاربران (۰)
هنوز نظری ثبت نشده است. اولین نفر باشید.