Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Azioni dettagliate supportate per il documento del flusso di lavoro

Questa sezione include i dettagli delle azioni in fase supportate da Image Builder.

La tabella seguente mostra quali fasi del flusso di lavoro supportano ciascuna azione. Un segno di spunta (X) indica che è possibile utilizzare l'azione del passaggio in quella fase. Image Builder limita alcune azioni a fasi specifiche: ExecuteComponents alle fasi di creazione e test, CollectImageScanFindings alla fase di test eDistributeImage, ModifyImageAttributesApplyImageConfigurations, e DistributeContainerImage alla fase di distribuzione. È possibile utilizzare ogni altra azione in qualsiasi fase.

ApplyImageConfigurations

Usa questo passaggio per applicare varie configurazioni e integrazioni alle AMI distribuite, ad esempio configurazioni di licenza, configurazioni dei modelli di avvio, configurazioni di esportazione S3, configurazioni di EC2 Fast Launch e configurazioni dei parametri di Systems Manager. Le configurazioni si applicano alle immagini distribuite solo nell'account sorgente, ad eccezione delle configurazioni dei parametri SSM che possono essere applicate su più account.

Timeout predefinito: 360 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione. L'distributedImages.$input è obbligatorio. Le righe rimanenti descrivono i campi all'interno di ogni elemento dell'configurationsarray.

Risultati: la tabella seguente include gli output per questa azione.

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

- 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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.ApplyImageConfigurationsStep.configuredImages

BootstrapInstanceForContainer

Questa azione di fase esegue uno script di servizio per avviare l'istanza con i requisiti minimi per eseguire i flussi di lavoro dei container. Image Builder utilizza l'sendCommandAPI di Systems Manager per eseguire questo script. Per ulteriori informazioni, vedere AWS Systems Manager Run Command.

Timeout predefinito: 60 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione di fase.

Esempio

Specificare l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.ContainerBootstrapStep.status

CollectImageMetadata

Questa azione in fase è valida solo per la creazione di flussi di lavoro.

EC2 Image Builder esegue l'agente AWS Systems Manager (Systems Manager) sulle istanze EC2 avviate per creare e testare l'immagine. Image Builder raccoglie informazioni aggiuntive sull'istanza utilizzata durante la fase di compilazione con Systems Manager Inventory. https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-inventory.html Queste informazioni includono il nome e la versione del sistema operativo (OS), nonché l'elenco dei pacchetti e le rispettive versioni riportati dal sistema operativo.

Timeout predefinito: 30 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: Image Builder ripristina tutte le risorse di Systems Manager create durante questo passaggio.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione di fase.

Esempio

Specificare l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output dell'azione Step nel documento del workflow.

$.stepOutputs.CollectMetadataStep.osVersion

CollectImageScanFindings

Se Amazon Inspector è abilitato per il tuo account e la scansione delle immagini è abilitata per la tua pipeline, questo passaggio raccoglie i risultati della scansione delle immagini segnalati da Amazon Inspector per la tua istanza di test. Questa operazione non è disponibile per i flussi di lavoro di compilazione.

Timeout predefinito: 120 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione di fase.

Esempio

Specifica l'azione del passaggio nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.CollectFindingsStep.status

CreateImage

Questa azione in fase crea un'immagine da un'istanza in esecuzione con l'CreateImageAPI Amazon EC2. Durante il processo di creazione, la fase successiva attende se necessario per verificare che le risorse abbiano raggiunto lo stato corretto prima di continuare.

Timeout predefinito: 720 minuti

Timeout massimo: 3 giorni (259.200 secondi)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione in fase.

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.CreateImageFromInstance.imageId

CreateImageFromIso

Usa questo passaggio per creare un'Amazon Machine Image (AMI) da un'immagine del disco ISO sull'istanza di compilazione. Usalo in un flusso di lavoro di compilazione quando l'origine è un file ISO anziché un'AMI di base. Image Builder converte l'ISO in un'AMI e attende che le risorse raggiungano lo stato richiesto prima di continuare.

Timeout predefinito: 720 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione di fase.

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.CreateImageFromIsoStep.amiName

DistributeContainerImage

Usa questo passaggio per distribuire un'immagine del contenitore creata in fase di creazione nei repository Amazon ECR nelle regioni di destinazione definite per l'immagine. Usa questa azione in un flusso di lavoro di distribuzione per le immagini container (DOCKER). Funziona come controparte contenitore-immagine di. DistributeImage

Questa operazione esegue un comando di Systems Manager sull'istanza di compilazione per inviare l'immagine del contenitore. L'istanza deve avere Docker e deve essere AWS CLI installato. Per ulteriori informazioni, consulta BootstrapInstanceForContainer.

