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.

Unterstützte Schrittaktionen für Ihr Workflow-Dokument

Dieser Abschnitt enthält Details zu den Schrittaktionen, die Image Builder unterstützt.

Die folgende Tabelle zeigt, welche Workflow-Phasen die einzelnen Schrittaktionen unterstützen. Ein Häkchen (X) gibt an, dass Sie die Schrittaktion in dieser Phase verwenden können. Image Builder beschränkt einige Aktionen auf bestimmte Phasen: ExecuteComponents auf die Build- und Testphase, CollectImageScanFindings auf die Testphase undDistributeImage, ModifyImageAttributesApplyImageConfigurations, und DistributeContainerImage auf die Verteilungsphase. Sie können jede andere Aktion in jeder Phase verwenden.

ApplyImageConfigurations

Verwenden Sie diese Schrittaktion, um verschiedene Konfigurationen und Integrationen auf verteilte AMIs anzuwenden, z. B. Lizenzkonfigurationen, Startvorlagenkonfigurationen, S3-Exportkonfigurationen, EC2-Schnellstartkonfigurationen und Systems Manager-Parameterkonfigurationen. Konfigurationen gelten nur für verteilte Images im Quellkonto, mit Ausnahme von SSM-Parameterkonfigurationen, die kontoübergreifend angewendet werden können.

Standard-Timeout: 360 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion. Die distributedImages.$ Eingabe ist erforderlich. Die verbleibenden Zeilen beschreiben die Felder in den einzelnen Elementen des configurations Arrays.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: ApplyImageConfigurations
  action: ApplyImageConfigurations
  onFailure: Abort
  inputs:
    distributedImages.$: $.stepOutputs.DistributeImageStep.distributedImages
    configurations:
      - region: us-west-2
        licenseConfigurationArns:
          - arn:aws:license-manager:us-west-2:111122223333:license-configuration:lic-example

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.ApplyImageConfigurationsStep.configuredImages

BootstrapInstanceForContainer

Diese Schrittaktion führt ein Serviceskript zum Bootstrapping der Instanz mit den Mindestanforderungen für die Ausführung von Container-Workflows aus. Image Builder verwendet die sendCommand in der Systems Manager API, um dieses Skript auszuführen. Weitere Informationen finden Sie unter Befehl AWS Systems Manager ausführen.

Standard-Timeout: 60 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: ContainerBootstrapStep
  action: BootstrapInstanceForContainer
  onFailure: Abort
  inputs:
      instanceId.$: $.stepOutputs.LaunchStep.instanceId

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.ContainerBootstrapStep.status

CollectImageMetadata

Diese Schrittaktion ist nur für Build-Workflows gültig.

EC2 Image Builder führt den AWS Systems Manager (Systems Manager) Agent auf den EC2-Instances aus, die er startet, um Ihr Image zu erstellen und zu testen. Image Builder sammelt zusätzliche Informationen über die Instance, die während der Buildphase mit Systems Manager Inventory verwendet wurde. Zu diesen Informationen gehören der Name und die Version des Betriebssystems (OS) sowie die Liste der Pakete und ihrer jeweiligen Versionen, wie sie von Ihrem Betriebssystem gemeldet werden.

Standard-Timeout: 30 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Image Builder setzt alle Systems Manager-Ressourcen zurück, die während dieses Schritts erstellt wurden.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: CollectMetadataStep
  action: CollectImageMetadata
  onFailure: Abort
  inputs:
      instanceId: $.stepOutputs.LaunchStep.instanceId

Verwenden Sie die Ausgabe der Schrittaktion im Workflow-Dokument.

$.stepOutputs.CollectMetadataStep.osVersion

CollectImageScanFindings

Wenn Amazon Inspector für Ihr Konto und das Scannen von Bildern für Ihre Pipeline aktiviert ist, erfasst diese Schrittaktion die von Amazon Inspector für Ihre Test-Instance gemeldeten Ergebnisse von Bildscans. Diese Schrittaktion ist für Build-Workflows nicht verfügbar.

Standard-Timeout: 120 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: CollectFindingsStep
  action: CollectImageScanFindings
  onFailure: Abort
  inputs:
      instanceId.$: $.stepOutputs.LaunchStep.instanceId

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.CollectFindingsStep.status

CreateImage

