n8n

برنامه n8n یک ابزار قدرتمند برای خودکارسازی گردش‌های کاری (Workflow Automation) است که امکان اتصال سرویس‌ها و انتقال داده‌ها را بدون نیاز به کدنویسی فراهم می‌کند. در پلتفرم ابری پارس‌پک، این سیستم برای تضمین پایداری و مدیریت بهینه بار پردازشی، در قالب یک معماری کانتینری دوگانه (شامل هسته اصلی و Worker/Runner) مستقر می‌شود تا اجرای هم‌زمان صدها تسک بدون ایجاد گلوگاه پردازشی تضمین گردد.

مراحل استقرار

برای مشاهده راهنمای گام‌به‌گام ساخت سرویس و پیکربندی‌های پایه، به مستندات «استقرار برنامه‌های آماده» مراجعه کنید. همچنین برای تنظیمات زیرساختی نیز به بخش مدیریت اپلیکیشن مراجعه کنید:

پیش‌نیازها و استقرار برنامه

در استقرار کانتینری n8n، معماری سیستم دارای الزامات و حساسیت‌های زیر است که باید در زمان دیپلوی به آن‌ها توجه کنید:

  • ساختار دوگانه (Dual Architecture): این برنامه از دو کانتینر مجزای n8n (هسته اصلی مدیریت و رابط کاربری) و n8n_runner (اجراکننده وظایف در پس‌زمینه) تشکیل شده است. توقف کانتینر رانر باعث متوقف شدن اجرای اتوماسیون‌های شما خواهد شد.

  • سطح دسترسی سیستمی: برای حفظ امنیت زیرساخت، کانتینرها و ترمینال این برنامه با دسترسی کاربر عادی (Non-Root) اجرا می‌شوند؛ لذا امکان تغییرات در سطح ریشه سیستم‌عامل کانتینر وجود ندارد.

  • تخصیص منابع تفکیک‌شده: پلتفرم به شما اجازه می‌دهد منابع را به صورت کاملا مستقل مدیریت کنید. رم و پردازنده کانتینر اصلی (n8n) را برای مدیریت رابط کاربری و رم و پردازنده کانتینر n8n_runner را متناسب با حجم و تعداد Taskهای هم‌زمان خود مقیاس‌دهی کنید.

  • محدودیت فضای ذخیره‌سازی دیسک: اطلاعات ساختاری، کلیدهای اتصال (Credentials) و لاگ گردش‌های کاری بر روی دیسک کانتینر اصلی (n8n) ذخیره می‌شود. کاهش فضای ذخیره‌سازی (Scale Down) پس از استقرار، ریسک قطعی از دست رفتن همیشگی داده‌ها را به همراه دارد. حتما کلید بکاپ خودکار را روشن بگذارید.

متغیرهای محیطی

در بخش پارامترهای اختیاری داشبورد، امکان تعیین دقیق نسخه‌ها برای هر دو کانتینر به صورت مجزا وجود دارد:

  • N8N Image: تعیین نسخه ایمیج هسته اصلی.

  • N8N Runner Image: تعیین نسخه ایمیج رانر (اجراکننده کارها).

نکته: برای آموزش گام‌به‌گام نحوه تعریف متغیرهای اختصاصی، ConfigMapها و Secretها در داشبورد، به مستندات متغیرهای محیطی مراجعه کنید.

تنظیمات دامنه

پلتفرم n8n برای دریافت اطلاعات از سایر اپلیکیشن‌ها به تولید آدرس‌های Webhook متکی است. اگر دامنه اختصاصی تنظیم نشود، این آدرس‌ها به درستی کار نخواهند کرد. پیش از ساختن اولین جریان کاری (Workflow)، حتما دامنه یا ساب‌دامین اختصاصی خود را متصل کنید. جهت انجام این کار به راهنمای تنظیمات دامنه و IP مراجعه نمایید.

راه‌اندازی و ورود به پنل مدیریت

پس از پر شدن نوار پیشرفت استقرار و فعال شدن وضعیت سرویس‌ها در داشبورد، باید اکانت مالک (Owner) را بسازید:

  1. بر روی آدرس سایت خود (ساب‌دامین ابری یا دامنه اختصاصی متصل‌شده) کلیک کنید تا در مرورگر باز شود.
  2. در اولین ورود، صفحه راه‌اندازی (Set up owner account) به شما نمایش داده می‌شود.
  3. اطلاعات امنیتی خود شامل ایمیل، نام کاربری و یک رمز عبور قدرتمند را وارد کرده و اکانت را ایجاد کنید.
    • این اطلاعات در دیتابیس داخلی کانتینر ذخیره می‌شود؛ حتما آن‌ها را به خاطر بسپارید.

  4. پس از تکمیل ثبت‌نام، مستقیما وارد محیط بوم طراحی (Canvas) شده و می‌توانید ساخت اتوماسیون‌های خود را آغاز کنید.