Skip to content
v2.274.0

Experimental

@aws-cdk/aws-imagebuilder-alpha is an experimental (alpha) package: its API may change in any release, without a major version bump.

WorkflowAction Enum ​

The action for a step within the workflow document.

Example ​

ts
const workflow = new imagebuilder.Workflow(this, 'MyWorkflow', {
  workflowType: imagebuilder.WorkflowType.BUILD,
  data: imagebuilder.WorkflowData.fromJsonObject({
    schemaVersion: imagebuilder.WorkflowSchemaVersion.V1_0,
    steps: [
      {
        name: 'LaunchBuildInstance',
        action: imagebuilder.WorkflowAction.LAUNCH_INSTANCE,
        onFailure: imagebuilder.WorkflowOnFailure.ABORT,
        inputs: {
          waitFor: 'ssmAgent',
        },
      },
      {
        name: 'ExecuteComponents',
        action: imagebuilder.WorkflowAction.EXECUTE_COMPONENTS,
        onFailure: imagebuilder.WorkflowOnFailure.ABORT,
        inputs: {
          'instanceId': 'i-123',
        },
      },
      {
        name: 'CreateImage',
        action: imagebuilder.WorkflowAction.CREATE_IMAGE,
        onFailure: imagebuilder.WorkflowOnFailure.ABORT,
        inputs: {
          'instanceId': 'i-123',
        },
      },
      {
        name: 'TerminateInstance',
        action: imagebuilder.WorkflowAction.TERMINATE_INSTANCE,
        onFailure: imagebuilder.WorkflowOnFailure.CONTINUE,
        inputs: {
          'instanceId': 'i-123',
        },
      },
    ],
    outputs: [
      {
        name: 'ImageId',
        value: '$.stepOutputs.CreateImage.imageId',
      },
    ],
  }),
});

Members ​

MemberDescription
APPLY_IMAGE_CONFIGURATIONSApplies customizations and configurations to the input AMIs, such as publishing the AMI to SSM Parameter Store, or creating launch template versions with the AMI IDs provided in the input.
BOOTSTRAP_INSTANCE_FOR_CONTAINERThe BootstrapInstanceForContainer action runs a service script to bootstrap the instance with minimum requirements to run container workflows.
COLLECT_IMAGE_METADATAThe CollectImageMetadata action collects additional information about the instance, such as the list of packages and their respective versions.
COLLECT_IMAGE_SCAN_FINDINGSThe CollectImageScanFindings action collects findings reported by Amazon Inspector for the provided instance.
CREATE_IMAGEThe CreateImage action creates an AMI from a running instance with the ec2:CreateImage API.
DISTRIBUTE_IMAGEThe DistributeImage action copies an AMI using the image's distribution configuration, or using the distribution settings in the step input.
EXECUTE_COMPONENTSThe ExecuteComponents action runs components that are specified in the recipe for the current image being built.
EXECUTE_STATE_MACHINEThe ExecuteStateMachine action executes the state machine provided and waits for completion as part of the workflow.
LAUNCH_INSTANCEThe LaunchInstance action launches an instance using the settings from your recipe and infrastructure configuration resources.
MODIFY_IMAGE_ATTRIBUTESApplies attribute updates to the provided set of distributed images, such as launch permission updates.
RUN_COMMANDThe RunCommand action runs a command document against the provided instance.
REGISTER_IMAGEThe RegisterImage action creates an AMI from a set of snapshots with the ec2:RegisterImage API.
RUN_SYS_PREPThe RunSysprep action runs the Sysprep document on the provided Windows instance.
SANITIZE_INSTANCEThe SanitizeInstance action runs a recommended sanitization script on Linux instances.
TERMINATE_INSTANCEThe TerminateInstance action terminates the provided instance.
WAIT_FOR_ACTIONThe WaitForAction action pauses the workflow and waits to receive an external signal from the imagebuilder:SendWorkflowStepAction API.
WAIT_FOR_SSM_AGENTThe WaitForSSMAgent action waits for the given instance to have connectivity with SSM before proceeding.