Paastafile چیست و چه کاری انجام می‌دهد؟

پیش از شروع

• این راهنما را با یک پروژه آزمایشی یا منبعی که مجاز به تغییر آن هستید دنبال کنید.
• هزینه و اثر حذف یا جایگزینی داده در مرحله تأیید نهایی دوباره نمایش داده می‌شود.
• پس از هر تغییر، نتیجه مورد انتظار همان مرحله را در وضعیت پروژه، رخدادها یا گزارش فعالیت بررسی کنید.

Paastafile دقیقاً چیست؟

Paastafile یک فایل اختیاری با محتوای YAML است که فقط روش Build و اجرای کد را ثابت می‌کند. اگر آن را نسازید، پاستا تنظیمات را از Dockerfile، Compose یا فریم‌ورک تشخیص می‌دهد. نام قدیمی paasta.yaml همچنان پشتیبانی می‌شود.

فایل را در مخزن قرار دهید

یک فایل بدون پسوند با نام دقیق Paastafile در ریشه مخزن بسازید و version را برابر 1 قرار دهید. پاستا هنگام بررسی پروژه وجود فایل را نشان می‌دهد و همان تنظیمات را در استقرار اولیه و همه Pushهای بعدی می‌خواند.

مسیر Build را برای monorepo مشخص کنید

در build.root مسیر نسبی اپلیکیشن مانند apps/web را بنویسید. اگر Dockerfile نام یا مسیر دیگری دارد، build.dockerfile را نسبت به همان پوشه مشخص کنید. مسیر مطلق و خروج از پوشه مخزن پذیرفته نمی‌شود.

اجرای سرویس را تعریف کنید

در runtime می‌توانید port، startCommand، releaseCommand و healthPath را تعیین کنید. releaseCommand پیش از انتشار نسخه جدید و با همان Image، Secretها و دیسک‌های پروژه اجرا می‌شود؛ اگر شکست بخورد نسخه فعال قبلی باقی می‌ماند.

نمونه کامل

version: 1
build:
  root: apps/web
  dockerfile: Dockerfile
runtime:
  port: 3000
  startCommand: npm start
  releaseCommand: npm run migrate
  healthPath: /health

GitOps چگونه اعمال می‌شود

پس از اتصال Git و فعال‌کردن Auto Deploy، هر Push یک Build تغییرناپذیر می‌سازد و Paastafile همان commit را دوباره می‌خواند. تغییر مسیر Build یا فرمان‌های runtime همراه کد منتشر می‌شود. پلن، پرداخت، تعداد نمونه، دیتابیس و دیسک عمداً بیرون فایل باقی می‌مانند تا تغییر کد باعث خرید یا حذف ناخواسته منابع نشود.