اتصال به GitLab

اتصال GitLab به تسکیـ کاری می‌کند که پروژه‌های کد شما و وظیفه‌ها کنار هم پیش بروند. وقتی یک پروژهٔ GitLab به فضای کاری وصل باشد، مرج‌ریکوئست‌ها، شاخه‌ها، کامیت‌ها و ایشوهایی که به شناسهٔ وظیفه اشاره می‌کنند خودکار به همان وظیفه لینک می‌شوند و می‌توانید وضعیت وظیفه را هم از دل کار توسعه جلو ببرید. هم GitLab ابری (gitlab.com) و هم نمونهٔ خودمیزبان پشتیبانی می‌شود.

مثل GitHub، این اتصال دو حالت دارد: اتصال فضای کاری که مدیر فضای کاری برقرار می‌کند و لینک‌شدن خودکار و به‌روزرسانی وضعیت روی آن انجام می‌شود، و اتصال شخصی که هر عضو برای حساب خودش می‌سازد.

پیش از شروع

• فقط مالک یا مدیر فضای کاری می‌تواند اتصال فضای کاری به GitLab بسازد.
• به یک «توکن دسترسی شخصی» (Personal Access Token) در GitLab نیاز دارید که اجازهٔ خواندن پروژه و ساخت وب‌هوک را داشته باشد.
• تعداد یکپارچه‌سازی‌های فضای کاری بسته به پلن ممکن است محدود باشد؛ اتصال‌های شخصی محدودیتی ندارند.
• اتصال به پروژه، دسترسی به کد شما را به کاربران تسکیـ نمی‌دهد.

اتصال فضای کاری

اتصال فضای کاری از «مرکز اپ‌ها» یا تب «یکپارچه‌سازی» در تنظیمات فضای کاری انجام می‌شود. برای GitLab یک توکن دسترسی می‌دهید و در صورت خودمیزبان‌بودن، نشانی سرور خودتان را وارد می‌کنید.

1. در GitLab یک «توکن دسترسی شخصی» با دامنهٔ لازم برای خواندن پروژه‌ها و مدیریت وب‌هوک بسازید و آن را کپی کنید.
2. در تسکیـ از «مرکز اپ‌ها» گزینهٔ GitLab را انتخاب کنید و تب «فضای کاری» را باز کنید.
3. اگر از GitLab ابری استفاده می‌کنید، نشانی سرور را خالی بگذارید تا gitlab.com در نظر گرفته شود؛ برای نمونهٔ خودمیزبان، نشانی کامل سرور را وارد کنید.
4. توکن دسترسی را بچسبانید و در صورت تمایل یک برچسب برای این اتصال بنویسید.
5. پروژه‌هایی را که می‌خواهید همگام شوند انتخاب کنید و اتصال را ذخیره کنید. تسکیـ برای هر پروژه به‌صورت خودکار وب‌هوک لازم را می‌سازد.

نکته: برای اینکه همهٔ پروژه‌ها درست دیده شوند، بهتر است دسترسی توکن را در سطح خودِ پروژه‌ها تنظیم کنید. اگر پروژه‌ای را نمی‌بینید، اعتبار توکن و دسترسی آن به پروژه را بررسی کنید.

GitLab خودمیزبان و دسترسی شبکه

اگر سرور GitLab شما پشت فایروال است یا فقط از آی‌پی‌های مشخص ورودی می‌پذیرد، باید اجازهٔ دسترسی سرویس تسکیـ به سرور را در فایروال بدهید تا وب‌هوک‌ها و فراخوانی‌ها برقرار شوند. اگر نشانی سرور از اینترنت عمومی قابل‌دسترسی نباشد یا به آی‌پی خصوصی اشاره کند، اتصال برقرار نمی‌شود. برای گرفتن نشانی‌های مجاز که باید در فایروال آزاد شوند، با پشتیبانی هماهنگ کنید.

اتصال شخصی

هر عضو می‌تواند از «مرکز اپ‌ها» یک اتصال شخصی به GitLab بسازد تا کارهای خودش را ساده‌تر به وظیفه‌ها ربط دهد. داده‌های حساب شخصی شما در اختیار دیگران قرار نمی‌گیرد.

