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

在中建立建置專案 AWS CodeBuild

您可以使用 AWS CodeBuild 主控台 AWS CLI、或 AWS SDKs來建立組建專案。

必要條件

在建立組建專案之前，請先回答中的問題規劃組建。

建立組建專案 (主控台)

在https://console.aws.amazon.com/codesuite/代碼生成/家中打開 AWS CodeBuild 控制台。

如果顯示 CodeBuild 資訊頁，請選擇 [建立組建專案]。否則，在瀏覽窗格中，展開 [組建]，選擇 [建置專案]，然後選擇 [建立組建專案]。

選擇 Create build project (建立建置專案)。

填寫以下各節。完成後，選擇頁面底部的 [建立建置專案]。

項目配置

來源

Amazon S3

儲存貯體

選擇包含原始程式碼之輸入值區的名稱。

S3 物件金鑰或 S3 資料夾

輸入ZIP檔案名稱或包含原始程式碼之資料夾的路徑。輸入正斜線 (/) 以下載 S3 儲存貯體中的所有項目。

來源版本

輸入代表輸入檔案組建之物件的版本 ID。如需詳細資訊，請參閱 原始碼版本範例 AWS CodeBuild。

CodeCommit

儲存庫

選擇您要使用的存放庫。

參考類型

選擇「分支」、「Git 標籤」或「提交 ID」來指定原始程式碼的版本。如需詳細資訊，請參閱原始碼版本範例 AWS CodeBuild。

注意

我們建議您選擇看起來不像提交的 Git 分支名稱IDs，例如811dd1ba1aba14473856cee38308caed7190c0d或5392f7. 這有助於避免與實際提交的 Git 結帳衝突。

Git 克隆深度

選擇此選項可建立歷程記錄截斷為指定數目的簡易複製。如果您想要完整複製，請選擇 Full (完整)。

Git 子模塊

若您要將 Git 子模組包含在您的儲存庫中，請選擇Use Git submodules (使用 Git 子模組)。

Bitbucket

憑證

選擇 [預設來源認證] 或 [自訂來源認證]，然後依照指示管理預設來源認證或自訂來源認證。

連接類型

選擇CodeConnections、OAuth、應用程式密碼或個人存取權杖來連線 CodeBuild。

Connection (連線)

選取 Bitbucket 連線或秘 Secrets Manager 碼，以透過您指定的連線類型進行連線。

儲存庫

在我的 Bitbucket 帳戶或公共存儲庫中選擇存儲庫，然後輸入存儲庫URL。

來源版本

輸入分支、提交 ID、標籤或參照，以及提交 ID。如需詳細資訊，請參閱 原始碼版本範例 AWS CodeBuild

注意

我們建議您選擇看起來不像提交的 Git 分支名稱IDs，例如811dd1ba1aba14473856cee38308caed7190c0d或5392f7. 這有助於避免與實際提交的 Git 結帳衝突。

Git 克隆深度

選擇 Git clone depth (Git 複製深度)，建立記錄截取至指定遞交數的 Shallow 複製。如果您想要完整複製，請選擇 Full (完整)。

Git 子模塊

若您要將 Git 子模組包含在您的儲存庫中，請選擇Use Git submodules (使用 Git 子模組)。

建置狀態

如果您想要將組建的開始和完成狀態報告給來源提供者，請選取 [在組建開始和完成時向來源提供者報告組建狀態]。

若要能夠向來源提供者報告組建狀態，與來源提供者關聯的使用者必須具有存放庫的寫入存取權。如果使用者沒有寫入權限，則無法更新組建狀態。如需詳細資訊，請參閱來源提供者存取。

針對狀態內容，請在 Bitbucket 認可狀態中輸入要用於name參數的值。如需詳細資訊，請參閱 Bitbucket API 文件中的組建。

針對 Target URL，請在 Bitbucket 認可狀態中輸入要用於url參數的值。如需詳細資訊，請參閱 Bitbucket API 文件中的組建。

由 webhook 觸發的構建狀態始終報告給源提供程序。若要具有從主控台啟動的組建狀態，或向來源提供者回報API呼叫，您必須選取此設定。

