پرش به مطلب اصلی

اولین استقرار

در این راهنما یک اپلیکیشن Node.js ساده را از صفر تا مرحله انتشار روی ابرکلیک دنبال می‌کنیم. کل فرآیند کمتر از پنج دقیقه طول می‌کشد.

پیش‌نیازها​

▶
ویدیو: اولین استقرار روی ابرکلیکplaceholder — ویدیو را اینجا جایگزین کنید
  • نصب بودن CLI ابرکلیک (abrclick --version را بررسی کنید)
  • حساب کاربری فعال در abrclick.ir
  • Node.js و npm روی سیستم شما
  • یک پروژه Node.js آماده (یا نمونه زیر را دنبال کنید)

اگر هنوز CLI را نصب نکرده‌اید، به صفحه نصب CLI مراجعه کنید.

۱. ورود به حساب کاربری​

abrclick login

مرورگر شما باز می‌شود و پس از تأیید هویت، CLI به حساب‌تان متصل می‌شود. برای اطمینان از اتصال:

abrclick whoami

خروجی نام کاربری و پلن فعال شما را نمایش می‌دهد.

۲. آماده‌سازی پروژه Node.js​

اگر پروژه آماده دارید این مرحله را رد کنید. در غیر این صورت یک نمونه ساده بسازید:

mkdir my-app && cd my-app
npm init -y
npm install express

فایل index.js را با محتوای زیر بسازید:

const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.send('سلام از ابرکلیک!');
});

app.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`);
});

در package.json مطمئن شوید فیلد start تعریف شده باشد:

{
  "scripts": {
    "start": "node index.js"
  }
}
پورت پیش‌فرض

ابرکلیک متغیر محیطی PORT را به‌صورت خودکار تزریق می‌کند. اپلیکیشن شما باید روی این پورت گوش بدهد.

۳. مقداردهی اولیه با abrclick init​

در ریشه پوشه پروژه دستور زیر را اجرا کنید:

abrclick init

CLI یک فرآیند تعاملی را شروع می‌کند:

? پروژه را انتخاب کنید (یا جدید بسازید):
  > ساخت پروژه جدید
    my-existing-project

? نام پروژه جدید: my-first-project

? نام اپلیکیشن: my-app

? runtime شناسایی شد: nodejs — تأیید می‌کنید? (Y/n): Y

? پورت اپلیکیشن: 3000

✓ فایل abrclick.json ساخته شد

پس از اجرا، فایل abrclick.json در ریشه پروژه ایجاد می‌شود:

{
  "project": "my-first-project",
  "app": "my-app",
  "runtime": "nodejs",
  "port": 3000
}

این فایل را می‌توانید به مخزن git اضافه کنید تا سایر اعضای تیم نیز با همین تنظیمات کار کنند.

شناسایی خودکار runtime

ابرکلیک با بررسی فایل‌های موجود (package.json، requirements.txt، go.mod، composer.json و...) runtime مناسب را تشخیص می‌دهد و Dockerfile لازم را به‌صورت خودکار می‌سازد. نیازی به نوشتن Dockerfile نیست — مگر اینکه بخواهید کنترل بیشتری داشته باشید.

۴. استقرار با abrclick deploy​

abrclick deploy

ابرکلیک مراحل زیر را به‌ترتیب انجام می‌دهد و لاگ‌ها را همزمان نمایش می‌دهد:

✓ فایل abrclick.json خوانده شد
✓ سورس کد بسته‌بندی شد (12.4 MB)
✓ آپلود به سرور ... کامل شد
─────────────────────────────────────────
 لاگ‌های Build
─────────────────────────────────────────
[build] Detected runtime: nodejs 20
[build] Running: npm ci
[build] added 57 packages in 4s
[build] Building image...
[build] Pushing to registry...
─────────────────────────────────────────
✓ Build موفق بود
✓ در حال استقرار ...
✓ اپلیکیشن فعال شد

🌐 آدرس اپ:  https://my-app.apps.abrclick.ir

۵. اپلیکیشن شما زنده است​

اپلیکیشن شما روی آدرس زیر در دسترس است:

https://my-app.apps.abrclick.ir

برای بررسی وضعیت:

abrclick apps info

و برای مشاهده لاگ‌های زنده:

abrclick apps logs

استقرارهای بعدی​

برای هر بار که تغییری دادید، کافی است دوباره اجرا کنید:

abrclick deploy

ابرکلیک سورس جدید را آپلود، build می‌کند و بدون downtime (rolling update) اپلیکیشن را به‌روزرسانی می‌کند.

نکات مهم​

پلن رایگان​

پلن ابر (رایگان) یک اپلیکیشن همیشه‌روشن به شما می‌دهد. نیازی به کارت بانکی یا ارتقا پلن نیست — اپ شما بدون محدودیت زمانی فعال می‌ماند.

استقرار در محیط CI/CD​

اگر abrclick deploy را در pipeline اتوماسیون اجرا می‌کنید و نمی‌خواهید منتظر پایان لاگ‌های build بمانید، از فلگ --no-follow استفاده کنید:

abrclick deploy --no-follow
CI/CD

با --no-follow، دستور بلافاصله پس از تأیید آپلود خارج می‌شود و منتظر پایان build نمی‌ماند. این حالت برای GitHub Actions، GitLab CI و سایر سیستم‌های CI مناسب است.

مسیر سورس سفارشی​

اگر کد اصلی در زیرپوشه‌ای قرار دارد:

abrclick deploy --root-dir ./backend

استقرار با image آماده​

اگر image Docker از پیش build شده دارید:

abrclick deploy --image registry.example.com/my-app:v1.2.3

مراحل بعدی​