View a markdown version of this page

AWS-ECSRunTask - AWS Systems Manager Référence du dossier d’exploitation Automation

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-ECSRunTask

Description

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

Exécutez cette automatisation (console)

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 démarre ce runbook.

  • capacité ProviderStrategy

    Type : Chaîne

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

  • cluster

    Type : Chaîne

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

  • count

    Type : Chaîne

    Description : (Facultatif) Le 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.

  • activer ECSManagedTags

    Type : Boolean

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

  • activer ExecuteCommand

    Type : Boolean

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

  • groupe

    Type : Chaîne

    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.

  • Type de lancement

    Type : Chaîne

    Valeurs valides : EC2 | FARGATE | EXTERNAL

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

  • Configuration du réseau

    Type : Chaîne

    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 élastique, et il n'est pas pris en charge pour les autres modes réseau.

  • remplacements

    Type : Chaîne

    Description : (Facultatif) Une liste de remplacements de conteneurs au format JSON 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 d'un conteneur spécifiée dans la définition de la tâche ou dans l'image Docker par une modification de commande. Vous pouvez également remplacer les variables d'environnement existantes qui sont 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 en remplaçant l'environnement.

  • placementConstraints

    Type : Chaîne

    Description : (Facultatif) Tableau d'objets de contrainte de placement à utiliser pour la tâche. Vous pouvez spécifier 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 : Chaîne

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

  • platformVersion

    Type : Chaîne

    Description : (Facultatif) Version de plateforme 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.

  • Propagation des balises

    Type : Chaîne

    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 : Chaîne

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

  • Commencé par

    Type : Chaîne

    Description : (Facultatif) Balise facultative spécifiée lors du 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 opération d'ListTasksAPI. Jusqu'à 36 lettres (majuscules et minuscules), chiffres, tirets (-) et traits de soulignement (_) sont autorisés.

  • tags

    Type : Chaîne

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

  • Définition de la tâche

    Type : Chaîne

    Description : (Facultatif) L'ARN family et revision (family:revision) ou l'ARN complet 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.

Autorisations IAM 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 tâche Amazon ECS en fonction des valeurs que vous spécifiez pour les paramètres d'entrée du runbook.