پیش‌نیازهای این آموزش
- به فایل‌های منبع پروژه و روش ساخت آن دسترسی داشته باشید.
Paastafileاختیاری است؛ بدون آن نیز تشخیص خودکار منبع انجام می‌شود.
آموزش مرحله‌به‌مرحله
- فایلی بدون پسوند با نام دقیق
Paastafileدر ریشه برنامه بسازید. - تنظیمات ساخت و اجرا را با پورت و فرمان واقعی پروژه هماهنگ کنید.
- رمز و مقدار متغیر محرمانه را داخل فایل ننویسید؛ آن‌ها را در کنسول ثبت کنید.
- فایل را همراه منبع ارسال کنید یا در مخزن ثبت کنید و نسخه تازه بسازید.
- تنظیمات تشخیص‌داده‌شده و لاگ نسخه جدید را بررسی کنید؛ نام قدیمی
paasta.yamlنیز پشتیبانی می‌شود.
توضیحات تکمیلی
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: /healthGitOps چگونه اعمال می‌شود
پس از اتصال Git و فعال‌کردن Auto Deploy، هر Push یک Build تغییرناپذیر می‌سازد و Paastafile همان commit را دوباره می‌خواند. تغییر مسیر Build یا فرمان‌های runtime همراه کد منتشر می‌شود. پلن، پرداخت، تعداد نمونه، دیتابیس و دیسک عمداً بیرون فایل باقی می‌مانند تا تغییر کد باعث خرید یا حذف ناخواسته منابع نشود.
نتیجه را چگونه بررسی کنید؟
نسخه جدید با تنظیمات فایل همان منبع ساخته می‌شود؛ تغییر فایل به‌تنهایی نسخه فعال را تغییر نمی‌دهد.
اگر به مشکل خوردید
- در پروژه چندپوشه‌ای، ریشه برنامه انتخاب‌شده باید با جای فایل هماهنگ باشد.
- تورفتگی
YAMLو نام کلیدها را بررسی کنید؛ از نمونه کامل بخش مرجع همین راهنما استفاده کنید.