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 in fasi supportate per il documento del flusso di lavoro

Questa sezione include dettagli sulle azioni dei passaggi supportate da Image Builder.

ApplyImageConfigurations

Questa operazione applica varie configurazioni e integrazioni ai sistemi distribuiti AMIs, ad esempio configurazioni di licenza, configurazioni di modelli di avvio, configurazioni di esportazione S3, configurazioni EC2 Fast Launch e configurazioni dei parametri Systems Manager. Le configurazioni si applicano alle immagini distribuite solo nell'account di origine, ad eccezione delle configurazioni dei parametri SSM che possono essere applicate su più account.

Timeout predefinito: 360 minuti

Timeout massimo: 720 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

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

- name: ApplyImageConfigurations
  action: ApplyImageConfigurations
  onFailure: Abort
  inputs:
    distributedImages.$: $.stepOutputs.DistributeImageStep.distributedImages

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.ApplyImageConfigurationsStep.configuredImages

BootstrapInstanceForContainer

Questa operazione 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 Systems Manager per eseguire questo script. Per ulteriori informazioni, vedere AWS Systems Manager Run Command.

Timeout predefinito: 60 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

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

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

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.ContainerBootstrapStep.status

CollectImageMetadata

Questa operazione è valida solo per i flussi di lavoro di creazione.

EC2 Image Builder esegue AWS Systems Manager (Systems Manager) Agent sulle EC2 istanze che avvia per creare e testare l'immagine. Image Builder raccoglie informazioni aggiuntive sull'istanza utilizzata durante la fase di creazione con Systems Manager Inventory. Queste informazioni includono il nome e la versione del sistema operativo (OS), nonché l'elenco dei pacchetti e delle rispettive versioni riportate dal sistema operativo.

Timeout predefinito: 30 minuti

Rollback: Image Builder ripristina tutte le risorse Systems Manager create durante questa fase.

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

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

Esempio

Specificate 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 della fase nel documento del flusso di lavoro.

$.stepOutputs.CollectMetadataStep.osVersion

CollectImageScanFindings

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

Timeout predefinito: 120 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

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

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

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.CollectFindingsStep.status

CreateImage

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

Timeout predefinito: 720 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

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

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

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.CreateImageFromInstance.imageId

DistributeImage

Questa operazione distribuisce un AMI a regioni e account specifici. Crea copie dell'AMI nelle regioni e negli account di destinazione in base alla configurazione di distribuzione fornita, fornita nelle richieste per l' CreateImage OR CreateImagePipeline APIs o alle impostazioni di distribuzione personalizzate fornite nel flusso di lavoro per sovrascrivere le impostazioni nella configurazione di distribuzione.

Timeout predefinito: 360 minuti

Timeout massimo: 720 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

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

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.DistributeImageStep.distributedImages

ExecuteComponents

Questa operazione 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 solo componenti di test sull'istanza di test.

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

Timeout predefinito: 720 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

Specificate 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 della fase nel documento del flusso di lavoro.

$.stepOutputs.ExecComponentsStep.status

ExecuteStateMachine

Questa operazione avvia l'esecuzione di una macchina a AWS Step Functions stati da un flusso di lavoro Image Builder. Image Builder utilizza l'StartExecutionAPI Step Functions per avviare la macchina a stati e attende che venga completata. 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 Learn about state machine in Step Functions nella AWS Step Functions Developer Guide.

Timeout predefinito: 6 ore

Timeout massimo: 24 ore

Rollback: non è previsto alcun rollback per questa operazione.

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

Output: la tabella seguente include gli output per questa operazione.

Autorizzazioni IAM richieste

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

Esempio

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

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.ValidateImageCompliance.executionArn

LaunchInstance

