必要條件步驟 1：編輯來源檔案步驟 2：建立管道步驟 3：將儲存庫與 CodeGuru 複查者建立關聯

開始使用連線

開始使用連接的最簡單方法是設置將第三方源存儲庫與您的 AWS 資源相關聯的連接。如果您想要將管線連接至 AWS 來源，例如 CodeCommit，您可以連線至該來源作為來源動作。但是如果您有外部儲存庫，則必須建立連線來為儲存庫與管道建立關聯。在本教學課程中，您將設定與您的 Bitbucket 儲存庫和管道間的連線。

在本節中，您會透過下列項目使用連線：

AWS CodePipeline：在這些步驟中，您可以使用 Bitbucket 儲存庫做為管道來源建立管道。
Amazon CodeGuru 審核者：接下來，您將 Bitbucket 儲存庫與審核者中 CodeGuru 的意見反應和分析工具建立關聯。

必要條件

開始之前，請完成設定中的步驟。您還需要一個協力廠商來源儲存庫，以連線至您的 AWS 服務，並允許連線為您管理驗證。例如，您可能想要將 Bitbucket 儲存庫連接到與來源儲存庫整合的 AWS 服務。

使用您的 Bitbucket 帳戶建立一個 Bitbucket 儲存庫。
準備好您的 Bitbucket 憑證。當您使用設 AWS Management Console 定連線時，系統會要求您使用 Bitbucket 認證登入。

步驟 1：編輯來源檔案

建立 Bitbucket 儲存庫時會內含一個預設的 README.md 檔案，您需編輯這個檔案。

登入您的 Bitbucket 儲存庫並選擇 Source (來源)。
選擇 README.md 檔案並選擇頁面頂端的 Edit (編輯)。刪除現有的文字，並新增下列文字。
```
This is a Bitbucket repository!
```
選擇 Commit (遞交)。

確定 README.md 檔案位於儲存庫的根層級。

步驟 2：建立管道

在本節中，您可以採取下列動作建立管道：

使用連至 Bitbucket 儲存庫和動作的連線之來源階段。
包含建置動作的 AWS CodeBuild 建置階段。

使用精靈建立管道

請在以下位置登入 CodePipeline 主控台：https://console.aws.amazon.com/codepipeline/。
在 Welcome (歡迎) 頁面、Getting started (入門) 頁面、或者 Pipelines (管道) 頁面上，選擇 Create pipeline (建立管道)。
在 Step 1: Choose pipeline settings (步驟 1：選擇管道設定) 的 Pipeline name (管道名稱) 中，輸入 MyBitbucketPipeline。
在 Service role (服務角色) 中，選擇 New service role (新服務角色)。

注意
如果您改為選擇使用現有的 CodePipeline 服務角色，請確定已將 codeconnections:UseConnection IAM 權限新增至服務角色政策。如需 CodePipeline 服務角色的指示，請參閱將權限新增至 CodePipeline 服務角色。
在進階設定底下，請保留預設值。在Artifact store (成品存放區) 中，針對您為管道所選取區域中的管道，選擇 Default location (預設位置)，即可使用預設成品存放區 (例如指定為預設值的 Amazon S3 成品儲存貯體)。

注意
這不是原始碼的來源儲存貯體。這是管道的成品存放區。每個管道都需要有個別成品存放區，例如 S3 儲存貯體。

選擇 Next (下一步)。
在 Step 2: Add source stage (步驟 2：新增來源階段) 頁面上，新增來源階段：
1. 在 Source provider (來源供應商) 中，選擇 Bitbucket。
2. 在 Connection (連線) 底下，選擇 Connect to Bitbucket (連線至 Bitbucket)。
3. 在 Connect to Bitbucket (連線至 Bitbucket) 頁面的 Connection name (連線名稱) 中，輸入您要建立的連線名稱。此名稱可協助您稍後識別此連線。
  
  在 Bitbucket apps (Bitbucket 應用程式) 底下中，選擇 Install a new app (安裝新應用程式)。
