如何整合 Code Stream 與 Git

如果您的 GitHub、GitLab 或 Bitbucket 存放庫中發生程式碼變更， Code Stream 會提供觸發管線的方式。Git 觸發器在要監控的存放庫的分支上使用 Git 端點。 Code Stream 透過 webhook 連線至 Git 端點。

若要在 Code Stream 中定義 Git 端點，您可以選取專案，並輸入端點所在的 Git 存放庫的分支。專案將管線與端點及其他相關物件進行分組。當您在 webhook 定義中選擇專案時，請選取要觸發的端點和管線。

備註：如果定義包含端點的 webhook，並稍後編輯此端點，則無法在 webhook 中變更端點詳細資料。若要變更端點詳細資料，您必須刪除並重新定義包含此端點的 webhook。請參閱如何在 Code Stream 中使用 Git 觸發器執行管線。

透過使用相同的 Git 端點並在 Webhook 組態頁面中為分支名稱提供不同的值，可以為不同的分支建立多個 Webhook。若要為相同 Git 存放庫中的其他分支建立其他 Webhook，無需針對多個分支複製 Git 端點多次。而是在 Webhook 中提供分支名稱，以便重複使用 Git 端點。如果 Git Webhook 中的分支與端點中的分支相同，則無需在 Git Webhook 頁面中提供分支名稱。

必要條件

確認您可以存取您打算連線的 GitHub、GitLab 或 Bitbucket 存放庫。
確認您是 Code Stream 中的專案的成員。如果您不是管理員，請要求 Code Stream 管理員將您新增為專案成員。請參閱如何在 Code Stream 中新增專案。

程序

定義 Git 端點。
1. 按一下端點 > 新增端點。
2. 選取專案，並針對端點類型選取 Git。然後，輸入名稱與說明。
3. 如果此端點是您基礎結構中的業務關鍵元件，請啟用標記為受限制。
  在管線中使用受限制的端點時，管理員可以執行管線，並且必須核准管線執行。如果端點或變數標記為受限制且非管理使用者觸發了管線，則管線會在該工作暫停並等待管理員繼續執行。
  
  專案管理員可以啟動包括受限制端點或變數在內的管線，前提是這些資源位於使用者作為專案管理員的專案中。
  
  如果非管理員使用者嘗試執行包含受限制資源的管線，則管線會在使用受限制資源的工作中停止。然後，管理員必須恢復管線。
  
  如需有關受限制資源以及包括稱為管理受限制的管線之權限的自訂角色的詳細資訊，請參閱：
  - 如何在 Code Stream 中管理使用者存取和核准
  - 設定 Code Stream 以建立發佈程序模型
4. 選取其中一個支援的 Git 伺服器類型。
5. 在路徑中輸入具有伺服器之 API 閘道之存放庫的 URL。例如：
  對於 GitHub，輸入： https://api.github.com/vmware-example/repo-example
  
  對於 BitBucket，輸入： https://api.bitbucket.org/{user}/{repo name} 或 http(s)://{bitbucket-enterprise-server}/rest/api/1.0/users/{username}/repos/{repo name}
6. 輸入端點所在的存放庫中的分支。
7. 選取驗證類型，然後輸入 GitHub、GitLab 或 BitBucket 的使用者名稱。然後輸入與使用者名稱相符的私人 Token。
  - 密碼。若要稍後建立 Webhook，您必須輸入密碼的私人 Token。適用於 Git 的 Webhook 不支援使用基本驗證建立的端點。
    使用密碼變數隱藏和加密敏感資訊。針對必須隱藏和加密以及限制在執行中使用的字串、密碼和 URL 使用受限制的變數。例如，針對密碼或 URL 使用密碼變數。您可以在管線中任何類型的工作中使用密碼和受限制的變數。
  - 私人 Token。此 Token 為 Git 專屬，並且提供對特定動作的存取權。請參閱https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html。您也可以為私人 Token 建立變數。
按一下驗證，並確認端點會連線至 Code Stream。
如果無法連線，請更正任何錯誤，然後按一下建立。

下一步

若要進一步瞭解，請檢閱其他區段。請參閱如何在 Code Stream 中使用 Git 觸發器執行管線。