عیب‌یابی بیلد
پیدا کردن مرحلهٔ خطا، خواندن لاگ و رفع مشکلات رایج بیلد و دیپلوی.
اول از کجا شروع کنم؟
- وضعیت پروژه را در صفحهٔ پروژه ببینید.
- به تب پایپ‌لاین‌ها بروید و آخرین پایپلاین را باز کنید.
- مرحلهٔ ناموفق را پیدا کنید: کپی کردن، بیلد، پوش یا دیپلوی.
- لاگ همان مرحله را بخوانید.
- در صورت نیاز، از از AI بپرس برای توضیح خطا استفاده کنید.
خطاهای رایج
| نشانه | علت احتمالی | راه‌حل |
|---|---|---|
| بیلد موفق است ولی سایت بالا نمی‌آید | برنامه روی پورت دیگری گوش می‌دهد | پورت را در تنظیمات → عمومی با پورت واقعی برنامه هماهنگ کنید |
| خطای نبود Dockerfile یا فایل اصلی | مسیر فایل اشتباه است | مسیر را در تنظیمات → عمومی اصلاح کنید |
| خطای نصب پکیج npm با 404 | پکیج در رجیستری فعلی نیست | در Build & CD رجیستری npm را عوض کنید و دوباره بیلد بگیرید |
| قطعی یا خطای رجیستری npm | مشکل موقت رجیستری | رجیستری دیگری انتخاب کنید یا بیلد را دوباره اجرا کنید |
| خطای 403 هنگام کشیدن ایمیج | مشکل موقت رجیستری Docker | یک بار تلاش دوباره بزنید؛ اگر تکرار شد با پشتیبانی تماس بگیرید |
| خطای حافظه یا منابع در بیلد | بیلد سنگین یا وابستگی زیاد | وابستگی‌های غیرضروری را حذف کنید؛ اگر ادامه داشت تیکت بزنید |
| خطای متغیر محیطی | نقل‌قول دوتایی یا بک‌اسلش پایانی | مقدار را در متغیرهای محیطی (ENV) اصلاح کنید |
| وضعیت عدم موجودی کافی | موجودی حساب کم است | حساب را شارژ کنید |
تلاش دوباره، اجرا یا رول بک؟
- تلاش دوباره: همان پایپلاین و همان کامیت را دوباره اجرا می‌کند. برای خطاهای موقت مناسب است.
- اجرای پایپلاین: یک پایپلاین جدید با آخرین کد می‌سازد.
- رول بک: کد یک پایپلاین قبلی را دوباره دیپلوی می‌کند. متغیرها و تنظیمات برنمی‌گردند.
خطای مرحلهٔ Clone
اگر دریافت کد از ریپازیتوری طول کشید یا قطع شد:
- اتصال حساب گیت را بررسی کنید.
- دسترسی مخزن و نام شاخه را کنترل کنید.
- یک بار دیگر تلاش دوباره بزنید.
- اگر تکرار شد، با پشتیبانی تماس بگیرید.
خطای مرحلهٔ Build
- لاگ پکیج یا دستور ناموفق را بخوانید.
- وابستگی‌ها و نسخه‌ها را در ریپازیتوری اصلاح کنید و push کنید.
- برای پروژه‌های Node، وضعیت رجیستری npm را بررسی کنید.
- اگر خطا به شبکه یا رجیستری مربوط است و با تغییر رجیستری حل نشد، تیکت بزنید.
خطای مرحلهٔ Push یا Deploy
این خطاها معمولاً به زیرساخت مربوط‌اند:
- یک بار تلاش دوباره بزنید.
- اگر تکرار شد، با پشتیبانی تماس بگیرید و شناسهٔ پایپلاین و متن خطا را بفرستید.
برنامه اجرا می‌شود ولی خطا می‌دهد
- تب لاگ‌ها را ببینید.
- با کنسول اتصال و تنظیمات برنامه را بررسی کنید.
- درستی پورت و آدرس وضع حال پروژه را کنترل کنید.
- متغیرهای محیطی و اتصال دیتابیس را بررسی کنید.
هنگام تماس با پشتیبانی
این اطلاعات را آماده کنید:
- نام و شناسهٔ پروژه
- شناسه یا زمان پایپلاین
- نام مرحلهٔ ناموفق
- متن خطا یا بخش مهم لاگ
رمزها و مقادیر حساس متغیرها را در تیکت ننویسید.