Diese Schrittaktion erstellt ein Bild aus einer laufenden Instance mit der Amazon CreateImage EC2-API. Während des Erstellungsprozesses wartet die Schrittaktion bei Bedarf, um zu überprüfen, ob die Ressourcen den richtigen Zustand erreicht haben, bevor sie fortgesetzt wird.

Standard-Timeout: 720 Minuten

Maximales Timeout: 3 Tage (259.200 Sekunden)

Sie können die Standardeinstellung mit bis zum angezeigten timeoutSeconds Höchstwert überschreiben. Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: CreateImageFromInstance
  action: CreateImage
  onFailure: Abort
  inputs:
      instanceId.$: "i-1234567890abcdef0"

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.CreateImageFromInstance.imageId

CreateImageFromIso

Verwenden Sie diese Schrittaktion, um ein Amazon Machine Image (AMI) aus einem ISO-Disk-Image auf der Build-Instance zu erstellen. Verwenden Sie es in einem Build-Workflow, wenn Ihre Quelle eine ISO-Datei und kein Basis-AMI ist. Image Builder konvertiert das ISO in ein AMI und wartet, bis die Ressourcen den erforderlichen Status erreicht haben, bevor der Vorgang fortgesetzt wird.

Standard-Timeout: 720 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: CreateImageFromIsoStep
  action: CreateImageFromIso
  onFailure: Abort
  inputs:
      instanceId.$: $.stepOutputs.LaunchStep.instanceId

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.CreateImageFromIsoStep.amiName

DistributeContainerImage

Verwenden Sie diese Schrittaktion, um ein Container-Image, das in der Build-Phase erstellt wurde, an Amazon ECR-Repositorys in den für das Image definierten Zielregionen zu verteilen. Verwenden Sie diese Aktion in einem Verteilungs-Workflow für Container (DOCKER) -Images. Sie funktioniert als Container-Image-Gegenstück zu. DistributeImage

Diese Schrittaktion führt einen Systems Manager-Befehl auf der Build-Instanz aus, um das Container-Image zu übertragen. Auf der Instanz muss Docker und das AWS CLI installiert sein. Weitere Informationen finden Sie unter BootstrapInstanceForContainer.

Standard-Timeout: 120 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: DistributeContainer
  action: DistributeContainerImage
  onFailure: Abort
  inputs:
      instanceId.$: $.stepOutputs.LaunchStep.instanceId

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.DistributeContainer.status

DistributeImage

Diese Schrittaktion verteilt ein AMI an die von Ihnen angegebenen Zielregionen und Konten. Es verwendet die Verteilungskonfiguration aus Ihrer CreateImagePipeline Anfrage CreateImage oder benutzerdefinierte Verteilungseinstellungen im Workflow, die die Standardkonfiguration außer Kraft setzen.

Standard-Timeout: 360 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: DistributeImage
  action: DistributeImage
  onFailure: Abort
  inputs:
    distributions:
      - region.$: "$.parameters.SourceRegion"
        description: "AMI distribution to source region"
        amiTags:
          DistributionTest: "SourceRegion"
          WorkflowStep: "DistributeToSourceRegion"
          BuildDate: "{{imagebuilder:buildDate:yyyyMMHHss}}"
          BuildVersion: "{{imagebuilder:buildVersion}}"
		  

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.DistributeImageStep.distributedImages

ExecuteComponents

Diese Schrittaktion führt Komponenten aus, die im Rezept für das aktuelle Image angegeben sind, das gerade erstellt wird. Build-Workflows führen Build-Komponenten auf der Build-Instanz aus. In Test-Workflows werden nur Testkomponenten auf der Testinstanz ausgeführt.

Image Builder verwendet die sendCommand in der Systems Manager API, um Komponenten auszuführen. Weitere Informationen finden Sie unter Befehl AWS Systems Manager ausführen.

Standard-Timeout: 720 Minuten

