GitHub

GitHub را وصل کنید تا pull request، commit و check روی Issueهای Pulse دیده شود.

Issueهای Pulse را به pull request، commit و check در GitHub وصل کنید.

پیکربندی

فقط مالکان و ادمین‌های workspace می‌توانند یکپارچه‌سازی‌ها را مدیریت کنند. Settings → Integrations (/settings/integrations) را باز کنید، سپس GitHub (/settings/integrations/github).

اگر کارت Unavailable نشان دهد، این استقرار اپ عمومی Try Pulse را پیکربندی نکرده. اتصال‌های موجود همان‌طور که هستند می‌مانند.

اتصال سازمان

برای وصل کردن GitHub:

  1. در Integrations، GitHub را باز کنید.
  2. Enable را بزنید. Pulse گیت‌هاب را باز می‌کند تا اپ Try Pulse را روی یک حساب یا سازمان نصب کنید.
  3. repositoryهایی را که Pulse می‌تواند ببیند انتخاب کنید، سپس به Pulse برگردید.

Connected organizations هر نصب را فهرست می‌کند. Connect a new organization یکی دیگر اضافه می‌کند. معلق یا حذف کردن یکی روی دیگری اثر نمی‌گذارد.

Disconnect… اتصال و دسترسی repository را از این workspace حذف می‌کند. اپ GitHub تا وقتی آنجا uninstall نکنید نصب می‌ماند. Configure in GitHub صفحهٔ نصب را باز می‌کند.

Repository access اشتراک چیزی است که GitHub اجازه می‌دهد و این workspace می‌دهد — فقط می‌تواند محدودتر شود. Refresh from provider نصب را دوباره می‌خواند.

اتصال حساب

Personal GitHub account اختیاری است و از نصب سازمان جداست. آن را در همین صفحه وصل کنید، یا در Settings → Connected accounts (/settings/applications). لغو یکی دیگری را خاموش نمی‌کند.

از حساب شخصی برای کارهایی استفاده کنید که باید به نام شما ثبت شود. خودکارسازی سازمان بدون آن، با هویت نصب ادامه می‌یابد.

لینک کردن کار

pull request و commitهای لینک‌شده روی Issue زیر Diffs دیده می‌شوند. متن خالی Link a pull request است. Add pull request… را بزنید، URL یک pull request گیت‌هاب از repository متصل را بچسبانید، سپس نوع لینک را انتخاب کنید:

  • Closes this issue
  • Contributes to this issue
  • Related
  • References this issue

وضعیت‌ها شامل Open، Draft، Merged و Closed است. check و تصمیم review وقتی GitHub گزارش کند روی کارت می‌آید. منوی overflow شامل Open in GitHub، Refresh from provider، Change link type و Unlink pull request است.

لینک pull request

Pulse شناسهٔ Issue را از منبع‌های خودکار می‌خواند (پیش‌فرض روشن):

  • Branch name
  • Title
  • Description

اگر فقط لینک دستی می‌خواهید، آن منبع‌ها را در تنظیمات workflow گیت‌هاب خاموش کنید.

شناسه را در نام branch یا pull request بگذارید تا لینک بدون چسباندن URL ساخته شود. نام branch را از Issue با Copy git branch name (Cmd/Ctrl Shift .) کپی کنید. قالب شخصی branch در Settings → Code & reviews است.

لینک commit

Link commits to issues with magic words پیش‌فرض خاموش است. پیام commit با rebase و cherry-pick بازنویسی می‌شود، پس لینکی که از آن ساخته شود می‌تواند جابه‌جا شود. وقتی می‌خواهید پیام commit لینک بسازد، سوییچ را روشن کنید.

واژه‌های جادویی

یک واژهٔ جادویی و شناسهٔ Issue را در عنوان یا توضیح pull request بگذارید — و در پیام commit اگر آن سوییچ روشن باشد. مثلاً: Fixes PUL-42 یا Part of PUL-42.

عبارت‌های بستن مثل fix، fixes، close، closes، resolve و implements یعنی Closes this issue. عبارت‌های مشارکت مثل part of، ref، references، contributes to و towards یعنی Contributes to this issue. related to یعنی Related. skip یا ignore شواهد خودکار آن شناسه را سرکوب می‌کند.

شناسهٔ تنها، بدون عبارت بستن یا مشارکت، خودکارسازی وضعیت تیم را اجرا نمی‌کند.

لینک‌برگشت Issue

Linkbacks یک نظر مدیریت‌شده روی pull request می‌گذارد که به Issue پالس لینک می‌دهد. پیش‌فرض خاموش. Public repositories و Private repositories را جدا انتخاب کنید. Include the issue title پیش‌فرض خاموش است: خوانندگان repository خوانندگان Issue نیستند.

خودکارسازی گردش‌کار

خودکارسازی وضعیت Issue

این‌که یک رویداد pull request یا commit Issue را به کدام وضعیت Pulse ببرد، per team پیکربندی می‌شود.

Settings → Your teams → <team> → Source control workflow را باز کنید. Automate issue statuses پیش‌فرض خاموش است. قاعده‌ها per provider هستند — ستون GitHub را پیکربندی کنید.

فقط لینک‌هایی که Issue را می‌بندند یا در آن مشارکت می‌کنند خودکارسازی می‌شوند؛ ذکر خالی هرگز این کار را نمی‌کند. Merged فقط وقتی اعمال می‌شود که هر change request و commit بسته‌کننده فرود آمده باشد. Closed without merging هرگز Issue را کامل نمی‌کند.

رویدادها شامل Draft opened، Opened for review، Ready to merge، Merged، Closed without merging و موارد دیگر است. Do nothing وضعیت را عوض نمی‌کند.

Code Intelligence و coding sessions در Pulse Agent repositoryهای اعطاشده را می‌خوانند. آن‌ها را در Settings → AI & Agents پیکربندی کنید. Pulse Agent را ببینید.

قاعده‌های branch هدف

Target-branch rules پیش‌فرض را برای change requestهایی که به branch خاصی می‌روند عوض می‌کند. نام دقیق همیشه بر الگو پیروز می‌شود؛ بین الگوها، بالایی برنده است. Use the default ارث می‌برد. Preview نشان می‌دهد برای یک branch هدف چه می‌شود.

انتساب و جلو بردن

Move issue to In Progress on branch copy سوییچ شخصی در کد و بازبینی‌ها است، نه تنظیم سازمان GitHub.

بازبینی‌ها

بازبینی‌ها inbox merge request است. فهرست Diffs روی Issue نیست. Reviews را در Settings → Features روشن کنید، سپس GitHub را اینجا وصل کنید.

پرسش‌های متداول

آخرین به‌روزرسانی