如果您的項目的構建是由 webhook 觸發的，則必須將新的提交推送到存儲庫，以使對此設置的更改生效。

如果您想要在每次將程式碼變更推送至此儲存庫時建立原始程式碼，請在 [主 CodeBuild 要來源 webhook 事件] 中選取 [每次程式碼變更推送至此儲存庫時重建]。如需有關 Webhook 和篩選器群組的詳細資訊，請參閱比特桶網絡鉤事件。

GitHub

憑證

選擇 [預設來源認證] 或 [自訂來源認證]，然後依照指示管理預設來源認證或自訂來源認證。

連接類型

選擇要連接的GitHub 應用程序或個人訪問令牌 CodeBuild。OAuth

Connection (連線)

選取 GitHub 連線或 Secrets Manager 碼，以透過您指定的連線類型進行連線。

儲存庫

在我的 GitHub 帳戶，公共存儲庫或GitHub 範圍的 webhook 中選擇存儲庫，然後輸入存儲庫。URL

來源版本

輸入分支、提交 ID、標籤或參照，以及提交 ID。如需詳細資訊，請參閱 原始碼版本範例 AWS CodeBuild

注意

我們建議您選擇看起來不像提交的 Git 分支名稱IDs，例如811dd1ba1aba14473856cee38308caed7190c0d或5392f7. 這有助於避免與實際提交的 Git 結帳衝突。

Git 克隆深度

選擇 Git clone depth (Git 複製深度)，建立記錄截取至指定遞交數的 Shallow 複製。如果您想要完整複製，請選擇 Full (完整)。

Git 子模塊

若您要將 Git 子模組包含在您的儲存庫中，請選擇Use Git submodules (使用 Git 子模組)。

建置狀態

如果您想要將組建的開始和完成狀態報告給來源提供者，請選取 [在組建開始和完成時向來源提供者報告組建狀態]。

若要能夠向來源提供者報告組建狀態，與來源提供者關聯的使用者必須具有存放庫的寫入存取權。如果使用者沒有寫入權限，則無法更新組建狀態。如需詳細資訊，請參閱來源提供者存取。

在「狀態」內容中，輸入要用於 GitHub 確認狀態中context參數的值。如需詳細資訊，請參閱 GitHub 開發人員指南中的建立提交狀態。

在 Target 中URL，輸入 GitHub 確認狀態中要用於target_url參數的值。如需詳細資訊，請參閱 GitHub 開發人員指南中的建立提交狀態。

由 webhook 觸發的構建狀態始終報告給源提供程序。若要具有從主控台啟動的組建狀態，或向來源提供者回報API呼叫，您必須選取此設定。

如果您的項目的構建是由 webhook 觸發的，則必須將新的提交推送到存儲庫，以使對此設置的更改生效。

如果您想要在每次將程式碼變更推送至此儲存庫時建立原始程式碼，請在 [主 CodeBuild 要來源 webhook 事件] 中選取 [每次程式碼變更推送至此儲存庫時重建]。如需有關 Webhook 和篩選器群組的詳細資訊，請參閱GitHub 網絡掛鉤事件。

GitHub Enterprise Server

憑證

選擇 [預設來源認證] 或 [自訂來源認證]，然後依照指示管理預設來源認證或自訂來源認證。

連接類型

選擇CodeConnections或要連接的個人訪問令牌 CodeBuild。

Connection (連線)

選取 GitHub 企業連線或 Secret 管理員密碼，以透過您指定的連線類型進行連線。

儲存庫

在我的 GitHub 企業帳戶或GitHub 企業範圍的 webhook 中選擇存儲庫，然後輸入存儲庫。URL

來源版本

輸入提取請求、分支、提交 ID、標籤或參照，以及提交 ID。如需詳細資訊，請參閱原始碼版本範例 AWS CodeBuild。

注意

我們建議您選擇看起來不像提交的 Git 分支名稱IDs，例如811dd1ba1aba14473856cee38308caed7190c0d或5392f7. 這有助於避免與實際提交的 Git 結帳衝突。

Git 克隆深度

選擇 Git clone depth (Git 複製深度)，建立記錄截取至指定遞交數的 Shallow 複製。如果您想要完整複製，請選擇 Full (完整)。