Maximales Timeout: 1 Tag (24 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: ExecComponentsStep
  action: ExecuteComponents
  onFailure: Abort
  inputs:
      instanceId: $.stepOutputs.LaunchStep.instanceId

Verwenden Sie die Ausgabe der Schrittaktion im Workflow-Dokument.

$.stepOutputs.ExecComponentsStep.status

ExecuteStateMachine

Diese Schrittaktion startet die Ausführung einer AWS Step Functions Zustandsmaschine aus einem Image Builder-Workflow. Image Builder verwendet die Step Functions StartExecution API, um die Zustandsmaschine zu initiieren, und wartet, bis sie abgeschlossen ist. Dies ist nützlich, um komplexe Workflows, Compliance-Validierungs- oder Zertifizierungsprozesse in Ihre Image-Building-Pipeline zu integrieren.

Weitere Informationen finden Sie unter Informationen zu Zustandsautomaten in Step Functions im AWS Step Functions Entwicklerhandbuch.

Standard-Timeout: 6 Stunden

Maximales Timeout: 24 Stunden

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

IAM-Berechtigungen erforderlich

Ihre benutzerdefinierte Ausführungsrolle muss über die folgenden Berechtigungen verfügen, um diese Schrittaktion verwenden zu können:

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: ValidateImageCompliance
  action: ExecuteStateMachine
  timeoutSeconds: 3600
  onFailure: Abort
  inputs:
    stateMachineArn: arn:aws:states:us-west-2:111122223333:stateMachine:ImageComplianceValidation
    input: |
      {
        "imageId": "{{ $.stepOutputs.CreateImageFromInstance.imageId }}",
        "region": "us-west-2",
        "complianceLevel": "high",
        "requiredScans": ["cve", "benchmark", "configuration"]
      }

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.ValidateImageCompliance.executionArn

LaunchInstance

Verwenden Sie diese Schrittaktion, um eine Instance in Ihrem zu starten AWS-Konto. Die Aktion wartet, bis die Instanz die angegebene Integritätsprüfungsbedingung erfüllt und der Systems Manager-Agent ausgeführt wird, bevor mit dem nächsten Schritt fortgefahren wird. Die Startaktion verwendet Einstellungen aus Ihrem Rezept und den Ressourcen zur Infrastrukturkonfiguration. Beispielsweise stammt der zu startende Instance-Typ aus der Infrastrukturkonfiguration. Die Ausgabe ist die Instanz-ID der Instanz, die gestartet wurde.

Die waitFor Eingabe konfiguriert die Bedingung, die die Anforderung für den Abschluss eines Schritts erfüllt. Die healthCheck Eingabe gibt die Stufe der Integritätsprüfung der EC2-Instance an, die bestanden werden muss, bevor der Schritt fortgesetzt wird.

Standard-Timeout: 75 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Bei Build-Instances führt Rollback die Aktion aus, die Sie in Ihrer Infrastrukturkonfigurationsressource konfiguriert haben. Standardmäßig werden Build-Instanzen beendet, wenn die Image-Erstellung fehlschlägt. In der Infrastrukturkonfiguration gibt es jedoch eine Einstellung, um die Build-Instanz zur Problembehandlung beizubehalten.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: LaunchStep
  action: LaunchInstance
  onFailure: Abort
  inputs:
    healthCheck: "RUNNING"
    waitFor: ssmAgent

Verwenden Sie die Ausgabe der Schrittaktion im Workflow-Dokument.

$.stepOutputs.LaunchStep.instanceId

ModifyImageAttributes

Verwenden Sie diese Schrittaktion, um Attribute verteilter AMIs zu ändern, z. B. Startberechtigungen und andere AMI-Attribute. Sie arbeitet mit AMIs, die an Zielregionen und -konten verteilt wurden.

Standard-Timeout: 120 Minuten

Maximales Timeout: 180 Minuten (3 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: ModifyImageAttributes
  action: ModifyImageAttributes
  onFailure: Abort
  inputs:
    distributedImages.$: $.stepOutputs.DistributeImageStep.distributedImages
    attributes:
      - region: us-west-2
        launchPermission:
          userIds:
            - "111122223333"

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.ModifyImageAttributesStep.modifiedImages

RegisterImage

Diese Schrittaktion registriert ein neues Amazon Machine Image (AMI) mithilfe der Amazon RegisterImage EC2-API. Es ermöglicht Ihnen, ein AMI aus einem vorhandenen Snapshot oder einer Reihe von Snapshots zu erstellen und dabei verschiedene Image-Attribute anzugeben.

Standard-Timeout: 540 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

IAM-Berechtigungen erforderlich

Ihre benutzerdefinierte Ausführungsrolle muss über die folgenden Berechtigungen verfügen, um diese Schrittaktion verwenden zu können:

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: RegisterNewImage
  action: RegisterImage
  onFailure: Abort
  inputs:
    architecture: "x86_64"
    bootMode: "uefi"
    blockDeviceMapping:
      - DeviceName: "/dev/sda1"
        Ebs:
          SnapshotId: "snap-1234567890abcdef0"
          VolumeSize: 100
          VolumeType: "gp3"
    rootDeviceName: "/dev/sda1"
    virtualizationType: "hvm"

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.RegisterNewImage.imageId

Beispiel mit einem SnapshotId aus einem anderen Schritt stammenden Schritt und Snapshot-Tags, die im generierten AMI enthalten sind

- name: CreateSnapshot
  action: RunCommand
  onFailure: Abort
  inputs:
    instanceId: "i-1234567890abcdef0"
    documentName: "AWS-RunShellScript"
    parameters:
      commands:
        - "aws ec2 create-snapshot --volume-id vol-1234567890abcdef0 --description 'Snapshot for AMI' --query 'SnapshotId' --output text"

- name: RegisterImageFromSnapshot
  action: RegisterImage
  onFailure: Abort
  inputs:
    architecture: "x86_64"
    bootMode: "uefi"
    blockDeviceMapping:
      - DeviceName: "/dev/sda1"
        Ebs:
          SnapshotId.$: "$.stepOutputs.CreateSnapshot.output[0]"
          VolumeSize: 100
          VolumeType: "gp3"
    includeSnapshotTags: true
    rootDeviceName: "/dev/sda1"
    virtualizationType: "hvm"

RunCommand

Diese Schrittaktion führt ein Befehlsdokument für Ihren Workflow aus. Image Builder verwendet die sendCommand in der Systems Manager API, um es für Sie auszuführen. Weitere Informationen finden Sie unter Befehl AWS Systems Manager ausführen.

Standard-Timeout: 720 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: RunCommandDoc
  action: RunCommand
  onFailure: Abort
  inputs:
    documentName: SampleDocument
    parameters:
        osPlatform: 
          - "linux"
    instanceId.$: $.stepOutputs.LaunchStep.instanceId

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.RunCommandDoc.status

RunSysPrep

Diese Schrittaktion verwendet die sendCommand in der Systems Manager-API, um das AWSEC2-RunSysprep Dokument für Windows-Instanzen auszuführen, bevor die Build-Instanz für den Snapshot heruntergefahren wird. Diese Aktionen folgen den AWS bewährten Methoden zum Härten und Reinigen des Bilds.

Standard-Timeout: 60 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: RunSysprep
  action: RunSysPrep
  onFailure: Abort
  inputs:
      instanceId.$: $.stepOutputs.LaunchStep.instanceId

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.RunSysprep.status

SanitizeInstance

Mit dieser Schrittaktion wird das empfohlene Bereinigungsskript für Linux-Instanzen ausgeführt, bevor die Build-Instanz für den Snapshot heruntergefahren wird. Das Sanitize-Skript hilft sicherzustellen, dass das endgültige Image den bewährten Sicherheitsmethoden entspricht und dass Build-Artefakte oder Einstellungen, die nicht auf Ihren Snapshot übertragen werden sollten, entfernt werden. Weitere Informationen zum Skript finden Sie unter. Nach dem Build ist eine Bereinigung erforderlich Diese Schrittaktion gilt nicht für Container-Images.

Image Builder verwendet die sendCommand in der Systems Manager API, um dieses Skript auszuführen. Weitere Informationen finden Sie unter Befehl AWS Systems Manager ausführen.

Standard-Timeout: 60 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: SanitizeStep
  action: SanitizeInstance
  onFailure: Abort
  inputs:
      instanceId: $.stepOutputs.LaunchStep.instanceId

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.SanitizeStep.status

TerminateInstance

Diese Schrittaktion beendet die Instanz, die Sie mit der instanceId Eingabe angeben. Standardmäßig leitet sie die Kündigung ein und geht ohne Wartezeit zum nächsten Schritt über. Ein Hintergrundprozess führt die Bereinigung durch, wenn beim Beenden EC2-Dienstfehler auftreten. Um auf die vollständige Beendigung zu warten, bevor Sie fortfahren, setzen Sie die waitForTermination Eingabe auf. true

Standard-Timeout: 30 Minuten

Maximales Timeout: 720 Minuten (12 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgänge: Für diese Schrittaktion gibt es keine Ausgaben.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: TerminateInstance
  action: TerminateInstance
  onFailure: Continue
  inputs:
      instanceId.$: i-1234567890abcdef0
      waitForTermination: false

WaitForAction

Diese Schrittaktion unterbricht den laufenden Workflow und wartet darauf, eine externe Aktion von der Image SendWorkflowStepAction Builder-API-Aktion zu erhalten. In diesem Schritt wird ein EventBridge Ereignis mit dem Detailtyp auf Ihrem EventBridge Standard-Event-Bus veröffentlicht. EC2 Image Builder Workflow Step Waiting Der Schritt kann auch eine SNS-Benachrichtigung senden, wenn Sie einen SNS-Thema-ARN angeben, oder eine Lambda-Funktion asynchron aufrufen, wenn Sie einen Lambda-Funktionsnamen angeben.

So funktionieren das Anhalten und Wiederaufnehmen

Wenn ein WaitForAction Schritt ausgeführt wird, setzt Image Builder den Schrittstatus auf WAITING und veröffentlicht ein EventBridge Ereignis (DetailtypEC2 Image Builder Workflow Step Waiting). Wenn Sie etwas angebensnsTopicArn, wird auch eine Amazon SNS-Benachrichtigung gesendet. Wenn Sie angebenlambdaFunctionName, wird diese Funktion asynchron aufgerufen. Der Workflow bleibt angehalten, bis eines der folgenden Ereignisse eintritt:

reasonDas, zu dem Sie übergehen, SendWorkflowStepAction wird zusammen mit dem Schritt gespeichert und steht späteren Schritten als reason Ausgabe des Schritts zur Verfügung.

Standard-Timeout: 3 Tage

Maximales Timeout: 7 Tage (604.800 Sekunden)

Sie können die Standardeinstellung bis zum angezeigten timeoutSeconds Höchstwert überschreiben. Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

IAM-Berechtigungen erforderlich

Ihre benutzerdefinierte Ausführungsrolle muss über die folgenden Berechtigungen verfügen, um diese Schrittaktion verwenden zu können:

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument mit SNS-Benachrichtigung an.

- name: SendEventAndWait
  action: WaitForAction
  onFailure: Abort
  inputs:
    snsTopicArn: arn:aws:sns:us-west-2:111122223333:ExampleTopic

Geben Sie die Schrittaktion im Workflow-Dokument mit dem Aufruf der Lambda-Funktion an.

- name: SendEventAndWaitWithLambda
  action: WaitForAction
  onFailure: Abort
  inputs:
    lambdaFunctionName: ExampleFunction
    payload: |
      {
        "imageId": "{{ $.stepOutputs.CreateImageFromInstance.imageId }}",
        "region": "us-west-2"
      }

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.SendEventAndWait.reason

WaitForSSMAgent

Diese Schrittaktion wartet darauf, dass eine EC2-Instance AWS Systems Manager nach erwarteten Perioden, in denen sie nicht reagiert, verwaltbar wird. Dies ist besonders nützlich für Workflows mit bekannten Instance-Unterbrechungen, wie Systemneustarts, Betriebssystem-Upgrades oder plattformspezifischen Vorgängen, bei denen die Instance vorübergehend von SSM getrennt wird. Image Builder überwacht die Instanz, bis sie die SSM-Konnektivität wiederherstellt oder ein Timeout auftritt.

Standard-Timeout: 60 Minuten

Maximales Timeout: 180 Minuten (3 Stunden)

Sie können die Standardeinstellung bis zum angezeigten Höchstwert überschreiben. timeoutSeconds Ein Wert, der über dem Höchstwert liegt, schlägt bei der Überprüfung fehl.

Rollback: Für diese Schrittaktion gibt es kein Rollback.

Eingaben: Die folgende Tabelle enthält unterstützte Eingaben für diese Schrittaktion.

Ausgaben: Die folgende Tabelle enthält Ausgaben für diese Schrittaktion.

Beispiel

Geben Sie die Schrittaktion im Workflow-Dokument an.

- name: WaitForInstanceAfterReboot
  action: WaitForSSMAgent
  onFailure: Abort
  timeoutSeconds: 900
  inputs:
    instanceId.$: $.stepOutputs.LaunchStep.instanceId

Verwenden Sie die Ausgabe des Schrittaktionswerts im Workflow-Dokument.

$.stepOutputs.WaitForInstanceAfterReboot.status