包裝的範本檔案AWS Proton - AWS Proton

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

包裝的範本檔案AWS Proton

準備您的環境和服務基礎結構作為代碼(IaC)文件及其各自的模式文件後,您必須將它們組織在目錄中。您也必須建立資訊清單 YAML 檔案。清單文件列出了目錄中的 IaC 文件,渲染引擎,以及用於在此模板中開發 IaC 的模板語言。

注意

清單文件也可以獨立於模板包使用,作為直接輸入直接定義的元件。在這種情況下,它總是為兩者指定單個 IaC 模板文件 CloudFormation 及 Terraform。如需的詳細資訊,請參閱AWS Proton 元件

資訊清單檔案必須遵守下列範例所示的格式和內容。

CloudFormation 資訊清單檔案格式:

搭配 CloudFormation,您會列出單一檔案。

infrastructure: templates: - file: "cloudformation.yaml" rendering_engine: jinja template_language: cloudformation

地形清單文件格式:

使用 terraform,您可以明確列出單個文件或使用通配符*列出目錄中的每個檔案。

注意

萬用字元只包含名稱結尾為的檔案.tf。忽略其他檔案。

infrastructure: templates: - file: "*" rendering_engine: hcl template_language: terraform

為您的環境或服務範本套件組合設定目錄和資訊清單檔案後,您可以將目錄壓縮為 Amazon Simple Storage Service (Amazon S3) 儲存貯體,在那裡AWS Proton可以檢索它們。

當您建立註冊的環境或服務範本的次要版本時AWS Proton,您可以提供位於 S3 儲存貯體中的環境或服務範本捆綁焦油球的路徑。AWS Proton將其與新範本次要版本一起儲存。您可以選擇新的模板次要版本來創建或更新環境或服務AWS Proton。

環境範本包裝

您為其建立兩種類型的環境範本套件AWS Proton。

  • 建立環境範本套件標準環境模板,組織架構,基礎設施作為代碼(IaC)文件和清單文件目錄中顯示在下面的環境模板捆綁目錄結構。

  • 建立環境範本套件客戶受管理環境範本,僅提供綱要檔案和目錄。Don't包括基礎架構目錄和檔案。AWS Proton如果包含基礎結構目錄和檔案,則會擲回錯誤。

如需詳細資訊,請參閱 註冊和發佈範本

CloudFormation 環境模板包目錄結構:

/schema schema.yaml /infrastructure manifest.yaml cloudformation.yaml

地形環境模板捆綁目錄結構:

/schema schema.yaml /infrastructure manifest.yaml environment.tf

服務模板捆綁包裝

若要建立服務範本套裝軟體,您必須將結構描述、基礎結構即程式碼 (IaC) 檔案以及資訊清單檔案組織到目錄中,如服務範本組合包目錄結構範例所示。

如果您不要在模板包中包含服務管道,Don't包括管線目錄和文件並設置"pipelineProvisioning": "CUSTOMER_MANAGED"當您建立要與此範本組合關聯的服務範本時。

注意

您無法修改pipelineProvisioning建立服務範本之後。

如需詳細資訊,請參閱 註冊和發佈範本

CloudFormation 服務範本包目錄結構:

/schema schema.yaml /instance_infrastructure manifest.yaml cloudformation.yaml /pipeline_infrastructure manifest.yaml cloudformation.yaml

地形服務模板捆綁目錄結構:

/schema schema.yaml /instance_infrastructure manifest.yaml instance.tf /pipeline_infrastructure manifest.yaml pipeline.tf