اتصال به GitHub

اگر تیم شما کد را روی GitHub نگه می‌دارد، اتصال GitHub به تسکیـ کمک می‌کند کارِ توسعه و وظیفه‌ها کنار هم دیده شوند. وقتی یک مخزن به فضای کاری وصل باشد، پول‌ریکوئست‌ها، شاخه‌ها، کامیت‌ها و ایشوهایی که به شناسهٔ وظیفه اشاره می‌کنند خودکار به همان وظیفه لینک می‌شوند و می‌توانید وضعیت وظیفه را هم از دل همان کار توسعه جلو ببرید.

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

پیش از شروع

• فقط مالک یا مدیر فضای کاری می‌تواند اتصال فضای کاری به GitHub بسازد.
• برای نصب اپ روی مخزن، باید روی آن مخزن در GitHub دسترسی مدیر داشته باشید.
• تعداد یکپارچه‌سازی‌های فضای کاری بسته به پلن ممکن است محدود باشد؛ اتصال‌های شخصی شمارش نمی‌شوند و محدودیتی ندارند.
• اتصال به مخزن، دسترسی به کد شما را به کاربران تسکیـ نمی‌دهد؛ فقط رویدادهای مرتبط (مثل باز/مرج‌شدن پول‌ریکوئست) دریافت می‌شود.

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

اتصال فضای کاری از راه «مرکز اپ‌ها» (App Center) یا تب «یکپارچه‌سازی» در تنظیمات فضای کاری برقرار می‌شود. تسکیـ برای GitHub از یک GitHub App استفاده می‌کند؛ یعنی شما تعیین می‌کنید اپ روی کدام مخزن‌ها دسترسی داشته باشد و رویدادها از همان‌جا به تسکیـ می‌رسند.

1. از تنظیمات، «مرکز اپ‌ها» را باز کنید و GitHub را انتخاب کنید (یا در تنظیمات فضای کاری وارد تب «یکپارچه‌سازی» شوید).
2. تب «فضای کاری» را انتخاب کنید و روی «اتصال» بزنید.
3. به GitHub منتقل می‌شوید؛ اپ تسکیـ را روی حساب یا سازمان خود و روی مخزن‌های دلخواه نصب کنید.
4. پس از تأیید، به تسکیـ برمی‌گردید و مخزن‌های انتخاب‌شده به‌صورت خودکار همگام می‌شوند.
5. اتصال و فهرست مخزن‌ها را می‌توانید در همان تب «یکپارچه‌سازی» ببینید و مدیریت کنید.

نکته: اگر مخزن مورد نظر را نمی‌بینید، مطمئن شوید اپ تسکیـ در GitHub روی همان مخزن دسترسی دارد و با حساب درست وارد شده‌اید. می‌توانید در تنظیمات GitHub App، مخزن‌های بیشتری به دسترسی اضافه کنید و دوباره همگام‌سازی کنید.

اتصال شخصی

هر عضو (در سطح Member و بالاتر) می‌تواند از «مرکز اپ‌ها» یک اتصال شخصی به GitHub بسازد. اتصال شخصی داده‌های حساب GitHub شما را در اختیار دیگران نمی‌گذارد و برای این است که کارهای خودتان را ساده‌تر به وظیفه‌ها ربط دهید. می‌توانید بیش از یک اتصال شخصی داشته باشید (مثلاً برای چند حساب).

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

دو راه برای ربط‌دادن یک وظیفه به کار GitHub وجود دارد: لینک خودکار با نوشتن شناسهٔ وظیفه، و لینک دستی با چسباندن نشانی.

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

کافی است شناسهٔ وظیفه را جایی در کار GitHub بنویسید؛ تسکیـ آن را می‌بیند و وظیفه را به آن پول‌ریکوئست، شاخه، کامیت یا ایشو لینک می‌کند. شناسه را می‌توانید در هر یک از این جاها بنویسید: نام شاخه، پیام کامیت، عنوان پول‌ریکوئست یا متن (توضیحات) پول‌ریکوئست.

شناسهٔ وظیفه همان شناسهٔ نمایشی وظیفه است (مثل TASK-12) و این سه شکل پذیرفته می‌شود:

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

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

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

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

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

علاوه بر لینک‌شدن، می‌توانید وضعیت وظیفه را هم از دل کار GitHub جلو ببرید. دو رفتار وجود دارد:

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

مهم: بین شناسه و کروشهٔ وضعیت فاصله نگذارید (درست: TASK-12[Done]). نام داخل کروشه باید با نام یکی از وضعیت‌های همان پروژه یکی باشد؛ اگر وضعیتی با آن نام پیدا نشود، وظیفه فقط لینک می‌شود و وضعیتش تغییر نمی‌کند.

به‌روزرسانی خودکار وضعیت و لینک خودکار، هر کدام قابلیت‌های جداگانه‌ای هستند و مدیر می‌تواند آن‌ها را برای این اتصال روشن یا خاموش کند. اگر تغییر وضعیت اتفاق نیفتاد، مطمئن شوید این قابلیت برای اتصال فعال است.

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

برخی رویدادها به‌جای تغییر وضعیت، برای افراد مرتبطِ وظیفه اعلان می‌فرستند؛ برای نمونه وقتی اجرای CI/CD (workflow) روی کار لینک‌شده ناموفق شود یا ایشوی تازه‌ای ثبت شود، مسئول و سازندهٔ وظیفه باخبر می‌شوند. برای تنظیم اینکه این اعلان‌ها از چه راه‌هایی به دست شما برسند، تنظیم اعلان‌ها و یادآورها را ببینید.

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

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

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

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

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