4. 在應用程式安裝頁面上，會有訊息顯示 AWS CodeStar 應用程式正在嘗試連線至您的 Bitbucket 帳戶。選擇 Grant access (授與存取權)。授權連線之後，就會偵測到您在 Bitbucket 上的儲存庫，您可以選擇將一個儲存庫與您的 AWS 資源建立關聯。
5. 隨即顯示新安裝的連線 ID。選擇 Complete connection (完成連線)。您將返回 CodePipeline控制台。
6. 在 Repository name (儲存庫名稱) 中，選擇 Bitbucket 儲存庫的名稱。
7. 在 Branch name (分支名稱) 中，選擇儲存庫的分支。
8. 請確認已選取在原始程式碼變更時啟動管道選項。
9. 在「輸出人工因素格式」下，選擇下列其中一項：CodePipeline 預設值。
  - 選擇CodePipeline 預設值，以針對管線中的人工因素使用預設 zip 格式。
  - 選擇完整複製，以包含與管道中成品的儲存庫相關的 Git 中繼資料。只有 CodeBuild動作才支援此功能。
選擇 Next (下一步)。
在 Add build stage (新增建置階段) 中，新增建置階段：
1. 在 Build provider (建置供應商) 中，選擇 AWS CodeBuild。允許 Region (區域) 預設為管道區域。
2. 選擇建立專案。
3. 在 Project name (專案名稱) 中，輸入此建置專案的名稱。
4. 在 Environment image (環境映像) 中，選擇 Managed image (受管映像)。針對 Operating system (作業系統)，選擇 Ubuntu。
5. 針對 Runtime (執行時間)，選擇 Standard (標準)。針對映像，選擇 aws/codebuild/standard:5.0。
6. 對於 Service role (服務角色)，選擇 New service role (新服務角色)。
7. 在 BuildSpec 底下，針對 Build specifications (建置規格) 選擇 Insert build commands (插入建置命令)。選擇 Switch to editor (切換到編輯器)，並將下方內容貼到 Build commands (建置命令) 底下：
```
version: 0.2

phases:
  install:
    #If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
    #If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
    runtime-versions:
      nodejs: 12
      # name: version
    #commands:
      # - command
      # - command
  pre_build:
    commands:
      - ls -lt
      - cat README.md
  # build:
    #commands:
      # - command
      # - command
  #post_build:
    #commands:
      # - command
      # - command
#artifacts:
  #files:
    # - location
    # - location
  #name: $(date +%Y-%m-%d)
  #discard-paths: yes
  #base-directory: location
#cache:
  #paths:
    # - paths
```
8. 選擇繼續 CodePipeline。這將返回到 CodePipeline控制台並創建一個使用構建命令進行配置的 CodeBuild 項目。組建專案會使用服務角色來管理 AWS 服務權限。此步驟可能需要數分鐘。
9. 選擇下一步。
在 Step 4: Add deploy stage (步驟 4：新增部署階段) 頁面上，選擇 Skip deploy stage (跳過部署階段)，然後再次選擇 Skip (跳過) 來接受警告訊息。選擇下一步。
在 Step 5: Review (步驟 5：檢閱) 上，選擇 Create pipeline (建立管道)。
成功建立管道後，管道就會開始執行。
在成功的建置階段上，選擇 Details (詳細資訊)。

在 [執行詳細資料] 底下，檢視 CodeBuild 組建輸出。這些命令會輸出 README.md 檔案內容，如下所示：
```
This is a Bitbucket repository!
```

步驟 3：將儲存庫與 CodeGuru 複查者建立關聯

建立連線後，您可以將該連線用於同一帳戶中的所有 AWS 資源。例如，您可以針對管線中的 CodePipeline 來源動作使用相同的 Bitbucket 連線，並在 CodeGuru 審核者中使用儲存庫提交分析。

登入 CodeGuru 審核者主控台。
在CodeGuru 複查者下，選擇關聯儲存庫。

隨即會開啟單頁式精靈。
在 Select source provider (選取來源提供程式) 底下，選擇 Bitbucket。
在 Connect 到 Bitbucket（使用 AWS CodeConnections）下，選擇您為管道創建的連接。
在 Repository location (儲存庫位置) 底下，選擇 Bitbucket 儲存庫的名稱，然後選擇 Associate (建立關聯)。

您可以繼續設定程式碼檢閱。如需詳細資訊，請參閱 Amazon CodeGuru 審核者使用指南中的連線到 Bitbucket 以將儲存庫與 CodeGuru 審核者建立關聯。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

設定連線

使用連線