مشکل SFTP و دیپلوی دستی
کپی کردن فایلها با SFTP همان راهی است که سایتها را نیمهخراب میکند: فایلی جا میماند، وابستگیها نصب نمیشوند و هیچ سابقهای از آنچه منتشر شده باقی نمیماند. با دیپلوی از Git، هر release از یک commit ساخته میشود. یک Dockerfile، فارغ از اینکه چه کسی push کند، همان ایمیج را تولید میکند و پنل نشان میدهد کدام build در حال اجراست.
Dockerfile شما همان build است
فهرست جداگانهای از گامهای build وجود ندارد که لازم باشد با کد همگام نگه دارید. هر کاری که Dockerfile شما انجام میدهد، مانند composer install، npm run build یا کامپایل یک باینری Go، در هر دیپلوی روی دقیقاً همان commitی اجرا میشود که منتشر میشود. buildهای چندمرحلهای، target و build args رعایت میشوند و به حساب رجیستری نیازی ندارید: ایمیج را ما build و نگهداری میکنیم. secretها هرگز به build داده نمیشوند، زیرا آرگومانهای build در داخل ایمیج باقی میمانند.
دیپلوی دستی و دیپلوی خودکار
یک تیم محتاط پس از بازبینی با کلیک روی Build & deploy، یا روی Rebuild برای commit فعلی، دیپلوی میکند. یک تیم پرسرعت مخزن را متصل نگه میدارد تا هر push به برنچ منتشر شود. هر دو همان build را اجرا میکنند؛ تنها تفاوت در چیزی است که آن را آغاز میکند.
مخزنهای خصوصی و توکنها
GitHub App اتصال توصیهشده است: شما انتخاب میکنید کدام مخزنها را ببیند، توکنی برای ساختن یا چرخاندن وجود ندارد و هر زمان میتوانید آن را در GitHub لغو کنید. برای GitLab، یا اگر توکن را ترجیح میدهید، توکن جایگذاریشده فقط برای کلون کردن مخزن استفاده میشود و هرگز دوباره نمایش داده نمیشود. webhookهای push با امضای GitHub یا secret token در GitLab اعتبارسنجی میشوند؛ بنابراین یک درخواست تصادفی نمیتواند دیپلوی را آغاز کند.
Staging پیش از production
یک مخزن متصل میتواند ابتدا روی یک نسخهٔ staging دیپلوی کند. pushها به آدرس آزمایشی میرسند، شما آنها را همانجا بررسی میکنید و Promote آن نسخه را به production میبرد. اگر باز هم یک release مشکل پیدا کرد، از پنل به یک revision قبلی بازگردید.
تحویل تکرارپذیر برای تیمها و آژانسها
وقتی همهٔ پروژهها به یک شیوه دیپلوی میشوند، تحویل کار دیگر به دانستههای ذهنی افراد وابسته نیست. مخزن و برنچ متصل، buildهای اخیر و لاگهایشان در پنل هستند، پس هر کسی میتواند ببیند آخرین push به production رسیده است یا نه. برای آژانسها این یعنی یک مدل تحویل واحد در همهٔ پروژههای مشتریان، بدون هیچ چیز سفارشی که توسعهدهندهٔ بعدی مجبور به مهندسی معکوس آن باشد.
راهنمای گامبهگام deploy
مخزن را متصل کنید
در پنل، Container Apps را باز کنید و Deploy from Git را انتخاب کنید. روی Connect GitHub کلیک کنید تا GitHub App نصب شود و یک مخزن را از فهرست برگزینید، یا URL مخزن را همراه با یک توکن دسترسی جایگذاری کنید: یک توکن fine-grained از GitHub با Contents: Read-only، یا یک توکن GitLab با scope read_repository.
برنچ و فایل compose را انتخاب کنید
برنچی را که باید دیپلوی شود انتخاب کنید و اگر docker-compose.yml شما در ریشه نیست، مسیر آن را وارد کنید. مخزنی که فقط یک Dockerfile دارد بهصورت یک اپلیکیشن واحد روی پورت خط EXPOSE آن دیپلوی میشود، یا اگر این خط وجود نداشته باشد روی 8080.
build و دیپلوی
روی Build & deploy کلیک کنید. ما همان commit را کلون میکنیم، هر ایمیج را در یک builder ایزوله build میکنیم، آن را در رجیستری خصوصی خود نگه میداریم و اپلیکیشنها را، متصل به یکدیگر با نام سرویس، اجرا میکنیم. لاگ build در طول اجرا در پنل دیده میشود و اپلیکیشنهای رو-به-وب در پایان یک آدرس HTTPS میگیرند.
متصل نگه دارید
گزینهٔ Keep connected را علامت بزنید تا هر push به آن برنچ دوباره build و دیپلوی شود. با GitHub App، pushی که webhook آن از دست رفته باشد ظرف پنج دقیقه دریافت میشود.
Staging، Promote، rollback
staging را روشن کنید تا pushها به یک نسخهٔ آزمایشی با آدرس مخصوص خودش بروند؛ production فقط وقتی تغییر میکند که روی Promote کلیک کنید. هر دیپلوی بهعنوان یک revision نگه داشته میشود، پس بازگشت به نسخهٔ قبلی تنها یک اقدام است.
نحوه راهاندازی
راهنماهای گامبهگام در مرکز راهنما:
نمونه سناریوها
یک اپلیکیشن Laravel از Dockerfileی استفاده میکند که cdnctl init مینویسد. یک push به main ایمیج را با composer install میسازد و revision جدید روی Container Apps فعال میشود.
یک آژانس GitHub App را فقط روی یک مخزن مشتری نصب میکند؛ بنابراین کد خصوصی میماند و نیازی به تحویل هیچ توکنی نیست.
یک تیم مخزن را با staging روشن متصل نگه میدارد: هر push به آدرس آزمایشی میرسد و production فقط وقتی تغییر میکند که کسی روی Promote کلیک کند.
پرسشهای پرتکرار
مخزن به چه چیزی نیاز دارد؟
یک Dockerfile، یا یک docker-compose.yml که سرویسهایش یا از یک Dockerfile ساخته میشوند یا از یک ایمیج عمومی استفاده میکنند. سرویسهای دارای بخش build روی زیرساخت ما build میشوند؛ پایگاهدادهها و کشها بهصورت افزونهٔ مدیریتشده متصل میشوند یا بهعنوان اپلیکیشن اجرا میشوند. چیز دیگری لازم نیست: نه حساب رجیستری و نه پیکربندی CI.
در یک push دقیقاً چه اتفاقی میافتد؟
وقتی Keep connected روشن است، webhook مربوط به push اعتبارسنجی میشود، ما همان commit را کلون میکنیم، ایمیجها را build میکنیم و بهعنوان یک revision جدید دیپلوی میکنیم: اگر staging فعال باشد روی staging، وگرنه روی production. پیشرفت کار و لاگ build در پنل نمایش داده میشود.
توکن دسترسی من چگونه محافظت میشود؟
با GitHub App اصلاً توکنی در کار نیست: دسترسی از نصب اپ میآید و به مخزنهایی که انتخاب کردهاید محدود است. یک توکن GitHub یا GitLab جایگذاریشده فقط برای کلون کردن مخزن استفاده میشود و هرگز دوباره نمایش داده نمیشود. به آن دسترسی فقط-خواندنی بدهید و هر زمان خواستید لغوش کنید.
اگر یک دیپلوی خراب شود، میتوانم rollback کنم؟
بله. هر دیپلوی بهعنوان یک revision نگه داشته میشود و بازگشت به یک نسخهٔ قبلی تنها یک اقدام در پنل است. با staging روشن، یک push خراب به production نمیرسد مگر اینکه خودتان آن را Promote کنید.
کدام برنچ منتشر میشود؟
برنچی که متصل میکنید. pushها به برنچهای دیگر دیپلوی نمیشوند، بنابراین کار نیمهتمام تا زمان merge شدن از production دور میماند.
با GitLab هم کار میکند یا فقط با GitHub؟
با هر دو. GitHub هموارترین مسیر را دارد، چون GitHub App مخزنهای شما را فهرست میکند و رویدادهای push را برایتان ارسال میکند. برای GitLab، URL مخزن را با یک توکن read_repository متصل کنید، سپس URL وبهوک و secretی را که پنل پس از نخستین دیپلوی نشان میدهد اضافه کنید؛ GitLab این secret را بهعنوان secret token خود ارسال میکند.
آیا میتوانم یک اپلیکیشن PHP یا Laravel را اینطور دیپلوی کنم؟
بله، PHP روی Container Apps مانند هر stack دیگری اجرا میشود. برای تولید یک Dockerfile، cdnctl init را اجرا کنید؛ برای Laravel این Dockerfile فقط public/ را سرو میکند و درایور MySQL PDO را نصب میکند. APP_KEY و تنظیمات پایگاه داده را بهصورت متغیرهای محیطی تعریف کنید. migrationها در زمان build اجرا نمیشوند، پس آنها را از فرمان شروع یا مرحلهٔ انتشار اپلیکیشن خود اجرا کنید. پلن هاستینگ مدیریتشدهٔ PHP از Git دیپلوی نمیکند؛ کد را از طریق file manager یا cdnctl دریافت میکند.