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.

# `AWS-InstallAmazonECSAgent`
<a name="automation-aws-install-ecs-agent"></a>

 **Description** 

 Le `AWS-InstallAmazonECSAgent` runbook installe l'agent Amazon Elastic Container Service (Amazon ECS) sur l'instance Amazon Elastic Compute Cloud (Amazon EC2) que vous spécifiez. Ce runbook ne prend en charge que les instances Amazon Linux et Amazon Linux 2. 

 [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-InstallAmazonECSAgent) 

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

Linux

**Paramètres**
+ AutomationAssumeRole

  Type : Chaîne

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
+ InstanceIds

  Type : StringList

  Description : (Obligatoire) Les identifiants des instances Amazon EC2 sur lesquelles vous souhaitez installer l'agent Amazon ECS.

**Autorisations IAM requises**

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `ssm:GetCommandInvocation` 
+  `ec2:DescribeImages` 
+  `ec2:DescribeInstanceAttribute` 
+  `ec2:DescribeInstances` 

 **Étapes de document** 

 `aws:executeScript`- Installe l'agent Amazon ECS sur les instances Amazon EC2 que vous spécifiez dans `InstanceIds` le paramètre. 

 **Sorties** 

InstallAmazonECSAgent. SuccessfulInstances - L'ID de l'instance où l'installation de l'agent Amazon ECS a réussi.

InstallAmazonECSAgent. FailedInstances - L'ID de l'instance sur laquelle l'installation de l'agent Amazon ECS a échoué.

InstallAmazonECSAgent. InProgressInstances - L'ID de l'instance sur laquelle l'installation de l'agent Amazon ECS est en cours.