Git 子模塊

若您要將 Git 子模組包含在您的儲存庫中，請選擇Use Git submodules (使用 Git 子模組)。

建置狀態

如果您想要將組建的開始和完成狀態報告給來源提供者，請選取 [在組建開始和完成時向來源提供者報告組建狀態]。

若要能夠向來源提供者報告組建狀態，與來源提供者關聯的使用者必須具有存放庫的寫入存取權。如果使用者沒有寫入權限，則無法更新組建狀態。如需詳細資訊，請參閱來源提供者存取。

在「狀態」內容中，輸入要用於 GitHub 確認狀態中context參數的值。如需詳細資訊，請參閱 GitHub 開發人員指南中的建立提交狀態。

在 Target 中URL，輸入 GitHub 確認狀態中要用於target_url參數的值。如需詳細資訊，請參閱 GitHub 開發人員指南中的建立提交狀態。

由 webhook 觸發的構建狀態始終報告給源提供程序。若要具有從主控台啟動的組建狀態，或向來源提供者回報API呼叫，您必須選取此設定。

如果您的項目的構建是由 webhook 觸發的，則必須將新的提交推送到存儲庫，以使對此設置的更改生效。

不安全 SSL

選取 [啟用不安全性] 以在連線SSL至您的 GitHub 企業專案儲存庫時忽略SSL警告。

如果您想要在每次將程式碼變更推送至此儲存庫時建立原始程式碼，請在 [主 CodeBuild 要來源 webhook 事件] 中選取 [每次程式碼變更推送至此儲存庫時重建]。如需有關 Webhook 和篩選器群組的詳細資訊，請參閱GitHub 網絡掛鉤事件。

GitLab

憑證

選擇 [預設來源認證] 或 [自訂來源認證]，然後依照指示管理預設來源認證或自訂來源認證。

連接類型

CodeConnections用於連接 GitLab 到 CodeBuild。

Connection (連線)

選取要透過 GitLab 連線的連線 CodeConnections。

儲存庫

選擇您要使用的存放庫。

來源版本

輸入提取請求 ID、分支、提交 ID、標籤或參照，以及提交 ID。如需詳細資訊，請參閱原始碼版本範例 AWS CodeBuild。

注意

我們建議您選擇看起來不像提交的 Git 分支名稱IDs，例如811dd1ba1aba14473856cee38308caed7190c0d或5392f7. 這有助於避免與實際提交的 Git 結帳衝突。

Git 克隆深度

選擇 Git clone depth (Git 複製深度)，建立記錄截取至指定遞交數的 Shallow 複製。如果您想要完整複製，請選擇 Full (完整)。

建置狀態

如果您想要將組建的開始和完成狀態報告給來源提供者，請選取 [在組建開始和完成時向來源提供者報告組建狀態]。

若要能夠向來源提供者報告組建狀態，與來源提供者關聯的使用者必須具有存放庫的寫入存取權。如果使用者沒有寫入權限，則無法更新組建狀態。如需詳細資訊，請參閱來源提供者存取。

GitLab Self Managed

憑證

選擇 [預設來源認證] 或 [自訂來源認證]，然後依照指示管理預設來源認證或自訂來源認證。

連接類型

CodeConnections用於將 GitLab 自我管理連接到 CodeBuild。

Connection (連線)

選取要透過連線的 GitLab 自我管理連線 CodeConnections。

儲存庫

選擇您要使用的存放庫。

來源版本

輸入提取請求 ID、分支、提交 ID、標籤或參照，以及提交 ID。如需詳細資訊，請參閱原始碼版本範例 AWS CodeBuild。

注意

我們建議您選擇看起來不像提交的 Git 分支名稱IDs，例如811dd1ba1aba14473856cee38308caed7190c0d或5392f7. 這有助於避免與實際提交的 Git 結帳衝突。

Git 克隆深度

選擇 Git clone depth (Git 複製深度)，建立記錄截取至指定遞交數的 Shallow 複製。如果您想要完整複製，請選擇 Full (完整)。

建置狀態

如果您想要將組建的開始和完成狀態報告給來源提供者，請選取 [在組建開始和完成時向來源提供者報告組建狀態]。