لینک‌کردن وظیفه به فعالیت GitLab

لینک خودکار با شناسهٔ وظیفه

شناسهٔ وظیفه را جایی در کار GitLab بنویسید تا وظیفه خودکار به آن مرج‌ریکوئست، شاخه، کامیت یا ایشو لینک شود. شناسه را می‌توانید در نام شاخه، پیام کامیت، عنوان مرج‌ریکوئست یا توضیحات مرج‌ریکوئست بنویسید. سه شکل پذیرفته می‌شود:

• TASK-12 — نوشتن مستقیم شناسه.
• #TASK-12 — با پیشوند #.
• CU-TASK-12 — با پیشوند CU-.

برای نمونه، شاخهٔ feature/TASK-12 یا مرج‌ریکوئستی با عنوان «TASK-12 اصلاح ورود» خودکار به وظیفهٔ TASK-12 لینک می‌شود.

لینک دستی با چسباندن نشانی

در صفحهٔ وظیفه بخش «لینک‌های گیت» را باز کنید، نشانی یک مرج‌ریکوئست، ایشو یا کامیت GitLab را بچسبانید و «افزودن» را بزنید. لینک‌ها همان‌جا فهرست می‌شوند و قابل حذف‌اند.

به‌روزرسانی خودکار وضعیت وظیفه

• مرج مرج‌ریکوئست: وقتی مرج‌ریکوئستِ لینک‌شده به یک وظیفه مرج شود، آن وظیفه خودکار «انجام‌شده» می‌شود.
• تعیین وضعیت دلخواه: اگر شناسه را به شکل TASK-12[نام وضعیت] بنویسید، وظیفه به همان وضعیت منتقل می‌شود؛ مثلاً TASK-12[Done].

مهم: بین شناسه و کروشهٔ وضعیت فاصله نگذارید و نام داخل کروشه را دقیقاً برابر نام یکی از وضعیت‌های همان پروژه بگذارید؛ در غیر این صورت وظیفه فقط لینک می‌شود و وضعیتش تغییر نمی‌کند. لینک خودکار و به‌روزرسانی وضعیت را مدیر می‌تواند برای هر اتصال روشن یا خاموش کند.

اعلان رویدادهای مهم

برخی رویدادها مثل شکست پایپ‌لاین روی کار لینک‌شده یا ثبت ایشوی تازه، برای افراد مرتبطِ وظیفه اعلان می‌فرستند. راه‌های دریافت این اعلان‌ها را می‌توانید در تنظیم اعلان‌ها و یادآورها مشخص کنید.

مدیریت و قطع اتصال

وضعیت اتصال، پروژه‌های همگام‌شده و زمان آخرین رویداد در تب «یکپارچه‌سازی» تنظیمات فضای کاری دیده می‌شود. فقط مالک یا مدیر می‌تواند اتصال فضای کاری را قطع کند؛ با قطع اتصال، وب‌هوک‌های ساخته‌شده حذف و دریافت رویدادها متوقف می‌شود، اما لینک‌های گیت موجود روی وظیفه‌ها باقی می‌مانند.

اشتباه‌های رایج

• توکن دسترسی بدون دامنهٔ کافی؛ اگر همگام‌سازی پروژه یا ساخت وب‌هوک انجام نشد، سطح دسترسی توکن را بررسی کنید.
• وارد نکردن نشانی درست سرور خودمیزبان یا مسدودبودن دسترسی در فایروال؛ سرور باید از بیرون قابل‌دسترسی باشد.
• نوشتن شناسه با فاصله پیش از کروشهٔ وضعیت؛ شکل درست TASK-12[Done] است.
• استفاده از نام وضعیتی که در پروژه وجود ندارد.

گام بعدی: اگر از GitHub هم استفاده می‌کنید، اتصال به GitHub را ببینید؛ و برای دسترسی برنامه‌نویسی و توکن‌ها، دسترسی برنامه‌نویسی و توکن‌ها را مرور کنید.