多個輸入來源和輸出成品範例

您可以 AWS CodeBuild 建立包含多個輸入來源和多組輸出成品的組建專案。這個範例示範如何設定如下的組建專案：

• 使用不同類型的多個來源和儲存庫。

• 在單一建置中將建置成品發佈至多個 S3 儲存貯體。

在此範例中，您會建立組建專案並用來執行組建。此範例使用組建專案的 buildspec 檔案，示範如何納入多個來源並建立多組成品。

1. 將您的來源上傳到一或多個 S3 儲存貯體 CodeCommit、 GitHub、 GitHub 企業伺服器或 Bitbucket 儲存庫。

2. 選擇哪個來源是主要來源。這是查 CodeBuild 找並運行構建規格文件的源代碼。

3. 建立建置專案。如需詳細資訊，請參閱 在 AWS CodeBuild 中建立建置專案。

4. 創建您的構建項目，運行構建，並獲取有關構建的信息。

5. 如果您使 AWS CLI 用建立組建專案，create-project指令的 JSON 格式輸入可能會類似下列內容：

   {
     "name": "sample-project",
     "source": {
       "type": "S3",
       "location": "<bucket/sample.zip>"
     },
     "secondarySources": [
       {
         "type": "CODECOMMIT",
         "location": "https://git-codecommit.us-west-2.amazonaws.com/v1/repos/repo",
         "sourceIdentifier": "source1"
       },
       {
         "type": "GITHUB",
         "location": "https://github.com/awslabs/aws-codebuild-jenkins-plugin",
         "sourceIdentifier": "source2"
       }
     ],
     "secondaryArtifacts": [ss
       {
         "type": "S3",
         "location": "<output-bucket>",
         "artifactIdentifier": "artifact1"
       },
       {
         "type": "S3",
         "location": "<other-output-bucket>",
         "artifactIdentifier": "artifact2"
       }
     ],
     "environment": {
       "type": "LINUX_CONTAINER",
       "image": "aws/codebuild/standard:5.0",
       "computeType": "BUILD_GENERAL1_SMALL"
     },
     "serviceRole": "arn:aws:iam::account-ID:role/role-name",
     "encryptionKey": "arn:aws:kms:region-ID:account-ID:key/key-ID"
   }

您的主要來源是在 source 屬性下方定義。其他所有來源稱為次要來源，出現在 secondarySources 下方。所有次要來源安裝在其自己的目錄中。此目錄存放在內建環境變數 CODEBUILD_SRC_DIR_sourceIdentifer 中。如需詳細資訊，請參閱 建置環境中的環境變數。

secondaryArtifacts 屬性包含成品定義清單。這些成品使用 buildspec 檔案的 secondary-artifacts 區塊 (巢狀於 artifacts 區塊內)。

buildspec 檔案中的次要成品具有與成品相同的結構，且依成品識別符區隔。

注意

在 CodeBuild API 中，次要成品artifactIdentifier上是和中的必要屬CreateProject性UpdateProject。必須用來參考次要成品。

使用前述的 JSON 格式輸入時，專案的 buildspec 檔案可能如下所示：

version: 0.2

phases:
  install:
    runtime-versions:
      java: openjdk11
  build:
    commands:
      - cd $CODEBUILD_SRC_DIR_source1
      - touch file1
      - cd $CODEBUILD_SRC_DIR_source2
      - touch file2

artifacts:
  files:
    - '**.*'
  secondary-artifacts:
    artifact1:
      base-directory: $CODEBUILD_SRC_DIR_source1
      files:
        - file1
    artifact2:
      base-directory: $CODEBUILD_SRC_DIR_source2
      files:
        - file2

您可以使用 API 搭配 StartBuild 中的 sourceVersion 屬性，以覆寫主要來源的版本。若要覆寫一個或多個次要來源版本，請使用 secondarySourceVersionOverride 屬性。

中start-build指令的 JSON 格式輸入 AWS CLI 可能如下所示：

{
   "projectName": "sample-project",
   "secondarySourcesVersionOverride": [
      {
        "sourceIdentifier": "source1",
        "sourceVersion": "codecommit-branch"
      },
      {
        "sourceIdentifier": "source2",
        "sourceVersion": "github-branch"
      },
   ]
}

無來源的專案範例

您可以在設定來源時選擇NO_SOURCE來源類型來配置 CodeBuild 專案。當來源類型為 NO_SOURCE 時，您將無法指定 buildspec 檔案，因為專案並無任何來源。相反地，您必須在 create-project CLI 命令的 JSON 格式輸入的 buildspec 屬性中指定 YAML 格式 buildspec 字串。這看起來類似下述：

{
  "name": "project-name",
  "source": {
    "type": "NO_SOURCE",
    "buildspec": "version: 0.2\n\nphases:\n  build:\n    commands:\n      - command"
   },
  "environment": {
    "type": "LINUX_CONTAINER",
    "image": "aws/codebuild/standard:5.0",
    "computeType": "BUILD_GENERAL1_SMALL",    
  },
  "serviceRole": "arn:aws:iam::account-ID:role/role-name",
  "encryptionKey": "arn:aws:kms:region-ID:account-ID:key/key-ID"
}

如需詳細資訊，請參閱 建立建置專案 (AWS CLI)。

若要瞭解如何建立使用多個來源輸入來 CodeBuild 建立多個輸出成品的管道，請參閱AWS CodePipeline 與多個輸入來源 CodeBuild 和輸出假影範例整合 。