本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CloudFormation 範本格式
您可以撰寫 JSON或 YAML 格式的 CloudFormation 範本。這兩種格式都具有相同的用途,但在可讀性和複雜性方面提供不同的優勢。
-
JSON – JSON 是一種輕量型資料交換格式,可讓機器輕鬆剖析和產生。不過,人類讀取和寫入可能會變得很麻煩,尤其是複雜組態。在 中JSON,範本使用巢狀括弧
{}
和括號來建構,[]
以定義資源、參數和其他元件。其語法需要明確宣告每個元素,這可讓範本變得詳細,但可確保嚴格遵守結構化格式。 -
YAML – YAML 的設計比 更人類可讀且詳細JSON。它使用縮排而非括號來表示巢狀,這可以更輕鬆地視覺化資源和參數的階層。 YAML通常偏好其清晰度和易用性,特別是在處理更複雜的範本時。不過,如果間距不一致, YAML對縮排的依賴可能會導致錯誤,這需要謹慎維護準確性。
範本結構
CloudFormation 範本分為不同的區段,每個區段的設計都是為了保存特定類型的資訊。有些區段必須以特定順序宣告,而對於其他區段,順序並不重要。不過,當您建置範本時,使用下列範例中顯示的邏輯順序會很有幫助,因為一個區段中的值可能會參考上一節中的值。
撰寫範本時,請勿使用重複的主要區段,例如 Resources
區段。雖然 CloudFormation 可能接受範本,但處理範本時會有未定義的行為,而且可能不會正確佈建資源,或傳回無法解釋的錯誤。
JSON
下列範例顯示 JSON格式化範本的結構,其中包含所有可用的區段。
{ "AWSTemplateFormatVersion" : "
version date
", "Description" : "JSON string
", "Metadata" : {template metadata
}, "Parameters" : {set of parameters
}, "Rules" : {set of rules
}, "Mappings" : {set of mappings
}, "Conditions" : {set of conditions
}, "Transform" : {set of transforms
}, "Resources" : {set of resources
}, "Outputs" : {set of outputs
} }
YAML
下列範例顯示 YAML格式化範本的結構,其中包含所有可用的區段。
--- AWSTemplateFormatVersion:
version date
Description:String
Metadata:template metadata
Parameters:set of parameters
Rules:set of rules
Mappings:set of mappings
Conditions:set of conditions
Transform:set of transforms
Resources:set of resources
Outputs:set of outputs
說明
在 JSON格式化範本中,不支援註解。JSON根據設計, 不包含註解的語法,這表示您無法直接在JSON結構中新增註解。不過,如果您需要包含解釋性備註或文件,您可以考慮新增中繼資料。如需詳細資訊,請參閱Metadata 屬性。
在 YAML格式化範本中,您可以使用 #
符號包含內嵌註解。
下列範例顯示具有內嵌註解的YAML範本。
AWSTemplateFormatVersion: 2010-09-09 Description: A sample CloudFormation template with YAML comments. # Resources section Resources: MyEC2Instance: Type: AWS::EC2::Instance Properties: # Linux AMI ImageId: ami-1234567890abcdef0 InstanceType: t2.micro KeyName: MyKey BlockDeviceMappings: - DeviceName: /dev/sdm Ebs: VolumeType: io1 Iops: 200 DeleteOnTermination: false VolumeSize: 20
規格
CloudFormation 支援下列 JSON 和 YAML 規格:
- JSON
-
CloudFormation 遵循 ECMA-404 JSON標準。如需 JSON 格式的詳細資訊,請參閱 https://http://www.json.org
。 - YAML
-
CloudFormation 支援 1.1 YAML版規格,但有少數例外。 CloudFormation 不支援下列功能:
-
binary
、omap
、pairs
、set
和timestamp
標籤 -
Aliases
-
雜湊合併
如需 的詳細資訊YAML,請參閱 https://https://yaml.org/
。 -
進一步了解
對於您在範本中指定的每個資源,您可以使用 JSON或 的特定語法規則來定義其屬性和值YAML。如需每種格式之範本語法的詳細資訊,請參閱CloudFormation 範本區段。