Questa operazione avvia un'istanza nell'istanza Account AWS e attende che l'agente Systems Manager sia in esecuzione sull'istanza prima di passare alla fase successiva. L'azione di avvio utilizza le impostazioni della ricetta e delle risorse di configurazione dell'infrastruttura associate all'immagine. Ad esempio, il tipo di istanza da avviare deriva dalla configurazione dell'infrastruttura. L'output è l'ID dell'istanza che è stata avviata.

L'waitForinput configura la condizione che soddisfa il requisito di completamento della fase.

Timeout predefinito: 60 minuti

Rollback: per le istanze di build, il rollback esegue l'azione che hai configurato nella risorsa di configurazione dell'infrastruttura. Per impostazione predefinita, le istanze di compilazione vengono terminate se la creazione dell'immagine fallisce. Tuttavia, esiste un'impostazione nella configurazione dell'infrastruttura per mantenere l'istanza di build per la risoluzione dei problemi.

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

Output: la tabella seguente include gli output per questa operazione.

Esempio

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

- name: LaunchStep
  action: LaunchInstance
  onFailure: Abort
  inputs:
    waitFor: ssmAgent

Utilizza l'output dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.LaunchStep.instanceId

ModifyImageAttributes

Questa operazione modifica gli attributi del sistema distribuito AMIs, come i permessi di avvio e altri attributi AMI. Funziona in base a AMIs ciò che è stato distribuito alle regioni e agli account target.

Timeout predefinito: 120 minuti

Timeout massimo: 180 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

Output: la tabella seguente include gli output di questa azione.

Esempio

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

- name: ModifyImageAttributes
  action: ModifyImageAttributes
  onFailure: Abort
  inputs:
    distributedImages.$: $.stepOutputs.DistributeImageStep.distributedImages

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.ModifyImageAttributesStep.modifiedImages

RegisterImage

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

Timeout predefinito: 720 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

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

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.RegisterNewImage.imageId

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

- 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 operazione esegue un documento di comando per il flusso di lavoro. Image Builder utilizza l'sendCommandAPI Systems Manager per eseguirlo automaticamente. Per ulteriori informazioni, vedere AWS Systems Manager Run Command.

Timeout predefinito: 12 ore

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

Specificate 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

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.RunCommandDoc.status

RunSysPrep

Questa operazione utilizza l'sendCommandAPI 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 il rafforzamento e la pulizia dell'immagine.

Timeout predefinito: 60 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

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

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

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.RunSysprep.status

SanitizeInstance

Questa operazione esegue lo script di sanificazione 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 gli artefatti o le impostazioni di build che non devono essere trasferiti all'istantanea vengano rimossi. Per ulteriori informazioni sullo script, consulta. Pulizia post-compilazione richiesta Questa operazione non si applica alle immagini dei contenitori.

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

Timeout predefinito: 60 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

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

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

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.SanitizeStep.status

TerminateInstance

Questa operazione termina l'istanza con l'ID dell'istanza passato come input.

Timeout predefinito: 30 minuti

Rollback: non è previsto alcun rollback per questa operazione.

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

Uscite: non ci sono uscite per questa operazione.

Esempio

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

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

WaitForAction

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

Timeout predefinito: 3 giorni

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

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

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

Specificate 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 della fase nel documento del flusso di lavoro.

$.stepOutputs.SendEventAndWait.reason

WaitForSSMAgent

Questa operazione prevede che un' EC2 istanza diventi gestibile AWS Systems Manager dopo i periodi di mancata risposta previsti. È particolarmente utile per i flussi di lavoro con interruzioni note delle istanze, 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

Rollback: non è previsto alcun rollback per questa operazione.

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

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

Esempio

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

- name: WaitForInstanceAfterReboot
  action: WaitForSSMAgent
  onFailure: Abort
  timeoutInSeconds: 900 # 15 minutes
  inputs:
    instanceId.$: $.stepOutputs.LaunchStep.instanceId

Utilizzate l'output del valore dell'azione della fase nel documento del flusso di lavoro.

$.stepOutputs.WaitForInstanceAfterReboot.Status