CodeDeploy 與整合 GitHub

CodeDeploy 支持 GitHub，基於 Web 的代碼託管和共享服務。 CodeDeploy 可以將存放在儲存 GitHub庫或 Amazon S3 儲存貯體中的應用程式修訂版部署到執 CodeDeploy 僅支 GitHub 援 EC2 /內部部署。

部署 CodeDeploy 修訂來源 GitHub

若要將應用程式修訂版本從 GitHub 儲存庫部署至執行個體：

1. 建立與 CodeDeploy 您要部署的 Amazon EC2 執行個體類型相容的修訂版。

   若要建立相容的修訂版，請遵循 規劃修訂 CodeDeploy 和 將應用程式規格檔案新增至修訂 CodeDeploy 之中的說明。

2. 使用 GitHub 帳戶將修訂新增至 GitHub 儲存庫。

   若要建立 GitHub 帳戶，請參閱加入 GitHub。若要建立 GitHub 儲存庫，請參閱建立存放庫。

3. 您可以使用 CodeDeploy 主控台中的「建立部署」頁面或 AWS CLI create-deployment命令，將修訂版本從 GitHub 儲存區域建置到設定用於建置的目標執行處理。 CodeDeploy

   如果您想要呼叫create-deployment命令，必須先使用主控台的 [建立部署] 頁面，為指定的應用程式提供代表您偏好 GitHub帳戶進行互動的 CodeDeploy 權限。 GitHub 每個應用程式都只需要執行此步驟一次。

   若要瞭解如何使用「建立建置」頁面從 GitHub 儲存區域建置，請參閱使用建立部署 CodeDeploy。

   若要瞭解如何呼叫要從 GitHub 儲存庫部署的create-deployment命令，請參閱建立EC2/內部部署計算平台部署 (CLI)。

   若要瞭解如何準備執行個體以用於 CodeDeploy 部署，請參閱使用的例證 CodeDeploy。

如需詳細資訊，請參閱 教學課程：用 CodeDeploy 來部署應用程式 GitHub。

GitHub 行為與 CodeDeploy

主題

• GitHub 使用應用程式的驗證 CodeDeploy
• CodeDeploy 與私人和公共 GitHub 存儲庫的交互
• CodeDeploy 與組織管理的儲 GitHub 存庫互動
• CodePipeline使用自動部署 CodeDeploy

GitHub 使用應用程式的驗證 CodeDeploy

在您 CodeDeploy 授予互動權限之後 GitHub，該 GitHub 帳戶和應用程式之間的關聯就會儲存在中 CodeDeploy。您可以將應用程式連結至其他 GitHub 帳戶。您也可以撤銷與之互 CodeDeploy 動的權限 GitHub。

將 GitHub 帳戶連結至應用程式 CodeDeploy

1. 請登入 AWS Management Console 並開啟 CodeDeploy 主控台，網址為 https://console.aws.amazon.com/codedeploy。

   注意

   使用您設定的相同使用者登入開始使用 CodeDeploy。

2. 在瀏覽窗格中，展開 [部署]，然後選擇 [應用程式]。

3. 選擇您要連結至其他 GitHub帳戶的應用程式。

4. 如果您的應用程式沒有部署群組，請選擇 [建立部署群組] 以建立部署群組。如需詳細資訊，請參閱 建立部署群組 CodeDeploy。部署群組需在後續步驟選擇 Create deployment (建立部署)。

5. 從 Deployments (部署) 選擇 Create deployment (建立部署)。

   注意

   您不必建立新的部署。這是目前將不同 GitHub 帳戶鏈接到應用程序的唯一方法。

6. 在部署設定中，對於修訂類型，選擇我的應用程式儲存於 GitHub。

7. 執行以下任意一項：

   • 若要為 AWS CodeDeploy 應用程式與 GitHub帳戶建立連線，請 GitHub 在個別的網頁瀏覽器標籤中登出。在GitHub 權杖名稱中，輸入識別此連線的名稱，然後選擇 [Connect 線至] GitHub。網頁會提示您授 CodeDeploy權與 GitHub 您的應用程式互動。繼續步驟 10。

   • 若要使用已建立的連線，請在GitHub權杖名稱中選取其名稱，然後選擇 [Connect 線至] GitHub。繼續步驟 8。

   • 若要建立與其他 GitHub 帳戶的連線，請 GitHub 在個別的網頁瀏覽器標籤中登出。在GitHub 權杖名稱中，輸入識別連線的名稱，然後選擇 [Connect 線至] GitHub。網頁會提示您授 CodeDeploy 權與 GitHub 您的應用程式互動。繼續步驟 10。

8. 如果您尚未登入 GitHub，請依照 [登入] 頁面上的指示，使用您要連結應用程式的 GitHub 帳戶登入。

9. 選擇授權應用程式。 GitHub CodeDeploy授與代表所選應用 GitHub 程式的已登入 GitHub 帳戶進行互動的權限。

10. 如果您不想要建立部署，請選擇 Cancel (取消)。

撤銷與之互動 CodeDeploy 的權限 GitHub

1. GitHub 使用您要撤銷 AWS CodeDeploy 權限之 GitHub 帳戶的認證登入。

2. 開啟 [ GitHub 應用程式] 頁面，找出CodeDeploy已授權的應用程式清單，然後遵循撤銷應用 GitHub 程式授權的程序。

CodeDeploy 與私人和公共 GitHub 存儲庫的交互

CodeDeploy 支持從私有和公共 GitHub存儲庫部署應用程序。當您代表您 CodeDeploy 授予存 GitHub 取權限時， CodeDeploy將擁有您 GitHub 帳戶可存取的所有私有 GitHub 儲存庫的讀寫存取權。但是， CodeDeploy 只能從 GitHub 存儲庫中讀取。它不會寫入您的任何私有 GitHub 存儲庫。

CodeDeploy 與組織管理的儲 GitHub 存庫互動

根據預設，由組織管理的 GitHub 儲存庫 (與您帳戶自己的私人或公開儲存庫相反) 不會授予對第三方應用程式的存取權，包括 CodeDeploy. 如果在中啟用組織的協力廠商應用程式限制， GitHub 而您嘗試從其 GitHub 儲存庫部署程式碼，您的部署將會失敗。您有兩個方式可以解決這個問題：

• 身為組織成員，您可以要求組織擁有者核准存取權 CodeDeploy。請求此存取權的步驟取決於您是否已授權 CodeDeploy 個人帳戶：

  • 如果您已授權存取您帳戶 CodeDeploy 中的權限，請參閱要求授權應用程式的組織核准。

  • 如果您尚未授權帳戶 CodeDeploy 中的存取權，請參閱要求組織核准第三方應用程式。

• 機構組織擁有者可以停用所有第三方應用程式的限制。如需詳細資訊，請參閱停用組織的第三方應用程式限制。

有關詳情，請參閱關於第三方應用程式限制。

CodePipeline使用自動部署 CodeDeploy

您可以在原始程式碼變更 CodePipeline 時觸發部署。如需詳細資訊，請參閱 CodePipeline。