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

# 將 GitHub 設定為組態來源
<a name="cfct-github-configuration-source"></a>

本節說明如何使用 GitHub 做為來源來部署 AWS Control Tower (CfCT) 的自訂。程序有三個主要步驟：
+ 準備 GitHub 儲存庫
+ 建立 GitHub 程式碼連線
+ 部署 CloudFormation 堆疊

## 準備 GitHub 儲存庫
<a name="prepare-github-cfct-source"></a>

 在 GitHub 帳戶中建立儲存庫，範本中使用的預設名稱為 `custom-control-tower-configuration`。考慮將目標儲存庫設為*私有*。您將在 CfCT 儲存庫`manifest.yaml`的[部署資料夾中](https://github.com/aws-solutions/aws-control-tower-customizations/tree/main/deployment)名為 的`yaml`檔案中定義自訂項目。

[https://docs.aws.amazon.com//controltower/latest/userguide/cfct-customizations-dev-guide.html](https://docs.aws.amazon.com//controltower/latest/userguide/cfct-customizations-dev-guide.html)提供有關建立 `manifest.yaml`以設定自訂的詳細指導。

## 建立 GitHub 對流
<a name="create-github-cfct-connection"></a>

從適用於 Github **的開發人員工具 --Connections** 執行個體中，執行下列步驟：

1. 選取**建立連線**，然後選擇 GitHub 做為提供者

1. 選擇**建立 GitHub 應用程式連線**，然後在**連線名稱**欄位中輸入 **GitHub CfCT** 或您選擇的任何名稱

1. 選取**連線至 GitHub**，然後選擇**安裝新的應用程式**

1. 為您的儲存庫選取 GitHub 使用者或組織

1. 在**儲存庫存取**下，選擇**僅選取儲存庫**，然後選取您先前建立的儲存庫，然後**儲存**您的工作。

1. 請注意程式碼連線 ARN - 部署 CloudFormation 堆疊時需要它。

## 部署 CloudFormation 堆疊
<a name="deploy-github-cfct-stack"></a>
+ 從儲存庫下載 `custom-control-tower-initiation.template` 檔案。
+ 使用 `custom-control-tower-initiation.template` 檔案建立新的 CloudFormation 堆疊。
+ 在 **AWS CodePipeline Source** 下，選擇 **GitHub （透過 Code Connection)**。
+ 在 **GitHub 設定**下，指定下列欄位：
  + 對於**程式碼連線的 ARN**，請提供程式碼連線 ARN
  + 對於 **GitHub 使用者或組織**，請提供您建立儲存庫的 GitHub 使用者或組織的名稱
  + 針對 **GitHub 儲存庫名稱**，輸入儲存庫名稱 （預設為 `custom-control-tower-configuration`)
  + 對於 **GitHub 分支名稱**，輸入分支名稱 （預設為 `main`)