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

# 建立連至 GitLab 的連線
<a name="connections-create-gitlab"></a>

您可以使用 AWS 管理主控台 或 AWS Command Line Interface (AWS CLI) 來建立與 gitlab.com 上託管之儲存庫的連線。

**注意**  
在 GitLab 中授權此連線安裝，即表示您授權我們的服務處理您的資料，您隨時可以解除安裝應用程式以撤銷許可。

開始之前：
+ 您必須已在 GitLab 建立帳戶。
**注意**  
連線只能存取用於建立和授權連線之帳戶。
**注意**  
您可以對在 GitLab 中具有**擁有者**的角色建立連線，然後該連線可以與具有 CodePipeline 等資源的儲存庫搭配使用。如果是群組中的儲存庫，您不需要為群組擁有者。

**Topics**
+ [建立連至 GitLab 的連線 (主控台)](#connections-create-gitlab-console)
+ [建立連至 GitLab 的連線 (CLI)](#connections-create-gitlab-cli)

## 建立連至 GitLab 的連線 (主控台)
<a name="connections-create-gitlab-console"></a>

您可以使用 主控台來建立連線。

**注意**  
從 2024 年 7 月 1 日開始，主控台會在資源 ARN `codeconnections`中建立與 的連線。具有兩個服務字首的資源將繼續顯示在主控台中。

**步驟 1：建立連線**

1. 登入 AWS 管理主控台，然後在 開啟 AWS 開發人員工具主控台[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。

1. 選擇**設定**，然後選擇**連線**。選擇**建立連線**。

1. 若要建立連至 GitLab 儲存庫的連線，請在**選取供應商**底下選擇 **GitLab**。在 **Connection name (連線名稱)** 底下，輸入您要建立的連線名稱。選擇**連線至 GitLab**。  
![\[主控台螢幕擷取畫面中顯示針對 GitLab 選擇的連線選項。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-gitlab.png)

1. GitLab 的登入頁面顯示時，使用您的憑證登入，然後選擇**登入**。

1. 此時會顯示授權頁面，當中包含請求連線授權以存取您的 GitLab 帳戶的訊息。

   選擇 **Authorize** (授權)。  
![\[螢幕擷取畫面中顯示授權您的 GitLab 帳戶連線的訊息。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/gitlab-authorization.png)

1. 瀏覽器會返回連線主控台頁面。新連線會出現在**建立 GitLab 連線**底下的**連線名稱**中。

1. 選擇**連線至 GitLab**。

   成功建立連線後，會顯示成功橫幅。連線詳細資訊會在**連線設定**頁面上顯示。

## 建立連至 GitLab 的連線 (CLI)
<a name="connections-create-gitlab-cli"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 來建立連線。

若要這麼做，請使用 **create-connection** 命令。

**重要**  
根據預設，透過 AWS CLI 或 建立的連線 AWS CloudFormation 處於 `PENDING` 狀態。建立與 CLI 或 的連線後 CloudFormation，請使用 主控台來編輯連線，使其成為狀態 `AVAILABLE`。

**建立連至 GitLab 的連線**

1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 **create-connection**命令，`--connection-name`為您的連線指定 `--provider-type`和 。在此範例中，第三方供應商名稱為 `GitLab`，而指定的連線名稱為 `MyConnection`。

   ```
   aws codeconnections create-connection --provider-type GitLab --connection-name MyConnection
   ```

   如果成功，此命令會傳回類似下列內容的連線 ARN 資訊。

   ```
   {
       "ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
   }
   ```

1. 使用主控台完成連線。如需詳細資訊，請參閱[更新待定連線](connections-update.md)。