AWS-ECSRunTask

Description

Le AWS-ECSRunTask runbook exécute la tâche Amazon Elastic Container Service (AmazonECS) que vous spécifiez.

Exécuter cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

Linux

Paramètres

• AutomationAssumeRole

  Type : String

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle AWS Identity and Access Management (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.

• capacityProviderStrategy

  Type : String

  Description : (Facultatif) La stratégie du fournisseur de capacité à utiliser pour la tâche.

• cluster

  Type : String

  Description : (Facultatif) Le nom abrégé ou le nom ARN du cluster sur lequel exécuter votre tâche. Si vous ne spécifiez aucun cluster, le cluster par défaut est utilisé.

• count

  Type : String

  Description : (Facultatif) Nombre d'instanciations de la tâche spécifiée à placer sur votre cluster. Vous pouvez spécifier jusqu'à 10 tâches pour chaque demande.

• enableECSManagedBalises

  Type : booléen

  Description : (Facultatif) Spécifie s'il faut utiliser les balises ECS gérées par Amazon pour la tâche. Pour plus d'informations, consultez la section Marquage de vos ECS ressources Amazon dans le guide du développeur Amazon Elastic Container Service.

• enableExecuteCommand

  Type : booléen

  Description : (Facultatif) Détermine s'il faut activer la fonctionnalité d'exécution de commande pour les conteneurs de cette tâche. Si cela est vrai, cela active la fonctionnalité d'exécution de commande sur tous les conteneurs de la tâche.

• groupe

  Type : String

  Description : (Facultatif) Nom du groupe de tâches à associer à la tâche. La valeur par défaut est le nom de famille de la définition de tâche. Par exemple, family:my-family-name.

• launchType

  Type : String

  Valeurs valides : EC2 | FARGATE | EXTERNAL

  Description : (Facultatif) L'infrastructure sur laquelle exécuter votre tâche autonome.

• networkConfiguration

  Type : String

  Description : (Facultatif) Configuration réseau de la tâche. Ce paramètre est obligatoire pour les définitions de tâches qui utilisent le mode awsvpc réseau pour recevoir leur propre interface réseau Elastic, et il n'est pas pris en charge pour les autres modes réseau.

• remplacements

  Type : String

  Description : (Facultatif) Liste des remplacements de conteneurs au JSON format qui spécifie le nom d'un conteneur dans la définition de tâche spécifiée et les remplacements qu'il doit recevoir. Vous pouvez remplacer la commande par défaut pour un conteneur spécifiée dans la définition de la tâche ou dans l'image Docker par une commande de remplacement. Vous pouvez également remplacer les variables d'environnement existantes spécifiées dans la définition de la tâche ou dans l'image Docker d'un conteneur. En outre, vous pouvez ajouter de nouvelles variables d'environnement avec une dérogation d'environnement.

• placementConstraints

  Type : String

  Description : (Facultatif) Tableau d'objets de contrainte de placement à utiliser pour la tâche. Vous pouvez définir jusqu'à 10 contraintes pour chaque tâche, y compris les contraintes dans la définition de la tâche et celles spécifiées lors de l'exécution.

• placementStrategy

  Type : String

  Description : (Facultatif) Les objets de stratégie de placement à utiliser pour la tâche. Vous pouvez définir un maximum de 5 règles de stratégie pour chaque tâche.

• platformVersion

  Type : String

  Description : (Facultatif) Version de plate-forme utilisée par la tâche. Une version de plateforme n'est spécifiée que pour les tâches hébergées sur Fargate. Si vous ne spécifiez aucune version de plateforme, la version LATEST est utilisée.

• propagateTags

  Type : String

  Description : (Facultatif) Détermine si les balises se propagent de la définition de la tâche à la tâche. Si aucune valeur n'est spécifiée, les balises ne sont pas propagées. Les balises ne peuvent être propagées à la tâche que lors de la création de tâche.

• referenceId

  Type : String

  Description : (Facultatif) L'ID de référence à utiliser pour la tâche. L'ID de référence peut avoir une longueur maximale de 1024 caractères.

• startedBy

  Type : String

  Description : (Facultatif) Balise facultative spécifiée au démarrage d'une tâche. Cela vous permet d'identifier les tâches qui appartiennent à une tâche spécifique en filtrant les résultats d'une ListTasks API opération. Jusqu'à 36 lettres (majuscules et minuscules), chiffres, tirets (-) et traits de soulignement (_) sont autorisés.

• balises

  Type : String

  Description : (Facultatif) Métadonnées que vous souhaitez appliquer à la tâche pour vous aider à classer et à organiser les tâches. Chaque balise est composée d'une clé et d'une valeur définies par l'utilisateur.

• taskDefinition

  Type : String

  Description : (Facultatif) Le family et revision (family:revision) ou l'intégralité ARN de la définition de tâche à exécuter. Si aucune révision n'est spécifiée, la dernière ACTIVE révision est utilisée.

IAMAutorisations requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

• ecs:RunTask

Étapes de document

aws:executeScript- Exécute la ECS tâche Amazon en fonction des valeurs que vous spécifiez pour les paramètres d'entrée du runbook.