

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création d'une instance Amazon EC2 pour CodeDeploy (modèle)CloudFormation
<a name="instances-ec2-create-cloudformation-template"></a>

Vous pouvez utiliser notre CloudFormation modèle pour lancer rapidement une instance Amazon EC2 exécutant Amazon Linux ou Windows Server. Vous pouvez utiliser AWS CLI la CodeDeploy console ou le AWS APIs pour lancer l'instance avec le modèle. Outre le lancement de l'instance, le modèle effectue les opérations suivantes :
+ Indique d' CloudFormation autoriser l'instance à participer aux CodeDeploy déploiements.
+ Marque l'instance afin de CodeDeploy pouvoir la retrouver lors d'un déploiement.
+ Installe et exécute l' CodeDeploy agent sur l'instance.

Vous n'êtes pas obligé d'utiliser notre CloudFormation pour configurer une instance Amazon EC2. Pour découvrir des alternatives, consultez la page [Utilisation d'instances pour CodeDeploy](instances.md).

Nous ne fournissons pas de CloudFormation modèle pour les instances Amazon EC2 exécutant Ubuntu Server ou Red Hat Enterprise Linux (RHEL).

**Topics**
+ [Avant de commencer](#instances-ec2-create-cloudformation-template-before)
+ [Lancer une instance Amazon EC2 avec le CloudFormation modèle (console)](#instances-ec2-create-cloudformation-template-console)
+ [Lancez une instance Amazon EC2 avec le CloudFormation modèle ()AWS CLI](#instances-ec2-create-cloudformation-template-cli)

## Avant de commencer
<a name="instances-ec2-create-cloudformation-template-before"></a>

Avant de pouvoir utiliser le CloudFormation modèle pour lancer des instances Amazon EC2, assurez-vous de suivre les étapes suivantes.

1. Assurez-vous d'avoir créé un utilisateur administratif, comme décrit dans[Étape 1 : Configuration](getting-started-setting-up.md). Vérifiez que l'utilisateur dispose des autorisations minimales suivantes et ajoutez celles qui ne sont pas présentes :
   + formation des nuages : \$1
   + codedeploy:\$1
   + ec2:\$1
   + iam : AddRoleToInstanceProfile
   + iam : CreateInstanceProfile
   + iam : CreateRole
   + iam : DeleteInstanceProfile
   + iam : DeleteRole
   + iam : DeleteRolePolicy
   + iam : GetRole
   + iam : DeleteRolePolicy
   + iam : PutRolePolicy
   + iam : RemoveRoleFromInstanceProfile

1. Assurez-vous de disposer d'une paire de clés d'instance pour activer l'accès SSH à l'instance Amazon EC2 exécutant Amazon Linux ou l'accès RDP à l'instance exécutant Windows Server.

   [Pour trouver le nom d'une paire de clés, ouvrez la console Amazon EC2 à https://console.aws.amazon.com l'adresse /ec2.](https://console.aws.amazon.com/ec2) Dans le volet de navigation, sous **Réseau et sécurité**, choisissez **Paires de clés** et notez le nom de la paire de clés dans la liste. 

   Pour générer une nouvelle paire de clés, consultez [Création de votre paire de clés à l'aide d'Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#having-ec2-create-your-key-pair). Assurez-vous que la paire de clés est créée dans l'une des régions répertoriées dans [Région et que les points de terminaison](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) sont créés dans *Références générales AWS*. Sinon, vous ne pourrez pas utiliser la paire de clés de l'instance avec CodeDeploy.

## Lancer une instance Amazon EC2 avec le CloudFormation modèle (console)
<a name="instances-ec2-create-cloudformation-template-console"></a>

1. Connectez-vous à la CloudFormation console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudformation.](https://console.aws.amazon.com/cloudformation/)
**Important**  
Connectez-vous au AWS Management Console avec le même compte que celui que vous avez utilisé[Commencer avec CodeDeploy](getting-started-codedeploy.md). Dans la barre de navigation, dans le sélecteur de région, choisissez l'une des régions répertoriées dans [Région et des points de terminaison](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) dans. *Références générales AWS* CodeDeploy ne prend en charge que ces régions.

1. Sélectionnez **Créer une pile**.

1. Dans **Choisir un modèle**, choisissez **Spécifier l'URL d'un modèle Amazon S3**. Dans le champ, tapez l'emplacement du CloudFormation modèle pour votre région, puis choisissez **Next**.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codedeploy/latest/userguide/instances-ec2-create-cloudformation-template.html)

1. Dans la zone **Stack name (Nom de pile)**, saisissez un nom pour la pile (par exemple **CodeDeployDemoStack**).

1. Dans **Paramètres**, saisissez ce qui suit et choisissez **Suivant**.
   + Pour **InstanceCount**, saisissez le nombre d'instances que vous souhaitez lancer. (Nous vous recommandons de conserver la valeur par défaut **1**.)
   + Pour **InstanceType**, tapez le type d'instance que vous souhaitez lancer (ou laissez la valeur par défaut **t1.micro**).
   + Pour **KeyPairName**, tapez le nom de la paire de clés de l'instance. Tapez le nom de la paire de clés uniquement, pas l'extension de fichier de la paire de clés.
   + Dans le **OperatingSystem**champ box, tapez **Windows** pour lancer des instances exécutant Windows Server (ou conservez la valeur par défaut de **Linux**).
   + Pour **SSHLocation**, tapez la plage d'adresses IP à utiliser pour la connexion à l'instance via SSH ou RDP (ou conservez la valeur par défaut de **0.0.0.0/0**).
**Important**  
La valeur par défaut **0.0.0.0/0** est fournie à des fins de démonstration uniquement. CodeDeploy n'exige pas que les instances Amazon EC2 aient un accès illimité aux ports. Comme bonne pratique, nous vous recommandons de limiter l'accès aux ports SSH (et HTTP). Pour plus d'informations, consultez la section [Conseils pour sécuriser votre instance Amazon EC2.](https://aws.amazon.com/articles/1233)
   + Pour **TagKey**, tapez la clé de balise d'instance CodeDeploy qui sera utilisée pour identifier les instances lors du déploiement (ou laissez la valeur par défaut **Nom**).
   + Pour **TagValue**, tapez la valeur de balise d'instance CodeDeploy qui sera utilisée pour identifier les instances lors du déploiement (ou conservez la valeur par défaut de **CodeDeployDemo**).

1. Dans la page **Options**, laissez les zones d'option vides et sélectionnez **Suivant**.
**Important**  
CloudFormation les tags sont différents des CodeDeploy tags. CloudFormation utilise des balises pour simplifier l'administration de votre infrastructure. CodeDeploy utilise des balises pour identifier les instances Amazon EC2. Vous avez spécifié des balises CodeDeploy sur la page **Specify Parameters (Spécifier les paramètres)**.

1. Sur la page de **révision**, dans **Fonctionnalités**, cochez la case **Je reconnais que cela CloudFormation pourrait créer des ressources IAM**, puis choisissez **Créer**.

   **Après avoir CloudFormation créé la pile et lancé les instances Amazon EC2, **CREATE\$1COMPLETE** sera affiché dans la colonne Status de la CloudFormation console.** Ce processus peut prendre plusieurs minutes.

Pour vérifier que l' CodeDeploy agent s'exécute sur les instances Amazon EC2, consultez[Gestion des opérations des CodeDeploy agents](codedeploy-agent-operations.md), puis passez à. [Créez une application avec CodeDeploy](applications-create.md)

## Lancez une instance Amazon EC2 avec le CloudFormation modèle ()AWS CLI
<a name="instances-ec2-create-cloudformation-template-cli"></a>

1. Utilisez notre CloudFormation modèle lors d'un appel à la **create-stack** commande. Cette pile lancera une nouvelle instance Amazon EC2 avec l' CodeDeploy agent installé.

   Pour lancer une instance Amazon EC2 exécutant Amazon Linux :

   ```
   aws cloudformation create-stack \
     --stack-name CodeDeployDemoStack \
     --template-url templateURL \
     --parameters ParameterKey=InstanceCount,ParameterValue=1 ParameterKey=InstanceType,ParameterValue=t1.micro \
       ParameterKey=KeyPairName,ParameterValue=keyName ParameterKey=OperatingSystem,ParameterValue=Linux \
       ParameterKey=SSHLocation,ParameterValue=0.0.0.0/0 ParameterKey=TagKey,ParameterValue=Name \
       ParameterKey=TagValue,ParameterValue=CodeDeployDemo \
     --capabilities CAPABILITY_IAM
   ```

   Pour lancer une instance Amazon EC2 exécutant Windows Server : 

   ```
   aws cloudformation create-stack --stack-name CodeDeployDemoStack --template-url template-url --parameters ParameterKey=InstanceCount,ParameterValue=1 ParameterKey=InstanceType,ParameterValue=t1.micro ParameterKey=KeyPairName,ParameterValue=keyName ParameterKey=OperatingSystem,ParameterValue=Windows ParameterKey=SSHLocation,ParameterValue=0.0.0.0/0 ParameterKey=TagKey,ParameterValue=Name ParameterKey=TagValue,ParameterValue=CodeDeployDemo --capabilities CAPABILITY_IAM
   ```

   *keyName*est le nom de la paire de clés de l'instance. Tapez le nom de la paire de clés uniquement, pas l'extension de fichier de la paire de clés.

   *template-url*est l'emplacement du CloudFormation modèle pour votre région :  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codedeploy/latest/userguide/instances-ec2-create-cloudformation-template.html)

   Cette commande crée une CloudFormation pile nommée**CodeDeployDemoStack**, en utilisant le CloudFormation modèle du compartiment Amazon S3 spécifié. L'instance Amazon EC2 est basée sur le type d'instance t1.micro, mais vous pouvez utiliser n'importe quel type. Elle est balisée avec la valeur **CodeDeployDemo**, mais vous pouvez la baliser avec une valeur quelconque. La paire de clés d'instance spécifiée lui est appliquée.

1. Appelez la **describe-stacks** commande pour vérifier que la CloudFormation pile nommée **CodeDeployDemoStack** a été créée avec succès :

   ```
   aws cloudformation describe-stacks --stack-name CodeDeployDemoStack --query "Stacks[0].StackStatus" --output text
   ```

   Ne continuez pas tant que la valeur `CREATE_COMPLETE` n'est pas retournée.

Pour vérifier que l' CodeDeploy agent s'exécute sur l'instance Amazon EC2, consultez[Gestion des opérations des CodeDeploy agents](codedeploy-agent-operations.md), puis passez à. [Créez une application avec CodeDeploy](applications-create.md)