本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 CloudFormation 設定 Amazon EC2 執行個體
下列程式碼片段示範了如何使用 CloudFormation 設定 Amazon EC2 執行個體。
**Topics**
+ [一般 Amazon EC2 組態](#quickref-ec2-instance-config-general)
+ [指定執行個體的區塊型裝置映射](#scenario-ec2-bdm)
## 一般 Amazon EC2 組態
下列程式碼片段示範了使用 CloudFormation 設定 Amazon EC2 執行個體的一般組態。
**Topics**
+ [在指定的可用區域建立 Amazon EC2 執行個體](#scenario-ec2-instance)
+ [使用 EBS 磁碟區和使用者資料設定標記的 Amazon EC2 執行個體](#scenario-ec2-instance-with-vol-and-tags)
+ [在 Amazon EC2 執行個體啟動的使用者資料中定義 DynamoDB 資料表名稱](#scenario-ec2-with-sdb-domain)
+ [使用 `DeletionPolicy` 建立 Amazon EBS 磁碟區](#scenario-ec2-volume)
### 在指定的可用區域建立 Amazon EC2 執行個體
下列程式碼片段使用 [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-instance.html) 資源，在指定的可用區域建立 Amazon EC2 執行個體。可用區域的代碼為其區域代碼，後續跟著一個字母識別符。您可在單一可用區域啟動執行個體。
#### JSON
```
1. "Ec2Instance": {
2. "Type": "AWS::EC2::Instance",
3. "Properties": {
4. "AvailabilityZone": "aa-example-1a",
5. "ImageId": "ami-1234567890abcdef0"
6. }
7. }
```
#### YAML
```
1. Ec2Instance:
2. Type: AWS::EC2::Instance
3. Properties:
4. AvailabilityZone: aa-example-1a
5. ImageId: ami-1234567890abcdef0
```
### 使用 EBS 磁碟區和使用者資料設定標記的 Amazon EC2 執行個體
下列程式碼片段會建立具有標籤、EBS 磁碟區和使用者資料的 Amazon EC2 執行個體。它會使用 [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-instance.html) 資源。在相同的範本中，您必須定義 [AWS::EC2::SecurityGroup](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-securitygroup.html) 資源、[AWS::SNS::Topic](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-sns-topic.html) 資源和 [AWS::EC2::Volume](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-volume.html) 資源。必須在範本的 `Parameters` 區段中定義 `KeyName`。
標籤可協助您根據您的偏好設定分類 AWS 資源，例如依用途、擁有者或環境。使用者資料允許在啟動期間，將自訂指令碼或資料佈建至執行個體。此資料有助於在初始化期間，對執行個體執行任務自動化、軟體組態設定、套件安裝及其他動作。
如需有關標記您的資源的詳細資訊，請參閱《[Amazon EC2 使用者指南](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html)》中的*標記您的 Amazon EC2 資源*。
如需關於使用者資料的資訊，請參閱《Amazon EC2 使用者指南》**中的[使用執行個體中繼資料管理您的 EC2 執行個體](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)。
#### JSON
```
1. "Ec2Instance": {
2. "Type": "AWS::EC2::Instance",
3. "Properties": {
4. "KeyName": { "Ref": "KeyName" },
5. "SecurityGroups": [ { "Ref": "Ec2SecurityGroup" } ],
6. "UserData": {
7. "Fn::Base64": {
8. "Fn::Join": [ ":", [
9. "PORT=80",
10. "TOPIC=",
11. { "Ref": "MySNSTopic" }
12. ]
13. ]
14. }
15. },
16. "InstanceType": "aa.size",
17. "AvailabilityZone": "aa-example-1a",
18. "ImageId": "ami-1234567890abcdef0",
19. "Volumes": [
20. {
21. "VolumeId": { "Ref": "MyVolumeResource" },
22. "Device": "/dev/sdk"
23. }
24. ],
25. "Tags": [ { "Key": "Name", "Value": "MyTag" } ]
26. }
27. }
```
#### YAML
```
1. Ec2Instance:
2. Type: AWS::EC2::Instance
3. Properties:
4. KeyName: !Ref KeyName
5. SecurityGroups:
6. - !Ref Ec2SecurityGroup
7. UserData:
8. Fn::Base64:
9. Fn::Join:
10. - ":"
11. - - "PORT=80"
12. - "TOPIC="
13. - !Ref MySNSTopic
14. InstanceType: aa.size
15. AvailabilityZone: aa-example-1a
16. ImageId: ami-1234567890abcdef0
17. Volumes:
18. - VolumeId: !Ref MyVolumeResource
19. Device: "/dev/sdk"
20. Tags:
21. - Key: Name
22. Value: MyTag
```
### 在 Amazon EC2 執行個體啟動的使用者資料中定義 DynamoDB 資料表名稱
下列程式碼片段會建立 Amazon EC2 執行個體，並在使用者資料中定義 DynamoDB 資料表名稱，以便在啟動時傳遞至執行個體。它會使用 [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-instance.html) 資源。您可在使用者資料中定義參數或動態值，以便在啟動時傳遞 EC2 執行個體。
如需關於使用者資料的更多資訊，請參閱*《Amazon EC2 使用者指南》*中的[使用執行個體中繼資料管理您的 EC2 執行個體](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)。
#### JSON
```
1. "Ec2Instance": {
2. "Type": "AWS::EC2::Instance",
3. "Properties": {
4. "UserData": {
5. "Fn::Base64": {
6. "Fn::Join": [
7. "",
8. [
9. "TableName=",
10. {
11. "Ref": "DynamoDBTableName"
12. }
13. ]
14. ]
15. }
16. },
17. "AvailabilityZone": "aa-example-1a",
18. "ImageId": "ami-1234567890abcdef0"
19. }
20. }
```
#### YAML
```
1. Ec2Instance:
2. Type: AWS::EC2::Instance
3. Properties:
4. UserData:
5. Fn::Base64:
6. Fn::Join:
7. - ''
8. - - 'TableName='
9. - Ref: DynamoDBTableName
10. AvailabilityZone: aa-example-1a
11. ImageId: ami-1234567890abcdef0
```
### 使用 `DeletionPolicy` 建立 Amazon EBS 磁碟區
下列程式碼片段使用 Amazon EC2 [AWS::EC2::Volume](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-volume.html) 資源來建立 Amazon EBS 磁碟區。您可使用 `Size` 或 `SnapshotID` 屬性來定義磁碟區，但不能同時使用兩者。`DeletionPolicy` 屬性設定為在刪除堆疊時建立磁碟區快照。
如需有關 `DeletionPolicy` 屬性的詳細資訊，請參閱 [DeletionPolicy 屬性](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html)。
如需有關建立 Amazon EBS 磁碟區的詳細資訊，請參閱[建立 Amazon EBS 磁碟區](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-creating-volume.html)。
#### JSON
此程式碼片段會建立具有指定**大小**的 Amazon EBS 磁碟區。大小設定為 10，但您可視需進行調整。[AWS::EC2::Volume](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-volume.html) 資源允許您指定大小或快照 ID，但不能同時指定兩者。
```
1. "MyEBSVolume": {
2. "Type": "AWS::EC2::Volume",
3. "Properties": {
4. "Size": "10",
5. "AvailabilityZone": {
6. "Ref": "AvailabilityZone"
7. }
8. },
9. "DeletionPolicy": "Snapshot"
10. }
```
此程式碼片段使用提供的**快照 ID** 來建立 Amazon EBS 磁碟區。[AWS::EC2::Volume](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-volume.html) 資源允許您指定大小或快照 ID，但不能同時指定兩者。
```
1. "MyEBSVolume": {
2. "Type": "AWS::EC2::Volume",
3. "Properties": {
4. "SnapshotId" : "snap-1234567890abcdef0",
5. "AvailabilityZone": {
6. "Ref": "AvailabilityZone"
7. }
8. },
9. "DeletionPolicy": "Snapshot"
10. }
```
#### YAML
此程式碼片段會建立具有指定**大小**的 Amazon EBS 磁碟區。大小設定為 10，但您可視需進行調整。[AWS::EC2::Volume](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-volume.html) 資源允許您指定大小或快照 ID，但不能同時指定兩者。
```
1. MyEBSVolume:
2. Type: AWS::EC2::Volume
3. Properties:
4. Size: 10
5. AvailabilityZone:
6. Ref: AvailabilityZone
7. DeletionPolicy: Snapshot
```
此程式碼片段使用提供的**快照 ID** 來建立 Amazon EBS 磁碟區。[AWS::EC2::Volume](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-volume.html) 資源允許您指定大小或快照 ID，但不能同時指定兩者。
```
1. MyEBSVolume:
2. Type: AWS::EC2::Volume
3. Properties:
4. SnapshotId: snap-1234567890abcdef0
5. AvailabilityZone:
6. Ref: AvailabilityZone
7. DeletionPolicy: Snapshot
```
## 指定執行個體的區塊型裝置映射
區塊型裝置映射定義區塊型儲存裝置，其中包括要附接至執行個體的執行個體儲存體磁碟區和 EBS 磁碟區。您可在建立 AMI 時指定區塊型裝置映射，如此從 AMI 啟動的所有執行個體都會使用該映射。或者，也可在啟動執行個體時指定區塊型裝置映射，如此該映射會覆寫啟動執行個體之 AMI 中指定的映射。
您可使用下列範本程式碼片段，以使用 [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-instance.html) 資源的 `BlockDeviceMappings` 屬性為 EBS 或執行個體儲存體磁碟區指定區塊型裝置映射。
如需區塊型儲存設備映射的詳細資訊，請參閱《*Amazon EC2 使用者指南*》中的 [Amazon EC2 執行個體上磁碟區的區塊型儲存設備映射](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html)。
**Topics**
+ [為兩個 EBS 磁碟區指定區塊型裝置映射](#w2aac11c41c43c13b9c11)
+ [為執行個體儲存體磁碟區指定區塊型裝置映射](#w2aac11c41c43c13b9c13)
### 為兩個 EBS 磁碟區指定區塊型裝置映射
#### JSON
```
"Ec2Instance": {
"Type": "AWS::EC2::Instance",
"Properties": {
"ImageId": "{{resolve:ssm:/aws/service/ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2}}",
"KeyName": { "Ref": "KeyName" },
"InstanceType": { "Ref": "InstanceType" },
"SecurityGroups": [{ "Ref": "Ec2SecurityGroup" }],
"BlockDeviceMappings": [
{
"DeviceName": "/dev/sda1",
"Ebs": { "VolumeSize": "50" }
},
{
"DeviceName": "/dev/sdm",
"Ebs": { "VolumeSize": "100" }
}
]
}
}
}
```
#### YAML
```
EC2Instance:
Type: AWS::EC2::Instance
Properties:
ImageId: '{{resolve:ssm:/aws/service/ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2}}'
KeyName: !Ref KeyName
InstanceType: !Ref InstanceType
SecurityGroups:
- !Ref Ec2SecurityGroup
BlockDeviceMappings:
-
DeviceName: /dev/sda1
Ebs:
VolumeSize: 50
-
DeviceName: /dev/sdm
Ebs:
VolumeSize: 100
```
### 為執行個體儲存體磁碟區指定區塊型裝置映射
#### JSON
```
"Ec2Instance" : {
"Type" : "AWS::EC2::Instance",
"Properties" : {
"ImageId" : "{{resolve:ssm:/aws/service/ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2}}",
"KeyName" : { "Ref" : "KeyName" },
"InstanceType": { "Ref": "InstanceType" },
"SecurityGroups" : [{ "Ref" : "Ec2SecurityGroup" }],
"BlockDeviceMappings" : [
{
"DeviceName" : "/dev/sdc",
"VirtualName" : "ephemeral0"
}
]
}
}
```
#### YAML
```
EC2Instance:
Type: AWS::EC2::Instance
Properties:
ImageId: '{{resolve:ssm:/aws/service/ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2}}'
KeyName: !Ref KeyName
InstanceType: !Ref InstanceType
SecurityGroups:
- !Ref Ec2SecurityGroup
BlockDeviceMappings:
- DeviceName: /dev/sdc
VirtualName: ephemeral0
```