本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CodeBuild 佈建參數詳細資料和範例
您可以在範本中為 CodeBuild基礎的 AWS Proton 資源定義參數,並在佈建程式碼中參考這些參數。如需參數、參數類型、 AWS Proton 參數命名空間以及如何在 IaC 檔案中使用參數的詳細說明,請參閱AWS Proton 參數。
注意
您可以將 CodeBuild 佈建與環境和服務搭配使用。目前您無法以這種方式佈建元件。
輸入參數
當您建立 AWS Proton 資源 (例如環境或服務) 時,您可以為範本結構描述檔中定義的輸入參數提供值。當您建立的資源使用時CodeBuild佈建,會將這些輸入值 AWS Proton 轉譯為輸入檔案。您的佈建程式碼可以從此檔案匯入和取得參數值。
如需範本的 CodeBuild 範例,請參閱CodeBuild 佈建範本套件。如需資訊清單檔案的相關資訊,請參閱包裝的範本檔案 AWS Proton。
下列範例是在服務執行個體佈建期間 CodeBuild產生的 JSON 輸入檔案。
{
"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 讀取輸出參數值。