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

# CloudFormation CodeDeploy 參考的 範本
<a name="reference-cloudformation-templates"></a>

本節介紹專為使用 CodeDeploy 部署而設計 CloudFormation 的資源、轉換和勾點。如需建立由 CodeDeploy CloudFormation 掛鉤管理之堆疊更新的逐步解說，請參閱 [透過 建立 Amazon ECS 藍/綠部署 CloudFormation](deployments-create-ecs-cfn.md)

**注意**  
CloudFormation 勾點是 CloudFormation 元件的一部分， AWS 與 CodeDeploy 生命週期事件勾點不同。

除了 CodeDeploy 中可用的其他方法之外，您還可以使用 CloudFormation 範本來執行下列任務：
+ 建立應用程式。
+ 建立部署群組，並指定目標修訂版。
+ 建立部署組態。
+ 建立 Amazon EC2 執行個體。

CloudFormation 是一項服務，可協助您使用 範本建立和設定 AWS 資源的模型。 CloudFormation 範本是格式符合 JSON 標準的文字檔案。您可以建立範本來描述您想要的所有 AWS 資源，並 CloudFormation 負責為您佈建和設定這些資源。

如需詳細資訊，請參閱[什麼是 AWS CloudFormation？](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) 和 [使用者指南中的使用 AWS CloudFormation 範本](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html)。 *AWS CloudFormation *

如果您計劃使用與組織中 CodeDeploy 相容的 CloudFormation 範本，身為管理員，您必須將存取權授予 CloudFormation 和 CloudFormation 依存的 AWS 服務和動作。若要授予建立應用程式、部署群組和部署組態的許可，請將下列政策新增至將使用之使用者的許可集 CloudFormation：

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [                
        "cloudformation:*"        
      ],
      "Resource": "*"
    }
  ]
}
```

------

如需政策的詳細資訊，請參閱下列主題：
+ 若要檢視必須新增至建立 Amazon EC2 執行個體之使用者許可集的政策，請參閱 [為 CodeDeploy 建立 Amazon EC2 執行個體 (CloudFormation 範本）](instances-ec2-create-cloudformation-template.md)。
+ 如需有關將政策新增至許可集的資訊，請參閱《*IAM 使用者指南*》中的[建立許可集](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtocreatepermissionset.html)。
+ 若要了解如何將使用者限制為一組有限的 CodeDeploy 動作和資源，請參閱 [AWS CodeDeploy 的 受管 （預先定義） 政策](managed-policies.md)。

下表顯示 CloudFormation 範本可代表您執行的動作，並包含可新增至 CloudFormation 範本之 AWS 資源類型及其屬性類型的詳細資訊連結。


<table>
<thead>
  <tr><th>Action</th><th> CloudFormation 參考 </th><th>參考類型</th></tr>
</thead>
<tbody>
  <tr><td>建立 CodeDeploy 應用程式。</td><td>[AWS::CodeDeploy::application](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-application.html)</td><td>CloudFormation 資源</td></tr>
  <tr><td>建立並指定要用來部署應用程式修訂版之部署群組的詳細資訊。1</td><td>[AWS::CodeDeploy::DeploymentGroup](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-deploymentgroup.html)</td><td>CloudFormation 資源</td></tr>
  <tr><td>建立一組部署規則、部署成功條件，以及 CodeDeploy 在部署期間將使用的部署失敗條件。</td><td>[AWS::CodeDeploy::DeploymentConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-deploymentconfig.html)</td><td>CloudFormation 資源</td></tr>
  <tr><td>建立 Amazon EC2 執行個體。2</td><td>[AWS::EC2::instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html)</td><td>CloudFormation 資源</td></tr>
  <tr><td rowspan="2">使用 CloudFormation AWS::CodeDeployBlueGreen轉換和AWS::CodeDeploy::BlueGreen掛鉤來管理 CodeDeploy 藍/綠部署的堆疊更新、建立資源和轉移流量。3</td><td>[AWS::CodeDeployBlueGreen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html)</td><td>該 AWS::CodeDeployBlueGreen 轉換是由 CloudFormation 託管的巨集</td></tr>
  <tr><td>[AWS::CodeDeploy::BlueGreen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html)</td><td>AWS::CodeDeploy::BlueGreen 勾點結構為 中的Hook資源 CloudFormation。勾點包含參數，透過指向指定的 CodeDeploy 生命週期事件勾點來取代 CodeDeploy AppSpec 檔案。</td></tr>
  <tr><td colspan="2">1 如果您指定要部署的應用程式修訂版本做為部署群組的一部分，您的目標修訂會在佈建程序完成後立即部署。如需範本組態的詳細資訊，請參閱*AWS CloudFormation 《 使用者指南*》中的 [CodeDeploy DeploymentGroup 部署修訂版 S3Location](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codedeploy-deploymentgroup-deployment-revision-s3location.html) 和 [CodeDeploy DeploymentGroup 部署修訂版 GitHubLocation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codedeploy-deploymentgroup-deployment-revision-githublocation.html)。<br />2 我們提供範本，您可以用來在支援 CodeDeploy 的區域中建立 Amazon EC2 執行個體。如需使用這些範本的詳細資訊，請參閱[為 CodeDeploy 建立 Amazon EC2 執行個體 (CloudFormation 範本）](instances-ec2-create-cloudformation-template.md)。<br />3此部署組態僅支援 Amazon ECS 藍/綠部署。如需透過 部署 Amazon ECS 藍/綠部署組態的詳細資訊 CloudFormation，請參閱 [CloudFormation 藍/綠部署的部署組態 (Amazon ECS)](deployment-configurations.md#deployment-configuration-cfn-bg)。如需透過 Amazon ECS 藍/綠部署 CloudFormation 以及如何在 CodeDeploy 中檢視部署的詳細資訊，請參閱 [透過 建立 Amazon ECS 藍/綠部署 CloudFormation](deployments-create-ecs-cfn.md)。</td><td></td></tr>
</tbody>
</table>