نصب و ورود با CLI

CLI ابران با نام abrun در terminal اجرا می‌شود و برای مدیریت پروژه‌ها، Appها، استقرارها و دیتابیس‌ها استفاده می‌شود.

پیش‌نیازها

• نسخه پشتیبانی‌شده Node.js و npm
• حساب فعال ابران

نصب

پکیج رسمی CLI را به‌صورت global نصب کنید:

npm install -g @abruncloud/cli

نصب را بررسی کنید:

abrun --help

اگر command پیدا نشد، مسیر global binaryهای npm را به PATH اضافه و terminal را دوباره باز کنید.

ورود با مرورگر

روش پیشنهادی برای سیستم شخصی، تأیید ورود در مرورگر است:

abrun login --browser

CLI صفحه تأیید را باز می‌کند و تا پذیرش درخواست منتظر می‌ماند. سپس هویت ذخیره‌شده را بررسی کنید:

abrun whoami

برای ورود مستقیم و تعاملی با ایمیل و رمز عبور می‌توانید abrun login را اجرا کنید. رمز عبور را در history شل یا فایل‌های script قرار ندهید.

انتخاب پروژه

بیشتر عملیات منابع به یک پروژه نیاز دارند:

abrun project list
abrun project use <project>
abrun project current

انتخاب پروژه برای login فعلی ذخیره می‌شود. برای override کردن آن در فقط یک دستور:

abrun --project <project> apps

استفاده در CI

برای automation از API token استفاده کنید و آن را در secret store سیستم CI نگه دارید:

ABRUN_TOKEN=<token> abrun --project <project> apps

token را داخل repository، Docker image یا خروجی build ثبت نکنید. برای خروجی قابل‌پردازش نیز از --json یا --output json استفاده کنید:

abrun --project <project> --json apps

برای ساخت، انقضا، rotation و محدودیت scope فعلی، راهنمای API token و امنیت حساب را بخوانید.

عملیات رایج

• abrun apps — فهرست Appهای پروژه
• abrun deploy <app> — استقرار منبع پوشه فعلی
• abrun app logs <app> --follow — دنبال‌کردن لاگ runtime
• abrun app events <app> --watch — دنبال‌کردن رویدادهای عملیاتی App
• abrun dbs — فهرست دیتابیس‌های پروژه
• abrun --help — فهرست همه commandها

برای انتخاب درست میان خروجی deployment، runtime log، event، metric و request Analytics، راهنمای مانیتورینگ برنامه را ببینید.

خروج و پاک‌کردن session

برای حذف login فعلی از سیستم محلی:

abrun logout

برای حذف همه loginهای ذخیره‌شده از abrun logout --all استفاده کنید.

قدم بعدی

اولین برنامه را مستقر کنید، فهرست کامل commandهای CLI را ببینید یا برای شناخت مرز پروژه و منابع، مفاهیم اصلی را بخوانید.