مستندات پاستا
Paasta CLI

استقرار از ترمینال، بدون پیش‌نیاز

راهنمای قدم‌به‌قدم نصب، ورود، انتشار پروژه و اتوماسیون؛ مناسب کاربری که فقط می‌خواهد اپ ساخته‌شده را آنلاین کند.

۰۱

شروع سریع

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

۱

CLI را نصب کنید

Linux و macOS:

curl -fsSL https://console.paasta.cloud/install.sh | sh

Windows PowerShell:

irm https://console.paasta.cloud/install.ps1 | iex
برای root مسیر /usr/local/bin/paasta استفاده می‌شود. در Windows، PATH همان لحظه و برای ترمینال‌های بعدی تنظیم می‌شود.
۲

وارد حساب شوید

paasta login

مرورگر باز می‌شود. اگر باز نشد، URL کامل نمایش‌داده‌شده را کپی کنید؛ کد تأیید از قبل داخل لینک است.

۳

پروژه را منتشر کنید

cd YOUR_PROJECT
paasta deploy

نام، پلن، شیوه پرداخت و ناحیه به‌صورت مرحله‌ای پرسیده می‌شود؛ سپس لاگ Build تا آماده‌شدن دامنه نمایش داده می‌شود.

۰۲

ورود امن

مرورگر برای انسان، API Key برای اتوماسیون

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

دستور زیر یک درخواست ده‌دقیقه‌ای می‌سازد. CLI هم مرورگر را باز می‌کند و هم URL کامل را نشان می‌دهد:

paasta login

Copy and open this complete link:
https://console.paasta.cloud/cli/authorize?code=ABCD-2345
  1. لینک را باز کنید.
  2. اگر وارد حساب نیستید، وارد یا ثبت‌نام کنید.
  3. «تأیید و اتصال CLI» را بزنید.
  4. ترمینال خودکار ورود موفق را اعلام می‌کند.

ورود با API Key

برای GitHub Actions، GitLab CI، سرور Build یا هر محیط بدون مرورگر:

paasta login --api-key paasta_YOUR_TOKEN

روش پیشنهادی برای جلوگیری از ثبت Token در history:

export PAASTA_API_KEY='paasta_YOUR_TOKEN'
paasta login --api-key

CLI ابتدا Key را با API اعتبارسنجی و فقط در صورت معتبر بودن با دسترسی فایل 0600 ذخیره می‌کند.

ساخت و مدیریت API Token ←
۰۳

روش‌های استقرار

سورس، Dockerfile، Compose، Image یا Git

پوشه فعلی

paasta deploy

فریم‌ورک، Dockerfile یا compose.yaml خودکار تشخیص داده می‌شود.

پوشه دیگر

paasta deploy ./my-project --name my-app

نام پروژه فقط حروف انگلیسی، عدد و خط تیره دارد.

Docker Image

paasta deploy --image nginx:1.27-alpine --name web --port 80

Image عمومی در Registry پاستا Cache می‌شود.

Git repository

paasta deploy --git https://github.com/acme/app.git --name app --ref main

برای monorepo از --root apps/web استفاده کنید.

استقرار غیرتعاملی

مناسب CI/CD؛ شناسه پلن و ناحیه را با paasta context --json یا paasta plan list پیدا کنید.

paasta deploy . \
  --name my-app \
  --plan PLAN_ID \
  --region CLUSTER_ID \
  --billing payg \
  --yes
۰۴

مرجع دستورها

عملیات روزمره پروژه از یک نقطه

paasta whoamiنمایش حساب، فضای کاری و موجودی
paasta projectsفهرست پروژه‌ها، وضعیت و دامنه
paasta status NAMEجزئیات یک پروژه
paasta logs NAME -fدنبال‌کردن زنده لاگ اجرا
paasta env NAME listفهرست کلیدهای محیطی با مقدار مخفی
paasta env NAME set KEY=VALUEافزودن یا تغییر متغیر محیطی
paasta plan listمشاهده شناسه و قیمت پلن‌ها
paasta plan set NAME PLAN_IDتغییر پلن پروژه
paasta scale NAME 2تغییر تعداد نمونه‌های اجرا
paasta start|stop|restart NAMEکنترل اجرای پروژه
paasta volumesفهرست دیسک‌های پایدار
paasta databasesفهرست دیتابیس‌ها
paasta domains NAMEفهرست دامنه‌های پروژه
paasta topup AMOUNTبازکردن پرداخت افزایش اعتبار
paasta delete NAME --yesحذف کامل پروژه با تأیید صریح

گزینه‌های لاگ

paasta logs my-app --tail 500 --since 7200
paasta logs my-app --follow

--tail تعداد خطوط و --since بازه زمانی برحسب ثانیه است. -f معادل --follow است.

خروجی مناسب اسکریپت

paasta projects --json
paasta volumes --json
paasta databases --json

--json برای پردازش در ابزارهایی مثل jq مناسب است.

۰۵

CI/CD

Deploy امن و بدون مرورگر

GitHub Actions

- name: Deploy to Paasta
  env:
    PAASTA_API_KEY: ${{ secrets.PAASTA_API_KEY }}
  run: |
    curl -fsSL https://console.paasta.cloud/install.sh | sh
    paasta login --api-key
    paasta deploy . --name my-app --plan $PAASTA_PLAN_ID --region $PAASTA_REGION_ID --billing payg --yes

GitLab CI

deploy:
  stage: deploy
  script:
    - curl -fsSL https://console.paasta.cloud/install.sh | sh
    - paasta login --api-key
    - paasta deploy . --name my-app --plan $PAASTA_PLAN_ID --region $PAASTA_REGION_ID --billing payg --yes
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
۰۶

رفع اشکال سریع

پیام‌های رایج و راه‌حل مستقیم

paasta: command not found

در نصب root فایل باید در /usr/local/bin/paasta باشد. برای نصب محلی، ترمینال تازه باز کنید یا مسیر کاملی که نصب‌کننده در خط «Run now» نشان داده اجرا کنید.

مرورگر باز نشد

URL کامل /cli/authorize?code=... را از ترمینال کپی و در هر مرورگری باز کنید. کد جداگانه هم برای بررسی نمایش داده می‌شود.

API Key پذیرفته نشد

انقضا، لغوشدن Token و scopeها را در API Token بررسی کنید. برای Deploy دسترسی deployments:write لازم است.

Build شکست خورد

خروجی همان Build در ترمینال نمایش داده می‌شود. سپس با paasta logs PROJECT لاگ Runtime را بررسی کنید.