Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Acciones de paso admitidas para el documento de flujos de trabajo

En esta sección se incluyen detalles de las acciones de paso que admite Generador de imágenes.

En la tabla siguiente se muestran las etapas del flujo de trabajo que admiten cada acción escalonada. Una marca de verificación (X) indica que puede usar la acción escalonada en esa etapa. Image Builder restringe algunas acciones a etapas específicas: ExecuteComponents a las etapas de creación y prueba, CollectImageScanFindings a la etapa de prueba y, DistributeImage ModifyImageAttributesApplyImageConfigurations, y DistributeContainerImage a la etapa de distribución. Puede usar cualquier otra acción en cualquier etapa.

ApplyImageConfigurations

Utilice este paso para aplicar diversas configuraciones e integraciones a las AMI distribuidas, como las configuraciones de licencias, las configuraciones de plantillas de lanzamiento, las configuraciones de exportación de S3, las configuraciones de lanzamiento rápido de EC2 y las configuraciones de parámetros de Systems Manager. Las configuraciones se aplican a las imágenes distribuidas solo en la cuenta de origen, excepto a las configuraciones de parámetros de SSM, que se pueden aplicar entre cuentas.

Tiempo de espera predeterminado: 360 minutos

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso. La distributedImages.$ entrada es obligatoria. Las filas restantes describen los campos de cada elemento de la configurations matriz.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

- 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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.ApplyImageConfigurationsStep.configuredImages

BootstrapInstanceForContainer

Esta acción de paso ejecuta un script de servicio para arrancar la instancia con los requisitos mínimos para ejecutar flujos de trabajo de contenedores. Generador de imágenes utiliza la acción sendCommand en la API de Systems Manager para ejecutar este script. Para obtener más información, consulte AWS Systems Manager Run Command.

Tiempo de espera predeterminado: 60 minutos.

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.ContainerBootstrapStep.status

CollectImageMetadata

Esta acción de paso solo es válida para los flujos de trabajo de creación.

Generador de imágenes de EC2 ejecuta AWS Systems Manager (Systems Manager) Agent en las instancias de EC2 que lanza para crear y probar la imagen. Generador de Imágenes recopila información adicional sobre la instancia utilizada durante la fase de compilación con Systems Manager Inventory. Esta información incluye el nombre y la versión del sistema operativo (OS), así como la lista de paquetes y sus versiones respectivas, según lo indicado por su sistema operativo.

Tiempo de espera predeterminado: 30 minutos.

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: Generador de imágenes restaura todos los recursos de Systems Manager que se hayan creado durante este paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.CollectMetadataStep.osVersion

CollectImageScanFindings

Si Amazon Inspector está habilitado para la cuenta y el análisis de imágenes está habilitado para la canalización, este paso de acción recopila los resultados del análisis de imágenes notificados por Amazon Inspector para la instancia de prueba. Esta acción de paso no está disponible para los flujos de trabajo de creación.

Tiempo de espera predeterminado: 120 minutos.

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.CollectFindingsStep.status

CreateImage

Esta acción de paso crea una imagen a partir de una instancia en ejecución con la API CreateImage de Amazon EC2. Durante el proceso de creación, la acción de paso espera lo necesario para comprobar que los recursos han alcanzado el estado correcto antes de continuar.

Tiempo de espera predeterminado: 720 minutos.

Tiempo de espera máximo: 3 días (259,200 segundos)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.CreateImageFromInstance.imageId

CreateImageFromIso

Usa este paso para crear una imagen de máquina de Amazon (AMI) a partir de una imagen de disco ISO en la instancia de compilación. Utilícela en un flujo de trabajo de compilación cuando su fuente sea un archivo ISO en lugar de una AMI base. Image Builder convierte la ISO en una AMI y espera a que los recursos alcancen el estado requerido antes de continuar.

Tiempo de espera predeterminado: 720 minutos.

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.CreateImageFromIsoStep.amiName

DistributeContainerImage

Utilice este paso para distribuir una imagen de contenedor creada en la fase de creación en los repositorios de Amazon ECR de las regiones de destino definidas para la imagen. Utilice esta acción en un flujo de trabajo de distribución para imágenes de container (DOCKER). Funciona como la contraparte de la imagen contenedora de. DistributeImage

Esta acción escalonada ejecuta un comando de Systems Manager en la instancia de compilación para insertar la imagen del contenedor. La instancia debe tener Docker y el AWS CLI instalado. Para obtener más información, consulte BootstrapInstanceForContainer.

