تنظیمات GitLab Runner
در تنظیمات CI/CD پروژه یا گروه، لیستی به نام Available runners وجود دارد که حاوی GitLab Runnerهای ثبت‌شده است. در این قسمت، با انتخاب گزینه Edit روبروی هر نسخه از GitLab Runner، می‌توانید تنظیمات مربوط به آن را تغییر دهید. به طور مثال با تنظیم tagهای هر GitLab Runner، می‌توانید استفاده پروژه‌ها از آن را مدیریت کنید. برای اطلاعات بیشتر در این زمینه، می‌توانید به قسمت tags در تنظیمات ci مراجعه کنید.
توصیف چرخه CI/CD
با ساخت فایل .gitlab-ci.yml در root هر پروژه، می‌توانید stageهای مورد نظر چرخه CI/CD را توصیف و با هر بار push کردن
کد یا به صورت دستی آن‌ها را اجرا کنید. GitLab Runner در عین سادگی و راحتی، ویژگی‌های منعطف و پیشرفته‌ای از جمله
اعمال محدودیت‌های مختلف بر شرایط اجرای چرخه
،
به‌کارگیری serviceهای آماده حین اجرای چرخه
و
استفاده از متغیرهای محیطی
را فراهم می‌کند. می‌توانید برای آشنایی و بررسی این ویژگی‌ها به
مستندات رسمی
مراجعه کنید. اگر در ساخت و تنظیم چرخه CI/CD خود با چالشی روبرو هستید
یا سوالی برایتان پیش آمده است، لطفا آن را در پشتیبانی هم‌روش با ما در میان بگذارید.
متغیرهای محیطی
می‌توانید از امکان تنظیم و استفاده از متغیرهای محیطی در گیتلب استفاده کنید.
برای این کار، می‌توانید به قسمت Settings => CI/CD => Variables مراجعه کرده و نام و مقدار متغیرهای مورد نظرتان را ثبت کنید.
در فایل .gitlab-ci.yml با فرمت VARIABLE_NAME$ می‌توانید به مقدار متغیرها دسترسی داشته باشید. این امکان به طور ویژه برای مدیریت و استفاده
از مقادیر محرمانه (که نباید در کد قرار داده شوند) مفید است. برای اطلاعات بیشتر، می‌توانید به
قسمت variables از مستندات GitLab
مراجعه کنید.
جزئیات CI/CD پروژه‌ها
در منوی سمت چپ هر پروژه، گزینه‌ای به نام CI/CD وجود دارد که حاوی پاره‌ای از تنظیمات و جزئیات مربوط به چرخه‌ها است. در قسمت Pipelines و Jobs، می‌توانید وضعیت و لاگ‌های چرخه‌ها و جزئیات مربوط به هر stage را مشاهده کنید.
بروز مشکل در اجرای چرخه
در صورتی که مشکلی در اجرا چرخه رخ داده است، می‌توانید به لاگ job مراجعه کرده و علت را بررسی کنید. در صورتی که مشکل ناشی از کد باشد (مثل وجود نقصان در داکرفایل یا شکست‌خوردن تست‌ها)، لازم است اصلاحات مناسب در کد اعمال شود. اگر در حل این دست از خطاها با چالشی روبرو شده‌اید و نیاز به راهنمایی دارید، لطفا آن را در پشتیبانی هم‌روش با ما در میان بگذارید. اگر خطای چرخه مربوط به کد نیست، لطفا ابتدا یک‌بار دکمه‌ی retry را در صفحه‌ی job مربوط بزنید و در صورت بروز دوباره‌ی مشکل، به پشتیبانی هم‌روش اطلاع دهید.
اجرای دستی چرخه
در صورتی که به هر دلیلی چرخه مورد نظر اجرا نمی‌شود و یا تمایل به اجرا چرخه بدون push کردن کد را دارید، می‌توانید این کار را به صورت دستی انجام دهید. در قسمت Pipelines، دکمه‌ی سبز رنگ Run Pipeline را بزنید، برنچ مورد نظر و متغیرهای مورد نیاز را مشخص کنید و سپس چرخه را اجرا کنید. متغیرهای تعریف‌شده در قسمت Variables پروژه به صورت پیش‌فرض به چرخه داده خواهند شد.