CodeBuild 佈建參數詳細資料和範例

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

注意

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

輸入參數

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

如需範本的 CodeBuild 範例，請參閱CodeBuild 佈建範本套件。如需資訊清單檔案的相關資訊，請參閱包裝的範本檔案 AWS Proton。

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

範例：使用 AWS CDK 與 CodeBuild 佈建

{
  "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"
    }
  }
}

輸出參數

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

aws proton notify-resource-deployment-status-change

AWS Proton 查找這個 JSON 文件。如果在佈建程式碼順利完成後存在該檔案，請從中 AWS Proton 讀取輸出參數值。