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

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

您可以使用 AWS 管理主控台 或 AWS Command Line Interface (AWS CLI) 建立 GitHub 的連線。

開始之前：
+ 您必須已建立 GitHub 帳戶。
+ 您必須已建立第三方程式碼儲存庫。

**注意**  
如要建立連線，您必須是 GitHub 組織擁有者。對於不在組織下的儲存庫，您必須是儲存庫擁有者。

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

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



您可以使用 主控台建立與 GitHub 的連線。

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

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

1. 選擇 **Settings > Connections (設定 > 連線)**，然後選擇 **Create connection (建立連線)**。

1. 若要建立連至 GitHub 或 GitHub Enterprise Cloud 儲存庫的連線，請在 **Select a provider (選取供應商)** 底下選擇 **GitHub**。在 **Connection name (連線名稱)** 底下，輸入您要建立的連線名稱。選擇 **Connect to GitHub (連線至 GitHub)**，然後繼續進行步驟 2。  
![\[主控台螢幕擷取畫面顯示為 Bitbucket 選擇的連線選項。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/github-conn.png)

**建立連至 GitHub 的連線**

1. 在 **GitHub connection settings** (GitHub 連線設定) 之下，您的連線名稱會顯示於 **Connection name** (連線名稱) 中。選擇**連線到 GitHub**。隨即會顯示存取請求頁面。  
![\[主控台螢幕擷取畫面顯示 GitHub 帳戶存取頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/github-conn-access.png)

1. 選擇**授權 AWS GitHub 連接器**。連線頁面會出現，並顯示 **GitHub Apps (GitHub 應用程式)** 欄位。  
![\[主控台螢幕擷取畫面顯示包含 GitHub 應用程式欄位的初始 GitHub 連線頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/github-conn-access-app.png)

1. 在 **GitHub Apps (GitHub 應用程式)** 底下，選擇應用程式安裝，或選擇 **Install a new app (安裝新應用程式)** 以建立安裝。
**注意**  
您可以為您連至特定供應商的所有連線安裝一個應用程式。如果您已安裝 AWS Connector for GitHub 應用程式，請選擇它並略過此步驟。

1. 在**安裝適用於 GitHub 的AWS Connector** 頁面上，選擇要安裝應用程式的帳戶。  
![\[主控台螢幕擷取畫面，顯示 AWS Connector for GitHub 安裝頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/github-conn-access-app-install1.png)
**注意**  
您只能為每個 GitHub 帳戶安裝一次應用程式。如果您先前已安裝應用程式，可以選擇 **Configure (設定)**，繼續前往應用程式安裝的修改頁面，或者您可以使用上一步按鈕返回主控台。

1. 在**安裝 GitHub AWS 連接器**頁面上，保留預設值，然後選擇**安裝**。  
![\[主控台螢幕擷取畫面，顯示第二個 AWS Connector for GitHub 安裝頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/github-conn-access-app-install2.png)

   完成此步驟後，更新的許可頁面可能會顯示在 GitHub 中。

1. 如果顯示的頁面顯示適用於 GitHub 應用程式的 AWS 連接器已更新許可，請選擇 **Accept new permissions** (接受新許可)。  
![\[主控台螢幕擷取畫面顯示 AWS Connector for GitHub 已更新許可頁面。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/accept-new-permissions.png)

1. 您會返回 **Connect to GitHub** (連線至 GitHub) 頁面。新安裝的連線 ID 會顯示在 **GitHub Apps** (GitHub 應用程式) 中。選擇**連線**。

### 檢視您建立的連線
<a name="connections-create-github-console-view"></a>
+ 建立的連線會顯示在連線清單中。  
![\[主控台螢幕擷取畫面顯示成功建立連線的連線列表。\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-create-ghe-complete.png)

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

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

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

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

**建立連至 GitHub 的連線**

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

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

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

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

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