خطِ فرمان (CLI)

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

نصب#

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

bash

npm install -g github:weblines-cloud/cli
weblines --version

ورود#

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

WEBLINES_TOKEN=$WEBLINES_TOKEN npx github:weblines-cloud/cli deploy my-app

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

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