若要能夠向來源提供者報告組建狀態，與來源提供者關聯的使用者必須具有存放庫的寫入存取權。如果使用者沒有寫入權限，則無法更新組建狀態。如需詳細資訊，請參閱來源提供者存取。

環境

建置規格

Batch 設定

您可以將組建群組當做單一作業執行。如需詳細資訊，請參閱批次執行組建。

成品

日誌

選擇您要建立的記錄檔。您可以建立 Amazon CloudWatch 日誌、Amazon S3 日誌或兩者。

建立建置專案 (AWS CLI)

如需有關使用 AWS CLI 與的詳細資訊 CodeBuild，請參閱命令列參考。

若要使用 CodeBuild 建立組建專案 AWS CLI，您可以建立JSON格式化的專案結構、填入結構，然後呼叫指create-project令來建立專案。

建立檔JSON案

使用以下選項，使用create-project指令建立骨架JSON檔--generate-cli-skeleton案：

aws codebuild create-project --generate-cli-skeleton > <json-file>

這將創建一個JSON具有由指定的路徑和文件名的文件 <json-file>.

填寫檔JSON案

如下所示修改JSON資料並儲存結果。

{
  "name": "<project-name>",
  "description": "<description>",
  "source": {
    "type": "CODECOMMIT" | "CODEPIPELINE" | "GITHUB" | "GITHUB_ENTERPRISE" | "GITLAB" | "GITLAB_SELF_MANAGED" | "BITBUCKET" | "S3" | "NO_SOURCE",
    "location": "<source-location>",
    "gitCloneDepth": "<git-clone-depth>",
    "buildspec": "<buildspec>",
    "InsecureSsl": "<insecure-ssl>",
    "reportBuildStatus": "<report-build-status>",
    "buildStatusConfig": {
      "context": "<context>",
      "targetUrl": "<target-url>"
    },
    "gitSubmodulesConfig": {
      "fetchSubmodules": "<fetch-submodules>"
    },
    "auth": {
      "type": "<auth-type>",
      "resource": "<auth-resource>"
    },
    "sourceIdentifier": "<source-identifier>"
  },
  "secondarySources": [
    {
        "type": "CODECOMMIT" | "CODEPIPELINE" | "GITHUB" | "GITHUB_ENTERPRISE" | "GITLAB" | "GITLAB_SELF_MANAGED" | "BITBUCKET" | "S3" | "NO_SOURCE",
        "location": "<source-location>",
        "gitCloneDepth": "<git-clone-depth>",
        "buildspec": "<buildspec>",
        "InsecureSsl": "<insecure-ssl>",
        "reportBuildStatus": "<report-build-status>",
        "auth": {
          "type": "<auth-type>",
          "resource": "<auth-resource>"
        },
        "sourceIdentifier": "<source-identifier>"
    }
  ],
  "secondarySourceVersions": [
    {
      "sourceIdentifier": "<secondary-source-identifier>",
      "sourceVersion": "<secondary-source-version>"
    }
  ],
  "sourceVersion": "<source-version>",
  "artifacts": {
    "type": "CODEPIPELINE" | "S3" | "NO_ARTIFACTS",
    "location": "<artifacts-location>",
    "path": "<artifacts-path>",
    "namespaceType": "<artifacts-namespacetype>",
    "name": "<artifacts-name>",
    "overrideArtifactName": "<override-artifact-name>",
    "packaging": "<artifacts-packaging>"
  },
  "secondaryArtifacts": [
    {
      "type": "CODEPIPELINE" | "S3" | "NO_ARTIFACTS",
      "location": "<secondary-artifact-location>",
      "path": "<secondary-artifact-path>",
      "namespaceType": "<secondary-artifact-namespaceType>",
      "name": "<secondary-artifact-name>",
      "packaging": "<secondary-artifact-packaging>",
      "artifactIdentifier": "<secondary-artifact-identifier>"
    }
  ],
  "cache": {
    "type": "<cache-type>",
    "location": "<cache-location>",
    "mode": [
      "<cache-mode>"
    ]
  },
  "environment": {
    "type": "LINUX_CONTAINER" | "LINUX_GPU_CONTAINER" | "ARM_CONTAINER" | "WINDOWS_SERVER_2019_CONTAINER" | "WINDOWS_SERVER_2022_CONTAINER",
    "image": "<image>",
    "computeType": "BUILD_GENERAL1_SMALL" | "BUILD_GENERAL1_MEDIUM" | "BUILD_GENERAL1_LARGE" | "BUILD_GENERAL1_2XLARGE",
    "certificate": "<certificate>",
    "environmentVariables": [
      {
        "name": "<environmentVariable-name>",
        "value": "<environmentVariable-value>",
        "type": "<environmentVariable-type>"
      }
    ],
    "registryCredential": [
      {
        "credential": "<credential-arn-or-name>",
        "credentialProvider": "<credential-provider>"
      }
    ],
    "imagePullCredentialsType": "CODEBUILD" | "SERVICE_ROLE",
    "privilegedMode": "<privileged-mode>"
  },
  "serviceRole": "<service-role>",
  "timeoutInMinutes": <timeout>,
  "queuedTimeoutInMinutes": <queued-timeout>,
  "encryptionKey": "<encryption-key>",
  "tags": [
    {
      "key": "<tag-key>",
      "value": "<tag-value>"
    }
  ],
  "vpcConfig": {
    "securityGroupIds": [
         "<security-group-id>"
    ],
    "subnets": [
         "<subnet-id>"
    ],
    "vpcId": "<vpc-id>"
  },
  "badgeEnabled": "<badge-enabled>",
  "logsConfig": {
    "cloudWatchLogs": {
      "status": "<cloudwatch-logs-status>",
      "groupName": "<group-name>",
      "streamName": "<stream-name>"
    },
    "s3Logs": {
      "status": "<s3-logs-status>",
      "location": "<s3-logs-location>",
      "encryptionDisabled": "<s3-logs-encryption-disabled>"
    }
  },
  "fileSystemLocations": [
    {
      "type": "EFS",
      "location": "<EFS-DNS-name-1>:/<directory-path>",
      "mountPoint": "<mount-point>",
      "identifier": "<efs-identifier>",
      "mountOptions": "<efs-mount-options>"
    }
  ],
  "buildBatchConfig": {
    "serviceRole": "<batch-service-role>",
    "combineArtifacts": <combine-artifacts>,
    "restrictions": {
      "maximumBuildsAllowed": <max-builds>,
      "computeTypesAllowed": [
        "<compute-type>"
      ]
    },
    "timeoutInMins": <batch-timeout>,
    "batchReportMode": "REPORT_AGGREGATED_BATCH" | "REPORT_INDIVIDUAL_BUILDS"
  },
  "concurrentBuildLimit": <concurrent-build-limit>
}

