Skip to Content
خط فرمان (CLI)کار با CLI

کار روزمره با CLI

همهٔ دستورهای سرویس، نام کوتاه سرویس (slug) یا شناسه‌اش را می‌گیرند. فهرست سرویس‌ها و نامشان را با gerdoo services ببینید.

استقرار

gerdoo deploy # پوشهٔ فعلی؛ سرویس وصل‌شده را به‌روز می‌کند gerdoo deploy ./apps/api # یک پوشهٔ دیگر gerdoo deploy --name api --project shop --port 8080 gerdoo deploy -y --service api # در CI: بدون سؤال، به سرویس مشخص gerdoo check # فقط بررسی، بدون استقرار

gerdoo deploy تا آماده شدن سرویس صبر می‌کند و اگر ساخت شکست بخورد، گزارش ساخت را نشان می‌دهد. پرچم‌های --framework، --build-command، --start-command، --root-dir، --dockerfile و --build-context همان تنظیمات پنل‌اند و فقط برای ساخت سرویس تازه به کار می‌روند. برای ثابت کردنشان در پروژه از gerdoo.json استفاده کنید.

وضعیت و کنترل

gerdoo services # همهٔ سرویس‌ها و وضعیتشان gerdoo service status api gerdoo service open api # باز کردن آدرس سرویس در مرورگر gerdoo service restart api gerdoo service stop api gerdoo service start api

لاگ

gerdoo logs api # آخرین ۵۰۰ خط gerdoo logs api --since 30m --level error gerdoo logs api --grep "timeout" --tail 2000 gerdoo service builds api # فهرست ساخت‌ها gerdoo service builds api logs <buildId> gerdoo service releases api logs # چرا آخرین استقرار بالا نیامد

متغیرها

سه جای جدا برای متغیر هست (ترتیب اولویت):

# متغیرهای خود سرویس، با امکان محرمانه و زمان ساخت (پیشنهادی) gerdoo service vars api gerdoo service vars api set STRIPE_KEY=sk_live_xxx --secret gerdoo service vars api set NEXT_PUBLIC_API_URL=https://api.example.com --build-time gerdoo service vars api rm OLD_KEY # نقشهٔ سادهٔ env سرویس (بدون محرمانه و زمان ساخت) gerdoo service env api set LOG_LEVEL=debug # متغیرهای یک محیط، برای همهٔ سرویس‌های آن gerdoo project env shop vars production set SENTRY_DSN=https://...

رمزها را همیشه با service vars … --secret تعریف کنید. با هر تغییر، سرویس با مقادیر تازه دوباره مستقر می‌شود.

دامنه

gerdoo service domains api # فهرست و وضعیت gerdoo service domains api add shop.example.com # رکوردهای لازم را نشان می‌دهد gerdoo service domains api verify shop.example.com gerdoo service domains api rm shop.example.com gerdoo service update api --subdomain shop # آدرس shop.gerdoo.app

راهنمای کامل رکوردها در دامنهٔ اختصاصی.

نسخه‌ها و بازگشت

gerdoo service releases api gerdoo service builds api gerdoo service rollback api <buildId>

تغییر تنظیمات سرویس

gerdoo service update api --branch develop --auto-deploy gerdoo service update api --start-command "node dist/server.js" --port 8080 gerdoo service update api --image ghcr.io/acme/api:1.5.0 gerdoo service update api --watch-path "apps/api/**"

اجرای دستور و فایل‌ها

gerdoo service exec api "npx prisma migrate deploy" # حداکثر ۶۰ ثانیه gerdoo service files api /app/uploads # فهرست فایل‌های دیسک gerdoo service pull api /app/uploads/report.pdf -o ./report.pdf gerdoo service push api ./seed.json --dir /app/data

تغییری که با exec روی فایل‌های سرویس می‌دهید (بیرون از دیسک ماندگار) با استقرار یا ری‌استارت بعدی از بین می‌رود.

اپلیکیشن‌ها و محیط‌ها

در CLI به اپلیکیشن «project» می‌گویند.

gerdoo projects gerdoo project create --name shop gerdoo project env shop list gerdoo project env shop create --name staging --type staging --branch develop --auto-deploy gerdoo project delete shop

در اسکریپت‌ها

دستورهای فهرستی --json می‌گیرند و پاسخ خام API را چاپ می‌کنند:

gerdoo services --json | jq -r '.[] | select(.status=="failed") | .slug'

برای CI، ورود در CI را ببینید.

در سایت گردوگردو برای عامل‌های هوشمند و CLI