GitHub 連線

1. 登入 CodePipeline 主控台。

2. 選擇下列其中一項。

   • 選擇建立管道。依照建立管道中的步驟完成第一個畫面，然後選擇下一步。在來源頁面的來源提供者 下，選擇 GitHub （第 2 版）。

   • 選擇編輯現有的管道。選擇編輯 ，然後選擇編輯階段 。選擇新增或編輯來源動作。在編輯動作頁面的動作名稱 下，輸入動作的名稱。在動作提供者 中，選擇 GitHub （第 2 版）。

3. 執行以下任意一項：

   • 在連線 下，如果您尚未建立與提供者的連線，請選擇連線至 GitHub。繼續進行步驟 2：建立與 的連線 GitHub。

   • 在連線 下，如果您已建立與提供者的連線，請選擇連線。繼續步驟 3：儲存連線的來源動作。

若要建立 的連線 GitHub

1. 在GitHub 連線設定 下，您的連線名稱會顯示在連線名稱 中。選擇連線至 GitHub。隨即會顯示存取請求頁面。

2. 選擇 授權 AWS 連接器 GitHub。連線頁面會顯示 ，並顯示GitHub 應用程式欄位。

   

3. 在GitHub 應用程式 下，選擇應用程式安裝，或選擇安裝新應用程式以建立應用程式。

   您可以為您連至特定供應商的所有連線安裝一個應用程式。如果您已安裝 GitHub 應用程式的 AWS Connector，請選擇它並略過此步驟。

   注意

   如果您想要建立使用者存取權杖 ，請確定您已經安裝 GitHub 了應用程式的 AWS Connector，然後讓應用程式安裝欄位保持空白。 CodeConnections 將使用使用者存取權杖進行連線。

4. 在安裝 AWS 連接器的 GitHub頁面上，選擇要安裝應用程式的帳戶。

   注意

   每個 GitHub 帳戶只安裝應用程式一次。如果您先前已安裝應用程式，可以選擇 Configure (設定)，繼續前往應用程式安裝的修改頁面，或者您可以使用上一步按鈕返回主控台。

5. 在安裝 AWS 連接器的 GitHub頁面上，保留預設值，然後選擇安裝 。

6. 在連線至 GitHub頁面上，新安裝的連線 ID GitHub 會顯示在應用程式 中。選擇連線。

若要儲存 GitHub 來源動作

1. 在 Repository name (儲存庫名稱) 中，選擇第三方儲存庫的名稱。

2. 如果您的動作是 CodeConnections 動作，您可以在管道觸發條件下新增觸發條件。若要設定管道觸發條件組態，以及選擇性地使用觸發條件進行篩選，請參閱 中的更多詳細資訊程式碼推送或提取請求時篩選觸發條件。

3. 在 Output artifact format (輸出成品格式) 中，您必須選擇成品的格式。

   • 若要使用預設方法儲存 GitHub 動作的輸出成品，請選擇CodePipeline 預設 。動作會從 GitHub 儲存庫存取檔案，並將成品存放在管道成品存放區中的ZIP檔案中。

   • 若要儲存包含儲存庫URL參考JSON的檔案，以便下游動作可以直接執行 Git 命令，請選擇完整複製 。此選項只能由 CodeBuild 下游動作使用。

     如果您選擇此選項，您將需要更新 CodeBuild 專案服務角色的許可，如 所示新增 Bitbucket、 GitHub GitHub Enterprise Server 或 GitLab.com 連線的 CodeBuild GitClone 許可。如需示範如何使用完整複製選項的教學課程，請參閱 教學課程：搭配 GitHub 管道來源使用完整複製。

4. 在精靈上選擇下一步，或在編輯動作頁面上選擇儲存。

建立連線

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

   aws codestar-connections create-connection --provider-type GitHub --connection-name MyConnection

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

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

2. 使用主控台完成連線。如需詳細資訊，請參閱更新待定連線 。

3. 管道預設為偵測將程式碼推送至連線來源儲存庫時的變更。若要設定手動發行或 Git 標籤的管道觸發組態，請執行下列其中一項操作：

   • 若要將管道觸發組態設定為僅從手動版本開始，請將下列行新增至組態：

     "DetectChanges": "false",

   • 若要設定管道觸發組態以使用觸發條件進行篩選，請參閱 中的更多詳細資訊程式碼推送或提取請求時篩選觸發條件。例如，以下項目會新增至管道JSON定義的管道層級。在此範例中， release-v0和 release-v1是要包含的 Git 標籤， release-v2是要排除的 Git 標籤。

     "triggers": [
                 {
                     "providerType": "CodeStarSourceConnection",
                     "gitConfiguration": {
                         "sourceActionName": "Source",
                         "push": [
                             {
                                 "tags": {
                                     "includes": [
                                         "release-v0", "release-v1"
                                     ],
                                     "excludes": [
                                         "release-v2"
                                     ]
                                 }
                             }
                         ]
                     }
                 }
             ]