取代以下項目：

name

必要。此建置專案的名稱。此名稱在您 AWS 帳戶中的所有建置專案中必須是唯一的。

description

選用。此建置專案的描述。

source

必要。包含此組建專案原始程式碼設定相關資訊的ProjectSource物件。在您新增 source 物件之後，即可使用 secondarySources新增最多 12 個以上的來源。這些設定包含下列項目：

secondarySources

選用。ProjectSource物件陣列，其中包含組建專案之次要來源的相關資訊。您最多可以新增 12 個次要來源。secondarySources物件使用物件所使用的source相同性質。在次要來源物件中，sourceIdentifier是必要的。

secondarySourceVersions

選用。ProjectSourceVersion 物件的陣列。如果在組建層級指定 secondarySourceVersions，則其優先順序會高於此。

sourceVersion

選用。要為此專案建置的組建輸入版本。如果未指定，則會使用最新的版本。如果指定，則必須是以下其中一個：

如果在組建層級指定 sourceVersion，則該版本的優先順序會高於此 sourceVersion (在專案層級)。如需詳細資訊，請參閱原始碼版本範例 AWS CodeBuild。

文物

必要。包含此組建專案輸出成品設定相關資訊的ProjectArtifacts物件。在您新增 artifacts 物件之後，即可使用 secondaryArtifacts新增最多 12 個以上的成品。這些設定包含下列項目：

secondaryArtifacts

