本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 連接 GitLab
<a name="connecting-to-cicd-pipelines-connecting-gitlab"></a>

GitLab 整合可讓 AWS DevOps 代理程式從 GitLab 管道監控部署，以在事件回應期間通知因果調查。此整合遵循兩個步驟：GitLab 的帳戶層級註冊，接著將特定專案連線至個別 Agent Spaces。

## 註冊 GitLab （帳戶層級）
<a name="registering-gitlab-account-level"></a>

GitLab 已在 AWS 帳戶層級註冊，並與該帳戶中的所有客服人員空間共用。個別客服人員空間接著可以選擇哪些特定專案適用於其客服人員空間。

### 步驟 1：導覽至管道供應商
<a name="step-1-navigate-to-pipeline-providers"></a>

1. 登入 AWS 管理主控台

1. 導覽至 AWS DevOps 代理程式主控台

1. 前往**能力提供者頁面 **（可從側邊導覽存取）

1. 在**管道**下的**可用**供應商區段中尋找 **GitLab**，然後按一下**註冊**

### 步驟 2：設定 GitLab 連線
<a name="step-2-configure-gitlab-connection"></a>

在 GitLab 註冊頁面上，設定下列項目：

**連線類型** – 選取您是以個人或群組身分連線：
+ **個人** （預設） – 具有使用者名稱和設定檔的個別 GitLab 使用者帳戶
+ **群組** – 在 GitLab 中，您可以使用群組來同時管理一或多個相關專案

**GitLab 執行個體類型** – 選擇您要連接的 GitLab 執行個體類型：
+ **GitLab.com** （預設） – 公有 GitLab 服務
+ **可公開存取的自我託管 GitLab** – 檢查**使用 GitLab 自我託管端點**方塊，並將 URL 提供給 GitLab 執行個體

**注意**  
** 目前僅支援可公開存取的 GitLab 執行個體。

**存取字符** – 提供 GitLab 個人存取字符：

1. 在單獨的瀏覽器索引標籤中，登入您的 GitLab 帳戶

1. 導覽至您的使用者設定，然後選取**存取字符**

1. 使用下列許可建立新的個人存取字符：
   + `read_repository` – 存取儲存庫內容時需要
   + `read_virtual_registry` – 存取虛擬登錄檔資訊時需要
   + `read_registry` – 存取登錄檔資訊時需要
   + `api` – 讀取和寫入 API 存取時需要
   + `self_rotate` - 輪換權杖時需要。 AWS DevOps 代理程式目前不支援此功能，但稍後會支援此功能。立即新增 可避免未來需要建立新的權杖。

1. 將字符過期設定為從目前日期起算最多 365 天

1. 複製產生的字符

1. 返回 AWS DevOps 代理程式主控台

1. 將字符貼到「存取字符」欄位中

### 步驟 3：完成註冊
<a name="step-3-complete-registration"></a>

**（選用） 標籤** – 將 AWS 標籤新增至 GitLab 註冊以供組織使用。

按一下**下一步**以檢閱您的組態，然後按一下**提交**以完成 GitLab 註冊程序。系統會驗證您的存取權杖並建立連線。

## 將專案連線至 代理程式空間
<a name="connecting-projects-to-an-agent-space"></a>

在帳戶層級註冊 GitLab 之後，您可以將特定專案連線到個別的 Agent Spaces：

1. 在 AWS DevOps 代理程式主控台中，選取您的代理程式空間

1. 前往**功能**索引標籤

1. 在**管道**區段中，按一下**新增**

1. 從可用提供者清單中選取 **GitLab** 

1. 選取與您的客服人員空間相關的 GitLab 專案

1. 按一下**儲存**

AWS DevOps 代理程式將監控這些專案的 GitLab Pipelines 部署，以通知因果調查。

## 管理 GitLab 連線
<a name="managing-gitlab-connections"></a>
+ **更新存取權杖** – 如果您的存取權杖過期或需要更新，您可以在帳戶層級修改 GitLab 註冊，以在 AWS DevOps 代理程式主控台中更新它。
+ **檢視連線的專案** – 在 AWS DevOps 代理程式主控台中，選取您的代理程式空間，然後前往功能索引標籤，在管道區段中檢視連線的專案。
+ **移除 GitLab 連線** – 若要中斷 GitLab 專案與客服人員空間的連線，請在管道區段中選取連線，然後按一下**移除**。若要完全移除 GitLab 註冊，請先將其從所有 Agent Spaces 中移除，然後在帳戶層級刪除註冊。