Timeout predefinito: 120 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione di fase.

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.DistributeContainer.status

DistributeImage

Questa azione di fase distribuisce un'AMI alle regioni e agli account di destinazione specificati. Utilizza la configurazione di distribuzione fornita dall'utente CreateImage o CreateImagePipeline dalle impostazioni di distribuzione personalizzate del flusso di lavoro che sostituiscono la configurazione predefinita.

Timeout predefinito: 360 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione in fase.

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

- 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}}"
		  

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.DistributeImageStep.distributedImages

ExecuteComponents

Questa azione di fase esegue i componenti specificati nella ricetta per l'immagine corrente in fase di creazione. I flussi di lavoro di compilazione eseguono i componenti di compilazione sull'istanza di compilazione. I flussi di lavoro di test eseguono i componenti di test solo sull'istanza di test.

Image Builder utilizza l'sendCommandAPI di Systems Manager per eseguire i componenti. Per ulteriori informazioni, vedere AWS Systems Manager Run Command.

Timeout predefinito: 720 minuti

Timeout massimo: 1 giorno (24 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione di fase.

Esempio

Specificare l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output dell'azione Step nel documento del workflow.

$.stepOutputs.ExecComponentsStep.status

ExecuteStateMachine

Questa azione di fase avvia l'esecuzione di una macchina a AWS Step Functions stati da un flusso di lavoro di Image Builder. Image Builder utilizza l'StartExecutionAPI Step Functions per avviare la macchina a stati e attende il completamento. Ciò è utile per integrare flussi di lavoro complessi, processi di convalida della conformità o certificazione nella pipeline di creazione di immagini.

Per ulteriori informazioni, consulta Informazioni sulle macchine a stati in Step Functions nella Guida per gli sviluppatori. AWS Step Functions

Timeout predefinito: 6 ore

Timeout massimo: 24 ore

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione in fase.

Sono richieste le autorizzazioni IAM

Il ruolo di esecuzione personalizzato deve disporre delle seguenti autorizzazioni per utilizzare questa azione:

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

- 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"]
      }

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.ValidateImageCompliance.executionArn

LaunchInstance

Usa questo passaggio per avviare un'istanza nel tuo Account AWS. L'azione attende che l'istanza soddisfi la condizione di controllo dello stato specificata e che l'agente Systems Manager sia in esecuzione prima di procedere al passaggio successivo. L'azione di avvio utilizza le impostazioni della ricetta e delle risorse di configurazione dell'infrastruttura. Ad esempio, il tipo di istanza da avviare proviene dalla configurazione dell'infrastruttura. L'output è l'ID dell'istanza avviata.

L'waitForinput configura la condizione che soddisfa il requisito di completamento della fase. L'healthCheckinput specifica il livello di convalida dello stato dell'istanza EC2 che deve superare prima che la fase proceda.

Timeout predefinito: 75 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: per le istanze di compilazione, il rollback esegue l'azione configurata nella risorsa di configurazione dell'infrastruttura. Per impostazione predefinita, le istanze di compilazione vengono terminate se la creazione dell'immagine non riesce. Tuttavia, nella configurazione dell'infrastruttura è presente un'impostazione per mantenere l'istanza di compilazione per la risoluzione dei problemi.

Ingressi: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione in fase.

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output dell'azione Step nel documento del workflow.

$.stepOutputs.LaunchStep.instanceId

ModifyImageAttributes

Usa questo passaggio per modificare gli attributi delle AMI distribuite, come le autorizzazioni di avvio e altri attributi AMI. Funziona su AMI che sono state distribuite nelle regioni e negli account di destinazione.

Timeout predefinito: 120 minuti