選用。ProjectArtifacts物件陣列，其中包含組建專案之次要加工品設定的相關資訊。您可以新增最多 12 個次要成品。secondaryArtifacts 使用 文物 物件所使用的許多相同設定。

快取

必要。包含有關此構建項目緩存設置信息的ProjectCache對象。如需詳細資訊，請參閱快取建置。

環境

必要。包含此專案之建置環境設定相關資訊的ProjectEnvironment物件。這些設定包括：

serviceRole

必要。服務角色 CodeBuild 用來代表使用者與服務互動 (例如，arn:aws:iam::account-id:role/role-name)。ARN

timeoutInMinutes

選用。5 到 2160（36 小時）之間的分鐘數，如果構建未完成，則 CodeBuild停止構建。如果未指定，則會使用預設值 60。若要判斷是否因逾時而 CodeBuild 停止組建，以及何時停止組建，請執行batch-get-builds命令。若要判斷是否已停止建置，請查看 buildStatus 值 FAILED 的輸出。若要判斷組建何時逾時，請查看與 phaseStatus 值 TIMED_OUT 建立關聯之 endTime 值的輸出。

queuedTimeoutIn分鐘

選用。5 到 480 (8 小時) 之間的分鐘數，如果建置仍處於佇列狀態，則 CodeBuild會停止建置。如果未指定，則會使用預設值 60。

encryptionKey

選用。 AWS KMS key 用 CodeBuild 來加密組建輸出ARN的別名或。如果您指定別名，則請使用 arn:aws:kms:region-ID:account-ID:key/key-ID 格式，或者，如果別名已存在，則請使用 alias/key-alias 格式。如果未指定，則會使用 Amazon S3 的 AWS受管KMS金鑰。

標籤

選用。Tag 物件陣列，提供您想要與此建置專案相關聯的標籤。您可以指定最多 50 個標籤。任何支援 CodeBuild 建置專案標籤的 AWS 服務都可以使用這些標記。每個標籤都以帶有key和的物件表示value。

vpcConfig

選用。包VpcConfig含專案VPC組態相關資訊的物件。如需詳細資訊，請參閱搭 AWS CodeBuild 配 Amazon Virtual Private Cloud 使用。

這些屬性包括：

badgeEnabled

選用。指定是否要在 CodeBuild 專案中包含組建徽章。設定為以啟true用組建徽章，或以false其他方式啟用。如需詳細資訊，請參閱建立徽章範例 CodeBuild。

logsConfig

包含此組建記錄檔所在位置之相關資訊的LogsConfig物件。

fileSystemLocations

選用。包含 Amazon 組EFS態相關資訊的ProjectFileSystemsLocation物件陣列。

buildBatchConfig

選用。buildBatchConfig物件是包含專案之批次建置組態資訊的ProjectBuildBatchConfig結構。

concurrentBuildLimit

此專案允許並行建置的最大數量。

只有當目前的建置數量小於或等於此限制時，才會啟動新的建置。如果目前的建置計數符合此限制，則會調節新的建置且不會執行。

建立專案

要創建項目，請再次運行create-project命令，傳遞您的JSON文件：

aws codebuild create-project --cli-input-json file://<json-file>

如果成功，Pro ject 物件的JSON表示會出現在主控台輸出中。如需此資料的範例，請參閱CreateProject 回應語法。

除了建置專案名稱之外，您稍後可以變更任何建置專案設定。如需詳細資訊，請參閱變更建置專案的設定 (AWS CLI)。

若要開始執行建置，請參閱執行建置 (AWS CLI)。

如果您的原始程式碼儲存在儲存 GitHub 庫中，而且您想 CodeBuild 要在每次將程式碼變更推送至儲存庫時重建原始程式碼，請參閱自動開始執行建置 (AWS CLI)。

建立建置專案 (AWS SDKs)

若要取得有關 AWS CodeBuild 與配合使用的資訊 AWS SDKs，請參閱AWS 開發套件和工具參考。

建立建置專案 (AWS CloudFormation)

若要取得有關 AWS CodeBuild 搭配使用的資訊 AWS CloudFormation，請參閱《使AWS CloudFormation 用指南》 CodeBuild中的〈〉的 AWS CloudFormation 樣板。