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.

ApplyImageConfigurations

Este paso aplica varias configuraciones e integraciones a las distribuidas AMIs, como las configuraciones de licencias, las configuraciones de plantillas de lanzamiento, las configuraciones de exportación de S3, las configuraciones de EC2 Fast Launch 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

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: ApplyImageConfigurations
  action: ApplyImageConfigurations
  onFailure: Abort
  inputs:
    distributedImages.$: $.stepOutputs.DistributeImageStep.distributedImages

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.

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.

EC2 Image Builder ejecuta el agente AWS Systems Manager (Systems Manager) en las EC2 instancias 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.

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.

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 EC2 CreateImage API de Amazon. 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.

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

DistributeImage

Esta acción de paso distribuye una AMI a regiones y cuentas específicas. Crea copias de la AMI en las regiones y cuentas de destino en función de la configuración de distribución proporcionada en las solicitudes CreateImage CreateImagePipeline APIs o de la configuración de distribución personalizada proporcionada en el flujo de trabajo para anular la configuración de distribución.

Tiempo de espera predeterminado: 360 minutos

Tiempo de espera máximo: 720 minutos

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.

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

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 función de ejecución personalizada debe tener los siguientes permisos para utilizar 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

Esta acción de paso lanza una instancia en su Cuenta de AWS cuenta y espera a que el agente de Systems Manager se ejecute en la instancia antes de pasar al siguiente paso. La acción de lanzamiento utiliza las opciones de la receta y los recursos de configuración de la infraestructura asociados a la imagen. Por ejemplo, el tipo de instancia que se va a lanzar proviene de la configuración de la infraestructura. La salida es el ID de la instancia que se lanzó.

La entrada waitFor configura la condición que cumple con el requisito de finalización del paso.

Tiempo de espera predeterminado: 60 minutos.

Restauración: en el caso de las instancias de creación, la restauración realiza la acción que se configuró 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:
    waitFor: ssmAgent

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

$.stepOutputs.LaunchStep.instanceId

ModifyImageAttributes

Esta acción de paso modifica los atributos de la distribución AMIs, como los permisos de lanzamiento y otros atributos de la AMI. Funciona sobre los AMIs que se han distribuido a las regiones y cuentas de destino.

Tiempo de espera predeterminado: 120 minutos.

Tiempo de espera máximo: 180 minutos

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

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

$.stepOutputs.ModifyImageAttributesStep.modifiedImages

RegisterImage

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

Tiempo de espera predeterminado: 720 minutos.

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: 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 from another step y snapshot 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: 12 horas.

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.

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.

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 con el ID de instancia que se pasa como entrada.

Tiempo de espera predeterminado: 30 minutos.

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

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 el bus de EventBridge eventos predeterminado con un 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.

Tiempo de espera predeterminado: 3 días.

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 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 del paso 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 EC2 instancia se pueda administrar AWS Systems Manager después de 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 supervisa la instancia hasta que recupera la conectividad SSM o se agota el tiempo de espera.

Tiempo de espera predeterminado: 60 minutos.

Tiempo de espera máximo: 180 minutos

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
  timeoutInSeconds: 900 # 15 minutes
  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