終止支援通知：2026 年 10 月 7 日 AWS 將終止 的支援 AWS Proton。2026 年 10 月 7 日之後，您將無法再存取 AWS Proton 主控台或 AWS Proton 資源。您部署的基礎設施將保持不變。如需詳細資訊，請參閱[AWS Proton 服務棄用和遷移指南](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html)。

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

# CodeBuild 佈建參數詳細資訊和範例
<a name="parameters-codebuild"></a>

您可以在 CodeBuild 型 AWS Proton 資源的範本中定義參數，並在佈建程式碼中參考這些參數。如需 AWS Proton 參數、參數類型、參數命名空間，以及如何在 IaC 檔案中使用參數的詳細說明，請參閱 [AWS Proton 參數](parameters.md)。

**注意**  
您可以搭配環境和服務使用 CodeBuild 佈建。目前您無法以這種方式佈建元件。

## 輸入參數
<a name="parameters-codebuild.input"></a>

當您建立 AWS Proton 資源時，例如環境或服務，您可以為範本[結構描述檔案中](ag-schema.md)定義的輸入參數提供值。當您建立的資源使用 時[CodeBuild 佈建](ag-works-prov-methods.md#ag-works-prov-methods-codebuild)， 會將這些輸入值 AWS Proton 轉譯為輸入檔案。您的佈建程式碼可以從此檔案匯入和取得參數值。

如需 CodeBuild 範本的範例，請參閱 [CodeBuild 佈建範本套件](ag-infrastructure-tmp-files-codebuild.md)。如需資訊清單檔案的相關資訊，請參閱[後續處理 的範本檔案 AWS Proton](ag-wrap-up.md)。

下列範例是在服務執行個體的 CodeBuild 型佈建期間產生的 JSON 輸入檔案。

### 範例： AWS CDK 搭配 CodeBuild 佈建使用
<a name="parameters-codebuild.example"></a>

```
{
  "service_instance": {
    "name": "my-service-staging",
    "inputs": {
      "port": "8080",
      "task_size": "medium"
    }
  },
  "service": {
    "name": "my-service"
  },
  "environment": {
    "account_id": "123456789012",
    "name": "my-env-staging",
    "outputs": {
      "vpc-id": "hdh2323423"
    }
  }
}
```

## 輸出參數
<a name="parameters-codebuild.output"></a>

若要將資源佈建輸出傳回給 AWS Proton，您的佈建程式碼可以產生名為 的 JSON 檔案`proton-outputs.json`，其中包含範本[結構描述檔案中](ag-schema.md)定義的輸出參數值。例如， `cdk deploy`命令具有 `--outputs-file`引數，指示 使用佈建輸出 AWS CDK 產生 JSON 檔案。如果您的資源使用 AWS CDK，請在 CodeBuild 範本資訊清單中指定下列命令：

```
aws proton notify-resource-deployment-status-change
```

AWS Proton 會尋找此 JSON 檔案。如果檔案在佈建程式碼成功完成之後存在， 會從中 AWS Proton 讀取輸出參數值。