گیتلبرانر ابزاری برای اجرای جابهای CI/CD در گیتلبهای cloud و self-hosted است. سرویس گیتلبرانر همروش را میتوانید در نسخههای مختلف گیتلب از جمله نسخه اصلی (Gitlab) ، سرویس گیتلب همروش (همگیت) و گیتلب اختصاصی شرکتتان استفاده کنید. برای راهاندازی آن، تنها لازم است نوع رانر را انتخاب کنید، توکن آن را در گیتلب به دست بیاورید، و سپس رانر اختصاصی خود را با این توکن در دارکوب بسازید.
۱. مشخص کردن نوع رانر
رانرهای گیتلب میتوانند منحصر به یک پروژه خاص، یک گروه از ریپوها، یا قابل استفاده در کل گیتلب باشند.
در سطح گروه
وقتی رانر را در سطح گروه (Group) ثبت میکنید، تمام پروژههای داخل آن گروه میتوانند از این رانر استفاده کنند. این مورد برای تیمها، سازمانها، یا چند پروژه مرتبط بسیار مناسب است زیرا نیاز به هزینه جداگانه و اضافی برای رانر نیست. این روش برای کسانی که از گیتلب اصلی یا سرویس همگیت همروش استفاده میکنند، بهترین راه است.
برای ایجاد توکن رانر در سطح گروه:
- وارد Group موردنظر در گیتلب شوید.
- از منوی سمت چپ وارد قسمت Build → Runners شوید.
- در قسمت بالا سمت راست، روی گزینه Create group runner کلیک کنید.
در سطح پروژه
اگر Runner را در سطح پروژه (Project) ثبت کنید، فقط همان پروژه میتواند از آن استفاده کند و و سایر پروژهها به آن دسترسی ندارند. این نوع رانر برای پروژههای ایزوله که نیاز به منابع اختصاصی دارند یا به دلایل امنیتی ترجیح میدهند جدا از بقیه رانرها باشند، مناسب است.
برای ایجاد توکن رانر در سطح پروژه:
- وارد پروژه موردنظر شوید.
- از منوی سمت چپ وارد قسمت Settings → CI/CD شوید.
- در صفحه جدید، بخش Runners را باز کنید.
- روی گزینه Create Project Runner کلیک کنید.
در سطح کل گیتلب
این روش مناسب سازمانهایی است که گیتلب اختصاصی خود را دارند و میخواهند بدون نیاز به جدا کردن گروهها، با یک رانر همه جابها در انواع گروهها و پروژهها اجرا شوند. به این نوع رانر، Instance Runner گفته میشود.
برای ایجاد رانر در سطح کل گیتلب:
- با دسترسی ادمین وارد گیتلب شوید.
- روی گزینه Admin در کنار عکس پروفایل خود کلیک کنید.
- از منوی سمت چپ وارد قسمت CI/CD → Runners شوید.
- در قسمت بالا سمت راست، روی گزینه Create instance runner کلیک کنید.
۲. به دست آوردن توکن رانر
پس از طی کردن مراحل گ فته شده در مرحله قبل، وارد صفحه ساخت رانر در گیتلب میشوید.
- اگر در جابهای خود از تگ استفاده میکنید، لازم است تگهای مورد نظر را در بخش Tags وارد کنید. در غیر اینصورت، گزینه Run untagged jobs را انتخاب کنید تا همه جابها توسط رانر قابل اجرا باشند.
- در بخش Configuration میتوانید برخی تنظیمات پیشرفتهتر نیز اضافه کنید: مانند محدود کردن رانر به برنچهای Protected یا مشخص کردن تایماوت برای جابها. اگر چنین نیازی ندارید، از این بخش عبور کنید.
- روی Create runner کلیک کنید تا رانر ساخته شود.
- در صفحه جدید، به قسمت Step 1 رفته و مشابه عکس، توکن نمایش داده شده را کپی کنید.
۳. ساخت رانر اختصاصی در همروش
- رو ی گزینه بالا کلیک کنید. همچنین میتوانید به صفحه دارکوب در کنسول همروش مراجعه کرده، سپس وارد قسمت «ساخت اپ» شده و در بخش «برنامههای آماده»، GitLab Runner را انتخاب کنید.
- در صفحه «تنظیمات اپ»، یک نام برای رانر انتخاب کنید.
- نوع گیتلب خود را مشخص کنید و اگر گیتلب اختصاصی دارید، آدرس آن را با https وارد نمایید.
- توکنی که در مرحله قبل به دست آوردید را وارد کنید و و گزینه «انتخاب پلن» را بزنید.
- در صفحه بعد پس از انتخاب پلن مورد نظر، گزینه «ساخت اپ» را انتخاب کنید.
۴. حذف رانر اشتراکی از لیست رانرها در همگیت
اگر از همگیت استفاده میکنید، احتمالاً رانر اشتراکی همگیت بهصورت پیشفرض برای پروژه شما فعال است.
در این حالت، رانر اشتراکی و رانر اختصاصیتان همزمان فعالند و گیتلب جابها را بین آنها توزیع میکند. نتیجه این است که بعضی از جابها روی رانر اشتراکی اجرا میشوند و ممکن است سرعت یا کیفیت متفاوتی داشته باشند.
رانر اشتراکی همگیت را غیرفعال کنید تا تمام جابها فقط روی رانر اختصاصیتان اجرا شوند.
برای غیرفعال کردن رانر اشتراکی برای گروه یا پروژه:
- وارد پروژه یا گروه شوید.
- از منوی سمت چپ وارد قسمت Settings → CI/CD شوید.
- در صفحه جدید، بخش Runners را باز کنید.
- برای گروه، گزینه Enable instance runners for this group را غیرفعال کنید. برای پروژه، در قسمت Instance runners، گزینه Turn on instance runners for this project را غیرفعال کنید.
به این ترتیب، جابها فقط توسط رانر اختصاصیتان اجرا خواهند شد.