Timeout massimo: 180 minuti (3 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include i risultati per questa azione.

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.ModifyImageAttributesStep.modifiedImages

RegisterImage

Questo passaggio registra una nuova Amazon Machine Image (AMI) utilizzando l'API Amazon EC2 RegisterImage . Consente di creare un'AMI da un'istantanea o da un set di istantanee esistente, specificando vari attributi dell'immagine.

Timeout predefinito: 540 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione.

Sono richieste le autorizzazioni IAM

Il ruolo di esecuzione personalizzato deve disporre delle seguenti autorizzazioni per utilizzare questa azione:

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.RegisterNewImage.imageId

Esempio con tag SnapshotId from another step e snapshot inclusi nell'AMI generato

- 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

Questa azione in fase esegue un documento di comando per il flusso di lavoro. Image Builder utilizza l'sendCommandAPI di Systems Manager per eseguirlo automaticamente. Per ulteriori informazioni, vedere AWS Systems Manager Run Command.

Timeout predefinito: 720 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione.

Esempio

Specificare l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.RunCommandDoc.status

RunSysPrep

Questa azione di fase utilizza l'sendCommandAPI di Systems Manager per eseguire il AWSEC2-RunSysprep documento per le istanze di Windows prima che l'istanza di compilazione si chiuda per l'istantanea. Queste azioni seguono le AWS migliori pratiche per l'indurimento e la pulizia dell'immagine.

Timeout predefinito: 60 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione di fase.

Esempio

Specificare l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.RunSysprep.status

SanitizeInstance

Questa azione di passaggio esegue lo script di sanitizzazione consigliato per le istanze Linux prima che l'istanza di compilazione si chiuda per l'istantanea. Lo script sanitize aiuta a garantire che l'immagine finale segua le migliori pratiche di sicurezza e che vengano rimossi gli artefatti o le impostazioni della build che non devono essere trasferiti nell'istantanea. Per ulteriori informazioni sullo script, vedere. Pulizia post-compilazione richiesta Questa operazione non si applica alle immagini dei contenitori.

Image Builder utilizza l'sendCommandAPI di Systems Manager per eseguire questo script. Per ulteriori informazioni, vedere AWS Systems Manager Run Command.

Timeout predefinito: 60 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione di fase.

Esempio

Specificare l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.SanitizeStep.status

TerminateInstance

Questa azione di fase termina l'istanza specificata con l'instanceIdinput. Per impostazione predefinita, avvia la terminazione e passa alla fase successiva senza attendere. Un processo in background gestisce la pulizia se la terminazione rileva errori del servizio EC2. Per attendere la chiusura completa prima di procedere, imposta l'input su. waitForTermination true

Timeout predefinito: 30 minuti

Timeout massimo: 720 minuti (12 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Uscite: non ci sono uscite per questa azione in fase.

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

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

WaitForAction

Questa operazione mette in pausa il flusso di lavoro in esecuzione e attende la ricezione di un'azione esterna dall'azione SendWorkflowStepAction API Image Builder. Questo passaggio pubblica un EventBridge evento sul bus degli EventBridge eventi predefinito con il tipo di dettaglio. EC2 Image Builder Workflow Step Waiting Il passaggio può anche inviare una notifica SNS se si fornisce un SNS Topic ARN o richiamare una funzione Lambda in modo asincrono se si fornisce un nome di funzione Lambda.

Come funzionano la pausa e la ripresa

Quando viene eseguito un WaitForAction passaggio, Image Builder imposta lo stato del passaggio WAITING e pubblica un EventBridge evento (tipo di dettaglioEC2 Image Builder Workflow Step Waiting). Se lo forniscisnsTopicArn, invia anche una notifica Amazon SNS. Se forniscilambdaFunctionName, richiama quella funzione in modo asincrono. Il flusso di lavoro rimane in pausa fino a quando non si verifica una delle seguenti condizioni:

Il passaggio a reason cui si passa SendWorkflowStepAction viene memorizzato con il passaggio ed è disponibile per i passaggi successivi come reason output del passaggio.

Timeout predefinito: 3 giorni

Timeout massimo: 7 giorni (604.800 secondi)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Risultati: la tabella seguente include gli output per questa azione.

Sono richieste le autorizzazioni IAM

Il ruolo di esecuzione personalizzato deve disporre delle seguenti autorizzazioni per utilizzare questa azione:

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro con notifica SNS.

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

Specifica l'azione della fase nel documento del flusso di lavoro con l'invocazione della funzione Lambda.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.SendEventAndWait.reason

WaitForSSMAgent

Questa azione graduale attende che un'istanza EC2 diventi gestibile AWS Systems Manager dopo i periodi di inrisposta previsti. È particolarmente utile per i flussi di lavoro con interruzioni note dell'istanza, come riavvii del sistema, aggiornamenti del sistema operativo o operazioni specifiche della piattaforma che disconnettono temporaneamente l'istanza da SSM. Image Builder monitora l'istanza fino al ripristino della connettività SSM o al timeout.

Timeout predefinito: 60 minuti

Timeout massimo: 180 minuti (3 ore)

È possibile sovrascrivere l'impostazione predefinita contimeoutSeconds, fino al massimo indicato. Un valore superiore al valore massimo non viene convalidato.

Rollback: non è previsto alcun rollback per questa azione.

Input: la tabella seguente include gli input supportati per questa azione.

Output: la seguente tabella include gli output per questa azione in fase.

Esempio

Specifica l'azione della fase nel documento del flusso di lavoro.

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

Utilizza l'output del valore dell'azione del passaggio nel documento del flusso di lavoro.

$.stepOutputs.WaitForInstanceAfterReboot.status