راهاندازی سرویس گیتلبرانر
سرویس GitLab Runner با نسخههای مختلف گیتلب از جمله سرویس گیتلب همروش (همگیت) یا گیتلب اختصاصی شرکتها سازگاری دارد و جهت راهاندازی آن، تنها لازم است مراحل زیر را دنبال کنید.
- ریپو
(repository) یا
گروهی از ریپوها
(Group) که تمایل دارید
GitLab Runner
برای آن ثبت شود،
را انتخاب کرده و به قسمت CI/CD تنظیمات آن (در منو سمت چپ صفحه) مراجعه کنید.
در قسمت مربوط به Runners، مطابق با تصویر زیر،
URLوregistration tokenرا شناسایی کنید. در صورتی که از گروه برای دستهبندی ریپوهایتان استفاده میکنید، پیشنهاد میکنیم GitLab Runner را در سطح گروه ثبت کنید تا تمام ریپوهای گروه امکان استفاده از آن را داشتهباشند.
همچنین در صورتی که از گیتلب اختصاصی خودتان در سطح شرکت استفاده میکنید، میتوانید از صفحهی تنظیمات رانرها در ادمین اطلاعات ساخت Shared Runner جدید را مشاهده کنید.
- به صفحه دارکوب در کنسول همروش مراجعه کنید. سپس در قسمت «ساخت اپ»، ذیل «ساخت اپ آماده»، GitLab Runner را انتخاب کنید. در صفحه «تنظیمات اپ»، یک نام برای Runner برگزیده و اطلاعاتی که از مرحله قبل به دست آوردید را وارد کنید.
- در صفحه بعد، پس از انتخاب پلن مورد نظر، گزینه «ساخت اپ» را انتخاب کنید.
حدود یک دقیقه پس از پایان مراحل بالا، نسخه GitLab Runner شما مستقر و آماده استفاده است.
دریافت Registration Token در GitLab برای راهاندازی رانر
برای اتصال GitLab Runner به ریپو یا گروه، نیاز به یک Registration Token دارید. این توکن مشخص میکند رانر برای چه محدودهای (پروژه یا گروه) قابل استفاده باشد.
1. Registration Token در سطح گروه
وقتی رانر را در سطح گروه (Group) ثبت میکنید، تمام پروژههای داخل آن گروه میتوانند از این رانر استفاده کنند. این مورد برای تیمها، سازمانها، یا چند پروژه مرتبط بسیار مناسب است زیرا نیاز به هزینه جداگانه و اضافی برای رانر نیست.
مسیر دسترسی برای گرفتن توکن گروه:
- وارد گروه موردنظر در GitLab شوید.
- از منوی سمت چپ وارد قسمت Build → Runners شوید.
- در قسمت سه نقطه همانطور که در تصویر مشاهده میکنید، registration token خود را کپی کنید.
رانری که با این توکن ثبت شود، جابهای تمام پروژههای داخل این گروه را اجرا میکند.
2. Registration Token در سطح پروژه
اگر Runner را در سطح پروژه (Project) ثبت کنید، فقط همان پروژه میتواند از آن استفاده کند. این نوع رانر برای پروژههای ایزوله که نیاز به منابع اختصاصی دارند، مناسب است.
مسیر دسترسی برای گرفتن توکن پروژه:
- وارد پروژه موردنظر شوید.
- از منوی سمت چپ وارد:
Settings → CI/CD - بخش Runners را باز کنید.
- در قسمت سه نقطه همانطور که در تصویر مشاهده میکنید، registration token خود را کپی کنید.
این Runner فقط جابهای همان پروژه را اجرا میکند و سایر پروژهها به آن دسترسی ندارند.
نکته مهم درباره Deprecated شدن Registration Token
GitLab در حال جایگزینی Registration Token با روشهای جدیدت ر (مانند Runner Authentication Token) است. با این حال، در حال حاضر در دارکوب هنوز از Registration Token استفاده میشود و این روش همچنان عملیاتی است.
در صورت تغییر روش ثبت رانر در آینده، مستندات مربوطه بروزرسانی میشوند.