View a markdown version of this page

AWS-ECSRunTask - AWS Systems Manager Runbook-Referenz für Automation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS-ECSRunTask

Beschreibung

Das AWS-ECSRunTask Runbook führt die Amazon Elastic Container Service (Amazon ECS) -Aufgabe aus, die Sie angeben.

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

Linux

Parameter

  • AutomationAssumeRole

    Typ: Zeichenfolge

    Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

  • Kapazität ProviderStrategy

    Typ: Zeichenfolge

    Beschreibung: (Optional) Die Strategie des Kapazitätsanbieters, die für die Aufgabe verwendet werden soll.

  • Cluster

    Typ: Zeichenfolge

    Beschreibung: (Optional) Der Kurzname oder ARN des Clusters, auf dem Ihre Aufgabe ausgeführt werden soll. Wenn Sie keinen Cluster angeben, wird der Standardcluster verwendet.

  • count

    Typ: Zeichenfolge

    Beschreibung: (Optional) Die Anzahl der Instanziierungen der angegebenen Aufgabe, die in Ihrem Cluster platziert werden sollen. Sie können für jede Anfrage bis zu 10 Aufgaben angeben.

  • aktivieren ECSManagedTags

    Typ: Boolescher Wert

    Beschreibung: (Optional) Gibt an, ob für die Aufgabe verwaltete Amazon ECS-Tags verwendet werden sollen. Weitere Informationen finden Sie unter Markieren Ihrer Amazon-ECS-Ressourcen im Entwicklerhandbuch für Amazon Elastic Container Service.

  • aktivieren ExecuteCommand

    Typ: Boolescher Wert

    Beschreibung: (Optional) Legt fest, ob die Funktion zum Ausführen von Befehlen für die Container in dieser Aufgabe aktiviert werden soll. Wenn dies zutrifft, wird die Funktion zum Ausführen von Befehlen für alle Container in der Aufgabe aktiviert.

  • Gruppe

    Typ: Zeichenfolge

    Beschreibung: (Optional) Der Name der Aufgabengruppe, die der Aufgabe zugeordnet werden soll. Der Standardwert ist der Familienname der Aufgabendefinition. Beispiel, family:my-family-name.

  • LaunchType

    Typ: Zeichenfolge

    Gültige Werte: EC2 | FARGATE | EXTERNAL

    Beschreibung: (Optional) Die Infrastruktur, auf der Ihre eigenständige Aufgabe ausgeführt werden soll.

  • Netzwerk-Konfiguration

    Typ: Zeichenfolge

    Beschreibung: (Optional) Die Netzwerkkonfiguration für die Aufgabe. Dieser Parameter ist für Aufgabendefinitionen erforderlich, die den awsvpc Netzwerkmodus verwenden, um ihre eigene elastische Netzwerkschnittstelle zu erhalten, und er wird für andere Netzwerkmodi nicht unterstützt.

  • überschreibt

    Typ: Zeichenfolge

    Beschreibung: (Optional) Eine Liste von Container-Overrides im JSON-Format, die den Namen eines Containers in der angegebenen Aufgabendefinition und die Overrides angeben, die er erhalten soll. Sie können den Standardbefehl für einen Container, der in der Aufgabendefinition oder im Docker-Image angegeben ist, durch eine Befehlsüberschreibung überschreiben. Sie können auch vorhandene Umgebungsvariablen überschreiben, die in der Aufgabendefinition oder im Docker-Image eines Containers angegeben sind. Darüber hinaus können Sie neue Umgebungsvariablen mit einer Umgebungsüberschreibung hinzufügen.

  • placementConstraints

    Typ: Zeichenfolge

    Beschreibung: (Optional) Eine Reihe von Objekten mit Platzierungsbeschränkungen, die für die Aufgabe verwendet werden sollen. Sie können für jede Aufgabe bis zu 10 Einschränkungen angeben, einschließlich der Einschränkungen in der Aufgabendefinition und der zur Laufzeit angegebenen Einschränkungen.

  • placementStrategy

    Typ: Zeichenfolge

    Beschreibung: (Optional) Die Objekte der Platzierungsstrategie, die für die Aufgabe verwendet werden sollen. Sie können für jede Aufgabe maximal 5 Strategieregeln angeben.

  • platformVersion

    Typ: Zeichenfolge

    Beschreibung: (Optional) Die Plattformversion, die die Aufgabe verwendet. Eine Plattformversion ist nur für Aufgaben angegeben, die auf Fargate gehostet werden. Ist keine Plattformversion angegeben, wird die Plattformversion LATEST verwendet.

  • Verbreiten Sie Tags

    Typ: Zeichenfolge

    Beschreibung: (Optional) Legt fest, ob Tags von der Aufgabendefinition an die Aufgabe weitergegeben werden. Wenn kein Wert angegeben wird, werden die Tags nicht weitergegeben. Tags können nur während der Aufgabenerstellung an die Aufgaben übertragen werden.

  • Referenz-ID

    Typ: Zeichenfolge

    Beschreibung: (Optional) Die Referenz-ID, die für die Aufgabe verwendet werden soll. Die Referenz-ID kann eine maximale Länge von 1024 Zeichen haben.

  • Gestartet von

    Typ: Zeichenfolge

    Beschreibung: (Optional) Ein optionales Tag, das beim Starten einer Aufgabe angegeben wird. Auf diese Weise können Sie ermitteln, welche Aufgaben zu einem bestimmten Job gehören, indem Sie die Ergebnisse einer ListTasks API-Operation filtern. Bis zu 36 Buchstaben (Groß- und Kleinbuchstaben), Zahlen, Bindestriche (-) und Unterstriche (_) sind zulässig.

  • tags

    Typ: Zeichenfolge

    Beschreibung: (Optional) Metadaten, die Sie auf die Aufgabe anwenden möchten, um Ihnen bei der Kategorisierung und Organisation von Aufgaben zu helfen. Jedes Tag besteht aus einem benutzerdefinierten Schlüssel und Wert.

  • Aufgabendefinition

    Typ: Zeichenfolge

    Beschreibung: (Optional) Das family und revision (family:revision) oder der vollständige ARN der auszuführenden Aufgabendefinition. Wenn keine Revision angegeben ist, wird die neueste ACTIVE Version verwendet.

Erforderliche IAM-Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • ecs:RunTask

Dokumentschritte

aws:executeScript— Führt die Amazon ECS-Aufgabe auf der Grundlage der Werte aus, die Sie für die Runbook-Eingabeparameter angeben.