Technical Tutorials

در منظره سریع در حال تحول یکپارچه‌سازی برنامه‌ها، توسعه‌دهندگان به طور فزاینده‌ای به دنبال راه‌حل‌هایی هستند که انعطاف‌پذیری کد را با دسترسی‌پذیری سازندگان بصری ارائه دهند. در حالی که ابزارهایی مانند Zapier و Make بازار مصرف‌کننده را در اختیار دارند، آن‌ها اغلب از مدل‌های قیمت‌گذاری سخت‌گیرانه و عدم شفافیت رنج می‌برند. Activepieces وارد میدان می‌شود؛ یک پلتفرم اتوماسیون گردش کار قدرتمند و متن‌باز که شکاف بین سادگی بدون کد و قابلیت گسترش در سطح توسعه‌دهنده را پر می‌کند. این پست بررسی می‌کند که چگونه می‌توان از Activepieces برای وظایف پیچیده اتوماسیون استفاده کرد، با تمرکز بر معماری، پیاده‌سازی عملی و قابلیت گسترش آن.

چرا Activepieces متمایز است

Activepieces با مجوز «fair-code» طراحی شده است که به سازمان‌ها امکان می‌دهد پلتفرم را میزبانی داخلی (Self-host) کنند بدون اینکه نگران قفل شدن در اکوسیستم ارائه‌دهنده (Vendor lock-in) باشند. معماری اصلی آن بر پایه یک موتور بسیار ماژولار ساخته شده است که در آن هر بخش از منطق—چه تریگر (Trigger) باشد و چه اقدام (Action)—در یک واحد قابل استفاده مجدد به نام «Piece» بسته‌بندی شده است. این ماژولار بودن برای توسعه‌دهندگان حیاتی است، زیرا به این معنی است که شما فقط یک سرویس را پیکربندی نمی‌کنید؛ بلکه با بلوک‌های ترکیب‌پذیر کار می‌کنید که قابل بازرسی، اصلاح یا جایگزینی هستند.

برخلاف ابزارهای سنتی ETL، Activepieces یک ویرایشگر بصری ارائه می‌دهد که تعاریف JSON قابل اجرا را تولید می‌کند. این بدان معناست که گردش کارهای شما به عنوان کد در نظر گرفته می‌شوند، در مخزن Git شما قابل کنترل نسخه هستند و می‌توان آن‌ها را از طریق پایپ‌لاین‌های CI/CD مستقر کرد. این رویکرد کاملاً با اصول زیرساخت به عنوان کد (IaC) همسو است و آن را برای تیم‌هایی که تکرارپذیری و قابلیت حسابرسی را ارزشمند می‌دانند، ایده‌آل می‌سازد.

راه‌اندازی محیط

برای توسعه‌دهندگانی که رویکرد عملی را ترجیح می‌دهند، استقرار Activepieces به صورت محلی یا روی یک سرور خصوصی به دلیل پشتیبانی از Docker ساده است. روش توصیه شده استفاده از Docker Compose است که وابستگی‌های اجزای سرور، کارگر (Worker) و پایگاه داده را مدیریت می‌کند.

در اینجا یک پیکربندی استاندارد docker-compose.yml برای راه‌اندازی سرویس اصلی آورده شده است:

version: '3.8'
services:
  activepieces:
    image: ghcr.io/activepieces/activepieces:latest
    environment:
      - AP_ENGINE_EXECUTABLE_PATH=${AP_ENGINE_EXECUTABLE_PATH:-./dist/main.js}
      - AP_ENCRYPTION_KEY=${AP_ENCRYPTION_KEY}
      - AP_JWT_SECRET=${AP_JWT_SECRET}
      - AP_DB_TYPE=${AP_DB_TYPE:-POSTGRES}
      - AP_POSTGRES_DATABASE=${AP_POSTGRES_DATABASE:-activepieces}
      - AP_POSTGRES_HOST=${AP_POSTGRES_HOST:-db}
      - AP_POSTGRES_PORT=${AP_POSTGRES_PORT:-5432}
      - AP_POSTGRES_USERNAME=${AP_POSTGRES_USERNAME:-postgres}
      - AP_POSTGRES_PASSWORD=${AP_POSTGRES_PASSWORD:-password}
      - AP_TRIGGER_ENABLED=${AP_TRIGGER_ENABLED:-false}
      - AP_TELEMETRY_ENABLED=${AP_TELEMETRY_ENABLED:-false}
    depends_on:
      - db
  db:
    image: postgres:15-alpine
    environment:
      - POSTGRES_DB=${AP_POSTGRES_DATABASE:-activepieces}
      - POSTGRES_USER=${AP_POSTGRES_USERNAME:-postgres}
      - POSTGRES_PASSWORD=${AP_POSTGRES_PASSWORD:-password}
    volumes:
      - postgres_data:/var/lib/postgresql/data
volumes:
  postgres_data:

پس از بالا آمدن کانتینرها، می‌توانید به رابط کاربری در آدرس http://localhost:80 دسترسی پیدا کنید. جادوگر راه‌اندازی اولیه شما را در پیکربندی اتصال پایگاه داده و ایجاد اولین کاربر مدیر راهنمایی خواهد کرد.

ساخت گردش‌های کار پیچیده با مراحل کدنویسی

در حالی که سازنده بصری بسیاری از موارد استفاده رایج را پوشش می‌دهد، توسعه‌دهندگان پیشرفته از مرحله «Code» قدردانی خواهند کرد. این امکان را به شما می‌دهد تا منطق سفارشی JavaScript یا TypeScript را مستقیماً در گردش کار خود تزریق کنید و محدودیت‌های نودهای استاندارد را دور بزنید. این موضوع به ویژه برای تبدیل داده‌ها، منطق شرطی پیچیده یا تعامل با APIهایی که قطعات از پیش ساخته شده ندارند، مفید است.

برای مثال، اگر نیاز داشته باشید داده‌ها را از یک API شخص ثالث دریافت کنید، پاسخ JSON را تبدیل کنید و سپس آن را به پایگاه داده ارسال کنید، می‌توانید یک اسکریپت مختصر بنویسید:

// مثال مرحله کد
const axios = require('axios');

async function main({ step, $ }) {
  const response = await axios.get('https://api.example.com/data');
  
  // تبدیل داده‌ها
  const transformedData = response.data.map(item => ({
    id: item.uuid,
    name: item.title.toUpperCase(),
    timestamp: new Date().toISOString()
  }));
  
  return transformedData;
}

این قطعه کد نشان می‌دهد که Activepieces چگونه با کتابخانه‌های استاندارد Node.js یکپارچه می‌شود و به شما قدرت کامل اکوسیستم JavaScript را در یک زمینه گردش کار بصری می‌دهد. خروجی این مرحله کد می‌تواند سپس مستقیماً به نودهای بعدی، مانند «ارسال ایمیل» یا «درج در پایگاه داده» ارسال شود و ایمنی نوع و یکپارچگی داده‌ها را حفظ کند.

نتیجه‌گیری

Activepieces نشان‌دهنده تغییر قابل توجهی در نحوه رویکرد توسعه‌دهندگان به اتوماسیون گردش کار است. با ترکیب سادگی توسعه بصری با قدرت معماری متن‌باز و اجرای کد سفارشی، به تیم‌ها امکان می‌دهد پایپ‌لاین‌های یکپارچه‌سازی مقیاس‌پذیر، قابل نگهداری و مقرون‌به‌صرفه بسازند. چه در حال خودکارسازی فرآیندهای داخلی DevOps باشید و چه در حال ساخت یکپارچه‌سازی‌های面向 مشتری، Activepieces ابزارهای لازم برای انجام این کار با دقت و کنترل را فراهم می‌کند. با رشد مداوم اکوسیستم «Pieces»، پتانسیل آن برای جایگزینی گزینه‌های SaaS مالکیتی روز به روز جذاب‌تر می‌شود.