GitHub 及 Asana | 產品指南

概觀

您可藉由 Asana for GitHub 整合,使 GitHub 提取請求的狀態更新自動同步至 Asana 任務,以改善跨職能的協作。

此項整合有助提升技術與非技術團隊間有關工程工作的可見度和透明度。開發人員可藉由此項新的整合,以不費力的方式透過 Asana 溝通,使團隊和跨職能專案關係人始終得知資訊,避免遺漏工作的任何細節。

Asana for GitHub 整合可供所有 Premium 版Business 版Enterprise 版 客戶使用。

安裝 Asana 與 GitHub

連結 Asana 與 GitHub,以便同步提取請求的狀態。若要使用此整合,請在 Asana 中進行設定,也可在 GitHub 進行其他功能的設定。

新增具有自訂功能表應用程式的畫面

如何進行 Asana 設定:

  1. 導覽至您要安裝 Asana for GitHub 整合的 Asana 專案。點選右上角的自訂下拉功能表。
  2. 向下捲動至應用程式並選擇 +新增應用程式

Github 應用程式

  • 按一下 +新增至專案,以選擇 GitHub
  • 依循說明進行 GitHub 帳戶授權。
  • Asana for GitHub 整合將安裝於專案層級。

恭喜!您現在已可連結 GitHub 提取請求至 Asana 任務。若您要啟用此整合的其他功能,請參閱下一節。如不需要,則請跳至下方的重要功能

如何設定 GitHub 動作:

此節內容基於一前提:使用者對 Git 和 GitHub 資料庫加密變數有基本的熟悉度。若您不具設定資料庫加密變數的存取權限,請聯絡資料庫所有者。

我們支援兩種類型的 GitHub 動作:

  1. 在 Asana 中將 GitHub 提取請求通知自動化:此動作會在該 Asana 任務留下提取請求狀態的評論,包括提取請求標題,以及與 Asana 任務關聯的連結。若要進行此設定,請前往 GitHub 動作頁面
  2. 將來自 GitHub 的提取請求描述中之提取請求附件連結至 Asana:此動作會將 Asana 任務的 URL 新增至提取請求描述,從而將 GitHub 提取請求自動連結至 Asana 任務。若要進行此設定,請前往 GitHub 動作頁面

有如其他 GitHub 動作,這些動作只會在 (您已為其設定動作的) 資料庫有事件發生時才會執行。例如,您可設定一個動作,以便在每次有人合併提取請求或對其提出評論時予以執行。

除非是同一個資料庫內多個完全相同的動作,否則每個 GitHub 動作均必須個別設定。例如,您可以設定一個動作,以便在任務完成時對提取請求描述中的任務進行評論;並且設定另一個動作,以便在提取請求被合併時對任務新增不同的評論。

GitHub 動作可新增為現有工作流程的一部分。請參考 GitHub 動作資源指南,以便深入瞭解。

撤銷加密變數權杖

若您在前一個區段設定 Github 動作,您可撤銷加密變數權杖,請前往此設定頁面,並選擇 Revoke all (撤銷全部)

這樣做會撤銷所有現有的 GitHub 動作加密變數權杖。

針對您已新增此整合的 Asana 專案,您仍能查看這些現有 Asana 專案中的提取請求資訊。

重要功能

如何 (在 Asana 中) 附加提取請求至 Asana 任務:

在 Asana 中安裝 GitHub 整合後,您現在就能在關聯的專案中查看每個任務的 GitHub 欄位。

任務的 Github 欄位

若要附加提取請求至 Asana 任務,請擷取提取請求 URL,並把它貼至空白的 GitHub 欄位。Asana 任務此時會顯示包含下列詳細資訊的小工具:審查狀態、版本狀態、提取請求狀態、程式碼行變更及 GitHub 內的對話數。

![Github 提取請求連結(https://luna1.co/1402fb.png){.screenshot}

如何 (在 GitHub) 將提取請求附加至 Asana 任務:

在 Asana 中安裝 GitHub 整合並且設定 GitHub 動作後,您現在就可以從 GitHub 提取請求描述自動附加一個請求至 Asana 任務。

Github 提取請求描述

在您的 GitHub 提取請求描述中擷取 Asana 任務 URL,並將它貼至描述中。接著,當您在 Asana 中檢視任務時,應會顯示包含以下詳細資訊的小工具:審查狀態、版本狀態、提取請求狀態及程式碼行變更。

GitHub 中的 GitHub 動作標籤頁應會反映所有錯誤。

如何接收提取請求的合併和關閉更新:

適當團隊進行審查並合併變更後,GitHub 中的提取請求就可關閉。Asana 小工具中的狀態會自動更新。

若您想附加新的 GitHub 提取請求,您可將該 Asana 任務 URL 新增至 GitHub 提取請求描述,小工具就會自動被取代;或者,您也可按一下右上角的功能表,移除在 Asana 內的已關閉提取請求。移除後,您就能輸入新的 GitHub 提取請求 URL。

在 Asana 中安裝 GitHub 整合並設定 GitHub Actions 後,您接著就會收到 Asana 任務的相關評論,以及附加的開啟提取請求。這會包括提取請求是否已合併 (或已關閉) 的更新資訊。

更新

常見問題

  • 產生的相同加密變數是否可用於多個資料庫?
    • 可以
  • 我若將提取請求附加至 Asana 任務,我的隊友能否查看該提取請求的相關資訊 (即使他們沒有提取請求的存取權限)?
    • 能。您附加提取請求至任務後,能檢視該任務的每個人都能在小工具中查看這些資訊。
  • 產生新權杖是否會停用我舊的加密變數權杖?
    • 否,您舊的加密變數權杖仍會繼續運作。若您想停用現有加密變數權杖,可在此處加以停用。
  • 產生的相同加密變數是否可用於多個資料庫?
    • 可以
  • 我嘗試推播工作流程檔案時,「Git」指出我的權杖沒有建立工作流程的存取權限。我該怎麼做?
    • 若您使用的是雙因素驗證,且在指令行與 GitHub 互動,GitHub 會要求 您使用個人存取權杖當作密碼。請針對該工作流程範疇建立一個新的 GitHub 個人存取權杖。
  • 為什麼我們要請求這些 GitHub 權限?
    • 在此整合中我們只能從提取請求讀取和寫入。驗證頁面上的權限是 GitHub 允許我們請求且最有限制性的權限,好讓我們藉此存取提取請求。
  • 若 GitHub 動作附加提取請求至專案中的任務,而該專案並未啟用此整合,會產生什麼結果?
    • 可在任務評論區段看見一個連結至提取請求的附件,但不會顯示同步請求狀態的小工具。

抱歉,我們不支援此瀏覽器

Asana 無法在您目前使用的網際網路瀏覽器上運作。請改用一個支援的瀏覽器