چطور Monorepo را روی سکوی ابری گردو دیپلوی کنیم؟

یک مخزن می‌تواند چند سرویس گردو داشته باشد. هر سرویس «دستور ساخت»، «دستور اجرا»، متغیرها، دامنه، تعداد نمونه و نسخه‌های انتشار مستقل دارد، اما می‌تواند در همان پروژه و محیط کنار بقیه سرویس‌ها قرار بگیرد.

repo/
├── apps/
│   ├── web/       # سرویس وب
│   └── api/       # سرویس API
├── packages/
│   └── shared/    # بسته مشترک
├── package.json
└── pnpm-lock.yaml

اگر برنامه برای ساخت به lockfile یا بسته‌های بیرون از پوشه خودش نیاز دارد، Dockerfile را در پوشه برنامه نگه دارید ولی «زمینهٔ ساخت» را ریشه مخزن قرار دهید.

# فیلدهای «پیکربندی ساخت» در پنل گردو
پوشهٔ ریشه:       apps/api
مسیر Dockerfile:  apps/api/Dockerfile
زمینهٔ ساخت:       .
مسیرهای تحت نظر:
  apps/api/**
  packages/shared/**
  pnpm-lock.yaml

در Dockerfile، مسیرهای COPY نسبت به «زمینهٔ ساخت» هستند. اگر Dockerfile ندارید، گردو Nixpacks یا سازنده داخلی استک را روی «پوشهٔ ریشه» اجرا می‌کند و «زمینهٔ ساخت» سفارشی را نادیده می‌گیرد؛ بنابراین پروژه‌ای که به فایل‌های ریشه وابسته است معمولاً به Dockerfile با زمینه ریشه نیاز دارد.

برای source محلی، CLI کل repository داده‌شده را بسته‌بندی می‌کند و تشخیص را روی --root-dir انجام می‌دهد:

cd repo
gerdoo deploy . \
  --name api \
  --root-dir apps/api \
  --dockerfile apps/api/Dockerfile \
  --build-context . \
  --port 8080

برای یک سرویس Git موجود، تنظیمات Monorepo و watch path را می‌توانید به‌روزرسانی کنید:

gerdoo service update api \
  --root-dir apps/api \
  --dockerfile apps/api/Dockerfile \
  --build-context . \
  --watch-path 'apps/api/**' \
  --watch-path 'packages/shared/**' \
  --watch-path pnpm-lock.yaml