As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# CloudFormation modelos para CodeDeploy referência
<a name="reference-cloudformation-templates"></a>

Esta seção apresenta os CloudFormation recursos, a transformação e o gancho projetados para funcionar com CodeDeploy implantações. Para ver um passo a passo da criação de uma atualização de pilha gerenciada pelo CloudFormation hook for, consulte CodeDeploy [Crie uma blue/green implantação do Amazon ECS por meio de CloudFormation](deployments-create-ecs-cfn.md)

**nota**  
CloudFormation os ganchos fazem parte dos CloudFormation componentes AWS e são diferentes dos ganchos de eventos do CodeDeploy ciclo de vida.

Além dos outros métodos disponíveis em CodeDeploy, você pode usar CloudFormation modelos para realizar as seguintes tarefas:
+ Crie aplicativos.
+ Crie grupos de implantação e especifique uma revisão de destino.
+ Crie configurações de implantação.
+ Crie instâncias do Amazon EC2.

CloudFormation é um serviço que ajuda você a modelar e configurar seus AWS recursos usando modelos. Um CloudFormation modelo é um arquivo de texto cujo formato está em conformidade com o padrão JSON. Você cria um modelo que descreve todos os AWS recursos desejados e se CloudFormation encarrega de provisionar e configurar esses recursos para você.

Para obter mais informações, consulte [O que é o AWS CloudFormation?](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) e [Trabalhar com modelos do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html) no *Guia do usuário do AWS CloudFormation *. 

Se você planeja usar CloudFormation modelos compatíveis com CodeDeploy os da sua organização, como administrador, você deve conceder acesso aos CloudFormation AWS serviços e ações dos quais CloudFormation depende. Para conceder permissões para criar aplicativos, grupos de implantação e configurações de implantação, adicione a política a seguir ao conjunto de permissões dos usuários com CloudFormation quem trabalharão: 

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

****  

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

------

Para obter mais informações sobre políticas, consulte os seguintes tópicos:
+ Para ver a política que deve ser adicionada ao conjunto de permissões dos usuários que criarão instâncias do Amazon EC2, consulte [Crie uma instância do Amazon EC2 para ( CodeDeploy CloudFormation modelo)](instances-ec2-create-cloudformation-template.md).
+ Para obter informações sobre como adicionar políticas aos conjuntos de permissões, consulte [Criar um conjunto de permissões](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtocreatepermissionset.html) no *Guia do usuário do IAM*. 
+ Para saber como restringir os usuários a um conjunto limitado de CodeDeploy ações e recursos, consulte[AWS políticas gerenciadas (predefinidas) para CodeDeploy](managed-policies.md).

A tabela a seguir mostra as ações que um CloudFormation modelo pode realizar em seu nome e inclui links para mais informações sobre os tipos de AWS recursos e seus tipos de propriedades que você pode adicionar a um CloudFormation modelo. 


<table>
<thead>
  <tr><th>Ação</th><th> CloudFormation referência </th><th>Tipo de referência</th></tr>
</thead>
<tbody>
  <tr><td>Crie um CodeDeploy aplicativo. </td><td>[AWS::CodeDeploy: :aplicativo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-application.html)</td><td>CloudFormation recurso</td></tr>
  <tr><td>Crie e especifique os detalhes de um grupo de implantação a ser usado para implantar as revisões de aplicativos. ¹</td><td>[AWS::CodeDeploy::DeploymentGroup](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-deploymentgroup.html)</td><td>CloudFormation recurso</td></tr>
  <tr><td>Crie um conjunto de regras de implantação, condições de sucesso de implantação e condições de falha de implantação que CodeDeploy serão usadas durante uma implantação.</td><td>[AWS::CodeDeploy::DeploymentConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-deploymentconfig.html)</td><td>CloudFormation recurso</td></tr>
  <tr><td>Crie uma instância do Amazon EC2. ²</td><td>[AWS::EC2::instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html)</td><td>CloudFormation recurso</td></tr>
  <tr><td rowspan="2">Use a CloudFormation AWS::CodeDeployBlueGreen transformação e o AWS::CodeDeploy::BlueGreen gancho para gerenciar atualizações de pilha, criar recursos e transferir tráfego para CodeDeploy blue/green implantações. 3</td><td>[AWS::CodeDeployBlueGreen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html)</td><td>A transformação AWS::CodeDeployBlueGreen é uma macro hospedada pelo CloudFormation </td></tr>
  <tr><td>[AWS::CodeDeploy::BlueGreen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html)</td><td>O AWS::CodeDeploy::BlueGreen gancho é estruturado como um Hook recurso em CloudFormation. O gancho inclui parâmetros que substituem seu CodeDeploy AppSpec arquivo apontando para ganchos de eventos de CodeDeploy ciclo de vida designados.</td></tr>
  <tr><td colspan="2">¹ Se você especificar a versão da revisão de aplicativo a ser implantada como parte do grupo de implantação, sua revisão de destino será implantada assim que o processo de provisionamento estiver completo. Para obter mais informações sobre a configuração do modelo, consulte a [revisão de CodeDeploy DeploymentGroup implantação S3Location](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codedeploy-deploymentgroup-deployment-revision-s3location.html) e a [revisão de CodeDeploy DeploymentGroup implantação GitHubLocation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codedeploy-deploymentgroup-deployment-revision-githublocation.html) no Guia do *AWS CloudFormation usuário*.<br />² Fornecemos modelos que você pode usar para criar instâncias do Amazon EC2 nas regiões em que CodeDeploy há suporte. Para obter mais informações sobre como usar esses templates, consulte [Crie uma instância do Amazon EC2 para ( CodeDeploy CloudFormation modelo)](instances-ec2-create-cloudformation-template.md). <br />3 Somente blue/green implantações do Amazon ECS são suportadas por essa configuração de implantação. Para obter mais informações sobre as configurações de implantação para blue/green implantações do Amazon ECS por meio CloudFormation de, consulte. [Configurações de implantação para CloudFormation blue/green implantações (Amazon ECS)](deployment-configurations.md#deployment-configuration-cfn-bg) Para obter mais informações sobre blue/green implantações do Amazon ECS por meio de CloudFormation e como visualizar sua implantação em CodeDeploy, consulte. [Crie uma blue/green implantação do Amazon ECS por meio de CloudFormation](deployments-create-ecs-cfn.md)</td><td></td></tr>
</tbody>
</table>