Tiempo de espera predeterminado: 120 minutos.

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.DistributeContainer.status

DistributeImage

Esta acción escalonada distribuye una AMI a las regiones y cuentas de destino que especifique. Utiliza la configuración de distribución de su CreateImagePipeline solicitud CreateImage o la configuración de distribución personalizada del flujo de trabajo que anula la configuración predeterminada.

Tiempo de espera predeterminado: 360 minutos

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.DistributeImageStep.distributedImages

ExecuteComponents

Esta acción de paso ejecuta los componentes que se especifican en la receta de la imagen actual que se está creando. Los flujos de trabajo de creación ejecutan los componentes de creación en la instancia de creación. Los flujos de trabajo de prueba solo ejecutan los componentes de prueba en la instancia de prueba.

Generador de imágenes utiliza la acción sendCommand en la API de Systems Manager para ejecutar los componentes. Para obtener más información, consulte AWS Systems Manager Run Command.

Tiempo de espera predeterminado: 720 minutos.

Tiempo de espera máximo: 1 día (24 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.ExecComponentsStep.status

ExecuteStateMachine

Esta acción de paso inicia la ejecución de una máquina de AWS Step Functions estados desde un flujo de trabajo de Image Builder. Image Builder usa la StartExecution API Step Functions para iniciar la máquina de estados y espera a que finalice. Esto resulta útil para integrar flujos de trabajo complejos, procesos de validación de conformidad o certificación en su proceso de creación de imágenes.

Para obtener más información, consulte Más información sobre las máquinas de estado en Step Functions de la Guía para AWS Step Functions desarrolladores.

Tiempo de espera predeterminado: 6 horas

Tiempo de espera máximo: 24 horas

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Se requieren permisos de IAM

Su rol de ejecución personalizado debe tener los siguientes permisos para usar esta acción escalonada:

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.ValidateImageCompliance.executionArn

LaunchInstance

Utilice este paso para lanzar una instancia en su Cuenta de AWS. La acción espera hasta que la instancia cumpla la condición de verificación de estado especificada y el agente de Systems Manager esté en ejecución antes de continuar con el siguiente paso. La acción de lanzamiento utiliza la configuración de sus recursos de configuración de infraestructura y receta. Por ejemplo, el tipo de instancia que se va a lanzar proviene de la configuración de la infraestructura. El resultado es el ID de instancia de la instancia que se lanzó.

La entrada waitFor configura la condición que cumple con el requisito de finalización del paso. La healthCheck entrada especifica el nivel de validación del estado de la instancia EC2 que debe superar antes de continuar con el paso.

Tiempo de espera predeterminado: 75 minutos

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Reversión: en el caso de las instancias de compilación, la reversión realiza la acción que ha configurado en el recurso de configuración de la infraestructura. De forma predeterminada, las instancias de creación se terminan si se produce un error en la creación de la imagen. Sin embargo, hay una opción en la configuración de la infraestructura para conservar la instancia de creación para la resolución de problemas.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.LaunchStep.instanceId

ModifyImageAttributes

Utilice este paso para modificar los atributos de las AMI distribuidas, como los permisos de lanzamiento y otros atributos de las AMI. Funciona en las AMI que se han distribuido a las regiones y cuentas de destino.

Tiempo de espera predeterminado: 120 minutos.

Tiempo de espera máximo: 180 minutos (3 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.ModifyImageAttributesStep.modifiedImages

RegisterImage

Este paso registra una nueva imagen de máquina de Amazon (AMI) mediante la RegisterImage API de Amazon EC2. Le permite crear una AMI a partir de una instantánea o un conjunto de instantáneas existente, especificando varios atributos de la imagen.

Tiempo de espera predeterminado: 540 minutos

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Se requieren permisos de IAM

Su rol de ejecución personalizado debe tener los siguientes permisos para usar esta acción escalonada:

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.RegisterNewImage.imageId

Ejemplo con etiquetas SnapshotId de otro paso e instantáneas incluidas en la AMI generada

- 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

Esta acción de paso ejecuta un documento de comandos para el flujo de trabajo. Generador de imágenes utiliza la acción sendCommand en la API de Systems Manager para ejecutarlo automáticamente. Para obtener más información, consulte AWS Systems Manager Run Command.

Tiempo de espera predeterminado: 720 minutos.

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.RunCommandDoc.status

RunSysPrep

Esta acción de paso utiliza la acción sendCommand en la API de Systems Manager para ejecutar el documento AWSEC2-RunSysprep para las instancias de Windows antes de que la instancia de creación se cierre para la instantánea. Estas acciones siguen las prácticas AWS recomendadas para endurecer y limpiar la imagen.

Tiempo de espera predeterminado: 60 minutos.

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.RunSysprep.status

SanitizeInstance

Esta acción de paso ejecuta el script de saneamiento recomendado para las instancias de Linux antes de que la instancia de creación se cierre para la instantánea. El script de saneamiento ayuda a garantizar que la imagen final siga las prácticas recomendadas de seguridad y que se eliminen los artefactos u opciones de creación que no deban transferirse a la instantánea. Para obtener más información sobre el script, consulte Limpieza posterior a la creación necesaria. Esta acción de paso no se aplica a las imágenes de contenedor.

Generador de imágenes utiliza la acción sendCommand en la API de Systems Manager para ejecutar este script. Para obtener más información, consulte AWS Systems Manager Run Command.

Tiempo de espera predeterminado: 60 minutos.

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.SanitizeStep.status

TerminateInstance

Esta acción de paso termina la instancia que especificó con la instanceId entrada. De forma predeterminada, inicia la terminación y pasa al siguiente paso sin esperar. Un proceso en segundo plano gestiona la limpieza si al finalizar se producen errores en el servicio de EC2. Para esperar a que finalice por completo antes de continuar, defina la waitForTermination entrada como. true

Tiempo de espera predeterminado: 30 minutos.

Tiempo de espera máximo: 720 minutos (12 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: no hay salidas para esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

WaitForAction

Esta acción de paso pausa el flujo de trabajo en ejecución y espera a recibir una acción externa de la acción SendWorkflowStepAction de la API de Generador de imágenes. Este paso publica un EventBridge evento en tu bus de EventBridge eventos predeterminado con el tipo EC2 Image Builder Workflow Step Waiting de detalle. El paso también puede enviar una notificación de SNS si proporciona un ARN de tema de SNS, o invocar una función de Lambda de forma asíncrona si proporciona un nombre de función de Lambda.

Cómo funcionan la pausa y la reanudación

Cuando se ejecuta un WaitForAction paso, Image Builder establece el estado del paso WAITING y publica un EventBridge evento (tipo de detalleEC2 Image Builder Workflow Step Waiting). Si lo proporcionasnsTopicArn, también envía una notificación de Amazon SNS. Si la proporcionalambdaFunctionName, invoca esa función de forma asincrónica. El flujo de trabajo permanece en pausa hasta que ocurra una de las siguientes situaciones:

El reason valor al que pases SendWorkflowStepAction se almacena con el paso y está disponible para los pasos posteriores como reason salida del paso.

Tiempo de espera predeterminado: 3 días.

Tiempo de espera máximo: 7 días (604,800 segundos)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Se requieren permisos de IAM

Su rol de ejecución personalizado debe tener los siguientes permisos para usar esta acción escalonada:

Ejemplo

Especifique la acción del paso en el documento de flujo de trabajo con la notificación de SNS.

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

Especifique la acción escalonada en el documento de flujo de trabajo con la invocación de la función Lambda.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.SendEventAndWait.reason

WaitForSSMAgent

Esta acción escalonada espera a que una instancia de EC2 sea administrable una AWS Systems Manager vez transcurridos los períodos esperados de falta de respuesta. Resulta especialmente útil para los flujos de trabajo con interrupciones conocidas de la instancia, como los reinicios del sistema, las actualizaciones del sistema operativo o las operaciones específicas de la plataforma que desconectan temporalmente la instancia del SSM. Image Builder monitorea la instancia hasta que recupere la conectividad SSM o agote el tiempo de espera.

Tiempo de espera predeterminado: 60 minutos.

Tiempo de espera máximo: 180 minutos (3 horas)

Puede anular el valor predeterminado con timeoutSeconds uno hasta el máximo que se muestra. Un valor superior al máximo no se valida.

Restauración: no hay ninguna restauración para esta acción de paso.

Entradas: en la siguiente tabla se incluyen las entradas admitidas para esta acción de paso.

Salidas: en la siguiente tabla se incluyen las salidas de esta acción de paso.

Ejemplo

Especifique la acción de paso en el documento de flujos de trabajo.

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

Utilice la salida del valor de la acción de paso en el documento de flujos de trabajo.

$.stepOutputs.WaitForInstanceAfterReboot.status