Weblines Cloudمستندات

خطِ فرمان (CLI)

با دستورِ weblines از ترمینال وارد شوید، دیپلوی کنید، لاگ را دنبال کنید و متغیرها را تنظیم کنید؛ در CI هم با کلیدِ API.

آخرین به‌روزرسانی:

weblines ابزارِ خطِ فرمانِ وب‌لاینز است. همان کارهای کنسول را از ترمینال انجام می‌دهد: دیپلوی با دیدنِ لاگِ build تا پایان، لاگِ زنده، متغیرهای محیطی و روشن/خاموش کردن. کدِ آن در github.com/weblines-cloud/cli است.

نصب#

به Node.js نسخه‌ی ۱۸.۱۷ یا جدیدتر نیاز دارد:

bash
npm install -g weblines
weblines --version

اگر npm ِ شما روی یک آینه‌ی داخلی تنظیم است و پکیج را پیدا نمی‌کند، --registry=https://registry.npmjs.org را اضافه کنید، یا مستقیم از GitHub نصب کنید:

bash
npm install -g https://codeload.github.com/weblines-cloud/cli/tar.gz/v0.1.1

ورود#

bash
weblines login

مرورگر باز می‌شود و صفحه‌ی تأییدِ کنسول را نشان می‌دهد؛ دسترسی‌ها را ببینید و APPROVE بزنید. کلیدی کپی نمی‌شود. ورود در ~/.config/weblines/config.json ذخیره می‌شود و فقط برای کاربرِ خودتان خواندنی است. برای خروج و باطل کردنِ ورود: weblines logout. اتصال‌های فعال را در Settings → API keys → Connected apps هم می‌بینید.

دیپلوی از پوشه‌ی پروژه#

bash
cd my-app
weblines link my-app     # یک بار؛ فایلِ .weblines.json ساخته می‌شود
weblines deploy          # دیپلوی و نمایشِ لاگِ build تا پایان
weblines logs -f         # دنبال کردنِ لاگِ اجرا

weblines deploy اگر دیپلوی شکست بخورد با کدِ خروجِ 1 تمام می‌شود. --force بدونِ cache می‌سازد و --no-wait منتظرِ پایان نمی‌ماند.

دستورها#

دستورکار
weblines psفهرستِ سرویس‌ها
weblines status [سرویس]وضعیت و آدرس
weblines link <سرویس>سرویسِ پیش‌فرضِ این پوشه
weblines deploy [سرویس]دیپلوی و دنبال کردنِ لاگِ build
weblines logs [سرویس]لاگِ اجرا؛ -f برای دنبال کردن، -n 100|500|2000
weblines env ls [سرویس]نامِ متغیرها؛ مقدارها هیچ‌وقت نمایش داده نمی‌شوند
weblines env set [سرویس] KEY=value …افزودن یا تغییرِ متغیر؛ بعد deploy کنید
weblines env unset KEY [سرویس]حذفِ متغیر
weblines start|stop|restart [سرویس]روشن، خاموش، ری‌استارت
weblines open [سرویس]آدرسِ وبِ سرویس

اگر نامِ سرویس را ندهید، سرویسِ لینک‌شده‌ی همان پوشه (یا --app) استفاده می‌شود.

در CI#

روی سرورِ CI وارد نشوید. یک کلیدِ API با دسترسیِ read و deploy بسازید، به‌عنوانِ secret ذخیره کنید و در WEBLINES_TOKEN بگذارید:

bash
npm install -g https://codeload.github.com/weblines-cloud/cli/tar.gz/v0.1.1
weblines deploy my-app

نمونه‌های آماده برای GitHub Actions، GitLab و همگیت: دیپلوی از CI.

محدودیت‌های نسخه‌ی اول#

  • مقدارِ متغیرها خوانده نمی‌شود، پس env pull نداریم.
  • ترمینالِ کانتینر (ssh) و شِلِ دیتابیس فعلاً فقط در کنسول هستند.
  • حذفِ سرویس از CLI ممکن نیست.

جوابت را پیدا نکردی؟

تیکت از پنل یا تماس در ساعاتِ کاری: ۰۲۱-۸۸۷۱۷۴۵۱

ثبتِ تیکت