رفتن به محتوا
nsin docs

Commands

command bar در NSIN CLOUD هر خطی را که تایپ کنید به یک اقدام روی app یا دیتابیس تبدیل می‌کند. پشت آن هیچ هوش مصنوعی‌ای نیست: مجموعه‌ای کوچک از الگوها با چیزی که تایپ می‌کنید match می‌شود، و هر کدام دقیقاً به یک REST call نگاشت می‌شوند — همان callای که toolهای MCP هم می‌زنند.

  • ⌘K یا Ctrl K نوار را از هر جای پنل باز می‌کند.
  • Tab دستوری را که شروع کرده‌اید تایپ کردن کامل می‌کند.
  • ? همین صفحه را در یک تب تازه باز می‌کند.

در syntaxهای زیر، هرچه بین < > بیاید یک آرگومان اجباری است و هرچه بین [ ] بیاید اختیاری. Tab آرگومان‌های اجباری را پر می‌کند و همان‌جا متوقف می‌شود — یک آرگومان اختیاری فقط همان چیزی است که خودتان تایپ کرده‌اید.

در هر دستوری که با یک نام شروع می‌شود، نام می‌تواند اول بیاید یا آخر — هم shop logs کار می‌کند هم logs shop. جدول زیر شکل نام‌اول را نشان می‌دهد.

در جدول، <app> نام یک app است. هر جا ردیف بگوید، نام یک دیتابیس هم کار می‌کند. <db> فقط نام یک دیتابیس است.

وقتی یک نام را تایپ می‌کنید، نوار فقط دستورهایی را پیشنهاد می‌دهد که آن نام دارد. scale، restart و redeploy فقط برای appها هستند. اگر با نام یک دیتابیس تایپ شوند، یک خطا نشان می‌دهند و چیزی ارسال نمی‌کنند.

اولین الگویی که با یک خط match شود برنده است.

حذف یک app یا دیتابیس یک دستور نیست. اقدام‌های مخرب در صفحه‌ی Settings همان resource هستند، پشت یک confirmation dialog.

دستورمثالچه کاری می‌کندREST call
deploy <image|git-url> as <name> [port N]deploy nginx:alpine as demo port 80app را از یک container image یا یک git repository می‌سازد و اولین build آن را شروع می‌کند. پیش‌فرض port برای imageهای nginx برابر 80 است و برای بقیه 3000.POST /v1/{project}/apps
<app> logsshop logsلاگ زنده‌ی یک app را باز می‌کند — یا یک دیتابیس را، وقتی نام همان باشد.چیزی ارسال نمی‌شود — یک صفحه باز می‌شود
<app> metricsshop metricsنمودارهای CPU، memory، شبکه و restart یک app را باز می‌کند — یا یک دیتابیس را، وقتی نام همان باشد.چیزی ارسال نمی‌شود — یک صفحه باز می‌شود
<app> terminalshop terminalیک shell داخل یک pod در حال اجرای app یا دیتابیس را باز می‌کند. “shell” هم کار می‌کند.چیزی ارسال نمی‌شود — یک صفحه باز می‌شود
<app> diskshop diskدیسک‌های یک app یا یک دیتابیس را باز می‌کند. “disks” هم کار می‌کند.چیزی ارسال نمی‌شود — یک صفحه باز می‌شود
<app> settingsshop settingsتنظیمات یک app یا یک دیتابیس را باز می‌کند.چیزی ارسال نمی‌شود — یک صفحه باز می‌شود
<app> billingshop billingهزینه‌ای را که یک app یا یک دیتابیس تا حالا داشته باز می‌کند. “cost” هم کار می‌کند.چیزی ارسال نمی‌شود — یک صفحه باز می‌شود
<db> backupspg backupsbackupهای یک دیتابیس را باز می‌کند. “backup” هم کار می‌کند.چیزی ارسال نمی‌شود — یک صفحه باز می‌شود
<db> eventspg eventsتاریخچه‌ی eventهای یک دیتابیس را باز می‌کند.چیزی ارسال نمی‌شود — یک صفحه باز می‌شود
<app> scale <replicas>shop scale 2تعداد replicaهای در حال اجرای app را تنظیم می‌کند.POST /v1/{project}/apps/:app/scale
<app> restartshop restartpodهای app را roll می‌کند، همان imageای که deploy شده را نگه می‌دارد.POST /v1/{project}/apps/:app/restart
<app> redeployshop redeployapp را دوباره از source فعلی‌اش build و deploy می‌کند. تنها “deploy” هم کار می‌کند.POST /v1/{project}/apps/:app/deploy
<app> openshop openoverview یک app یا یک دیتابیس را باز می‌کند. “go” هم همین کار را می‌کند، و فقط نام هم جستجو می‌کند.چیزی ارسال نمی‌شود — یک صفحه باز می‌شود
db <name> <engine> [version]db pg postgres 16یک دیتابیس managed می‌سازد. بدون version، همان نسخه‌ی پیش‌فرض آن engine را می‌گیرید.POST /v1/{project}/databases
link <db> to <app>link pg to shopمتغیرهای اتصال دیتابیس را به environment آن app تزریق می‌کند.POST /v1/{project}/databases/:db/link
helphelpهمین صفحه را در یک تب تازه باز می‌کند. ”?” هم کار می‌کند.چیزی ارسال نمی‌شود — یک صفحه باز می‌شود

<engine> یکی از این‌هاست: postgres، pgvector، mysql، mariadb، redis، mongodb، clickhouse، elasticsearch، meilisearch.

هر متنی که تایپ کنید و یکی از دستورهای بالا نباشد، یک جستجوست. نوار آن را با نام appها و دیتابیس‌های شما (و همچنین status و source آن‌ها) match می‌کند، نتایج را زیر Recent فهرست می‌کند، و Enter موردی را که highlight شده باز می‌کند. این یک فیلتر local روی فهرست‌هایی است که پنل از قبل دارد — تا وقتی تایپ می‌کنید هیچ requestای ارسال نمی‌شود.

کلیدهای arrow در فهرست حرکت می‌کنند، Enter باز می‌کند، Escape می‌بندد.

پشت هر دستور اینجا یک tool در MCP و یک endpoint در REST هم هست — همان call، از هر راهی که آن را اجرا کنید. NSIN CLOUD سرور MCP خودش را روی https://api.nsincloud.ir/mcp اجرا می‌کند، به همان شکلی که MCP server انسین کار می‌کند، و REST API آن از همان قراردادها پیروی می‌کند: یک API key به‌صورت Authorization: Bearer یا X-Api-Key.