پیش از شروع
- این راهنما را با یک پروژه آزمایشی یا منبعی که مجاز به تغییر آن هستید دنبال کنید.
- هزینه و اثر حذف یا جایگزینی داده در مرحله تأیید نهایی دوباره نمایش داده میشود.
- پس از هر تغییر، نتیجه مورد انتظار همان مرحله را در وضعیت پروژه، رخدادها یا گزارش فعالیت بررسی کنید.
استک تشخیص داده نمیشود
ZIP را باز کنید و مطمئن شوید manifest اصلی، Dockerfile یا compose.yaml داخل آن است. فایل پروژه نباید یک ZIP دیگر داخل ZIP باشد.
Build وابستگی یا Image پایه شکست میخورد
در Python، requirements.txt یا pyproject.toml باید همه وابستگیهای مستقیم را داشته باشد؛ Build استاندارد چند import رایج و بدون ابهام مانند requests، dotenv و yaml را در فایلهای تودرتو هم بررسی و در صورت جاافتادن نصب میکند، اما سورس یا manifest شما را تغییر نمیدهد. lockfile و نسخه runtime را بررسی کنید. خط اول خطای واقعی را در جزئیات Build پیدا کنید. Imageهای Docker Hub و docker.n8n.io در ناحیه ایران خودکار از cache داخلی و mirror داخلی کشور دریافت میشوند؛ cache پروژه نیز در Build بعدی استفاده میشود.
اپ پس از Build بالا نمیآید
صفحه استقرار خطاهایی مانند OOMKilled، CrashLoopBackOff، ErrImagePull، مشکل Permission، دیتابیس، پورت و Health Check را تشخیص میدهد و چکلیست مرتبط نشان میدهد. خطای موقت Pull تا دو دقیقه و Crash اولیه تا سه Restart فرصت بازیابی خودکار دارد؛ سپس در صورت ادامه مشکل، Retry مرحله اجرا بدون تکرار Build نمایش داده میشود.
Health Check ناموفق است
مسیر باید بدون احراز هویت پاسخ 2xx/3xx بدهد. اگر برنامه مسیر سلامت ندارد، فیلد را خالی بگذارید تا TCP بررسی شود.
دامنه شخصی تأیید نمیشود
رکورد TXT را دقیقاً روی نام نمایشدادهشده بسازید، تا انتشار DNS صبر کنید و دوباره تأیید را بزنید. سپس وضعیت صدور TLS را بررسی کنید.