기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

워크플로 문서에 지원되는 단계 작업

이 섹션에는 Image Builder에서 지원하는 단계 작업에 대한 세부 정보가 포함되어 있습니다.

다음 표에는 각 단계 작업을 지원하는 워크플로 단계가 나와 있습니다. 확인 표시(X)는 해당 단계에서 단계 작업을 사용할 수 있음을 나타냅니다. Image Builder는 몇 가지 작업을 ExecuteComponents 빌드 및 테스트 단계, CollectImageScanFindings 테스트 단계, DistributeImage, ModifyImageAttributes, ApplyImageConfigurations, 배포 단계 등 특정 단계로 제한DistributeContainerImage합니다. 모든 단계에서 다른 모든 작업을 사용할 수 있습니다.

ApplyImageConfigurations

이 단계 작업을 사용하여 라이선스 구성, 시작 템플릿 구성, S3 내보내기 구성, EC2 Fast Launch 구성 및 Systems Manager 파라미터 구성과 같은 다양한 구성 및 통합을 분산 AMIs에 적용합니다. 구성은 소스 계정의 분산 이미지에만 적용됩니다. 단, 교차 계정을 적용할 수 있는 SSM 파라미터 구성은 예외입니다.

기본 제한 시간: 360분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다. distributedImages.$ 입력이 필요합니다. 나머지 행은 configurations 배열의 각 항목 내의 필드를 설명합니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

- 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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.ApplyImageConfigurationsStep.configuredImages

BootstrapInstanceForContainer

이 단계 작업은 서비스 스크립트를 실행하여 컨테이너 워크플로를 실행하기 위한 최소 요구 사항으로 인스턴스를 부트스트랩합니다. Image Builder는 Systems Manager API의 sendCommand를 사용하여 이 스크립트를 실행합니다. 자세한 내용은 AWS Systems Manager Run Command를 참조하세요.

기본 제한 시간: 60분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.ContainerBootstrapStep.status

CollectImageMetadata

이 단계 작업은 빌드 워크플로에만 유효합니다.

EC2 Image Builder는 시작한 EC2 인스턴스에서 AWS Systems Manager (Systems Manager) Agent를 실행하여 이미지를 빌드 및 테스트합니다. Image Builder는 Systems Manager Inventory를 사용하여 빌드 단계에서 사용된 인스턴스에 대한 추가 정보를 수집합니다. 이 정보에는 운영 체제(OS)이름 및 버전 뿐만 아니라 운영 체제에서 보고한 패키지 및 해당 버전 목록이 포함됩니다.

기본 제한 시간: 30분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: Image Builder는 이 단계에서 생성된 모든 Systems Manager 리소스를 롤백합니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서의 단계 작업 출력을 사용합니다.

$.stepOutputs.CollectMetadataStep.osVersion

CollectImageScanFindings

계정에서 Amazon Inspector를 활성화하고 파이프라인에서 이미지 스캔을 활성화한 경우, 이 단계 작업은 테스트 인스턴스에 대해 Amazon Inspector에서 보고한 이미지 스캔 결과를 수집합니다. 빌드 워크플로에는 이 단계 작업을 사용할 수 없습니다.

기본 제한 시간: 120분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.CollectFindingsStep.status

CreateImage

이 단계 작업은 Amazon EC2 CreateImage API를 이용하여 실행 중인 인스턴스에서 이미지를 생성합니다. 생성 프로세스 중에 단계 작업은 리소스가 올바른 상태에 도달했는지 확인하기 위해 필요한 만큼 대기한 후 작업을 계속합니다.

기본 제한 시간: 720분

최대 제한 시간: 3일(259,200초)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.CreateImageFromInstance.imageId

CreateImageFromIso

이 단계 작업을 사용하여 빌드 인스턴스의 ISO 디스크 이미지에서 Amazon Machine Image(AMI)를 생성합니다. 소스가 기본 AMI가 아닌 ISO 파일인 경우 빌드 워크플로에서 사용합니다. Image Builder는 ISO를 AMI로 변환하고 리소스가 필요한 상태에 도달할 때까지 기다렸다가 계속 진행합니다.

기본 제한 시간: 720분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.CreateImageFromIsoStep.amiName

DistributeContainerImage

이 단계 작업을 사용하여 빌드 단계에서 생성한 컨테이너 이미지를 이미지에 대해 정의된 대상 리전의 Amazon ECR 리포지토리에 배포합니다. 컨테이너(DOCKER) 이미지의 배포 워크플로에서이 작업을 사용합니다. 에 상응하는 컨테이너 이미지로 작동합니다DistributeImage.

이 단계 작업은 빌드 인스턴스에서 Systems Manager 명령을 실행하여 컨테이너 이미지를 푸시합니다. 인스턴스에는 Docker와가 AWS CLI 설치되어 있어야 합니다. 자세한 내용은 BootstrapInstanceForContainer 단원을 참조하십시오.

기본 제한 시간: 120분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.DistributeContainer.status

DistributeImage

이 단계 작업은 지정한 대상 리전 및 계정에 AMI를 배포합니다. CreateImage 또는 CreateImagePipeline 요청의 배포 구성 또는 기본 구성을 재정의하는 워크플로의 사용자 지정 배포 설정을 사용합니다.

기본 제한 시간: 360분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.DistributeImageStep.distributedImages

ExecuteComponents

이 단계 동작은 빌드 중인 현재 이미지의 레시피에 지정된 구성 요소를 실행합니다. 빌드 워크플로는 빌드 인스턴스에서 빌드 구성 요소를 실행합니다. 테스트 워크플로는 테스트 인스턴스에서만 테스트 구성 요소를 실행합니다.

Image Builder는 Systems Manager API의 sendCommand를 사용하여 구성 요소를 실행합니다. 자세한 내용은 AWS Systems Manager Run Command를 참조하세요.

기본 제한 시간: 720분

최대 제한 시간: 1일(24시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서의 단계 작업 출력을 사용합니다.

$.stepOutputs.ExecComponentsStep.status

ExecuteStateMachine

이 단계 작업은 Image Builder 워크플로에서 AWS Step Functions 상태 시스템 실행을 시작합니다. Image Builder는 Step Functions StartExecution API를 사용하여 상태 시스템을 시작하고 완료될 때까지 기다립니다. 이는 복잡한 워크플로, 규정 준수 검증 또는 인증 프로세스를 이미지 빌드 파이프라인에 통합하는 데 유용합니다.

자세한 내용은 AWS Step Functions 개발자 안내서의 Step Functions의 상태 시스템에 대해 알아보기를 참조하세요.

기본 제한 시간: 6시간

최대 제한 시간: 24시간

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

IAM 권한 필요

이 단계 작업을 사용하려면 사용자 지정 실행 역할에 다음 권한이 있어야 합니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.ValidateImageCompliance.executionArn

LaunchInstance

이 단계 작업을 사용하여에서 인스턴스를 시작합니다 AWS 계정. 작업은 인스턴스가 지정된 상태 확인 조건을 충족하고 Systems Manager 에이전트가 실행될 때까지 기다린 후 다음 단계로 진행합니다. 시작 작업은 레시피 및 인프라 구성 리소스의 설정을 사용합니다. 예를 들어, 시작할 인스턴스 유형은 인프라 구성에서 가져옵니다. 출력은 시작된 인스턴스의 인스턴스 ID입니다.

waitFor 입력은 단계 완료 요구 사항을 충족하는 조건을 구성합니다. healthCheck 입력은 단계를 진행하기 전에 통과해야 하는 EC2 인스턴스 상태 확인 수준을 지정합니다.

기본 제한 시간: 75분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 빌드 인스턴스의 경우 롤백은 인프라 구성 리소스에서 구성한 작업을 수행합니다. 기본적으로 이미지 생성에 실패하면 빌드 인스턴스가 종료됩니다. 하지만 인프라 구성에는 문제 해결을 위해 빌드 인스턴스를 유지하는 설정이 있습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서의 단계 작업 출력을 사용합니다.

$.stepOutputs.LaunchStep.instanceId

ModifyImageAttributes

이 단계 작업을 사용하여 시작 권한 및 기타 AMIs 속성과 같은 분산 AMI의 속성을 수정합니다. 대상 리전 및 계정에 배포된 AMIs에서 작동합니다.

기본 제한 시간: 120분

최대 제한 시간: 180분(3시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.ModifyImageAttributesStep.modifiedImages

RegisterImage

이 단계 작업은 Amazon EC2 RegisterImage API를 사용하여 새 Amazon Machine Image(AMI)를 등록합니다. RegisterImage 이를 통해 기존 스냅샷 또는 스냅샷 세트에서 AMI를 생성하여 다양한 이미지 속성을 지정할 수 있습니다.

기본 제한 시간: 540분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

IAM 권한 필요

이 단계 작업을 사용하려면 사용자 지정 실행 역할에 다음 권한이 있어야 합니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.RegisterNewImage.imageId

다른 단계의 SnapshotId와 생성된 AMI에 포함된 스냅샷 태그가 있는 예제

- 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

이 단계 동작은 워크플로의 명령 문서를 실행합니다. Image Builder는 Systems Manager API의 sendCommand를 사용하여 대신 실행합니다. 자세한 내용은 AWS Systems Manager Run Command를 참조하세요.

기본 제한 시간: 720분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.RunCommandDoc.status

RunSysPrep

이 단계 작업은 스냅샷을 위해 빌드 인스턴스가 종료되기 전에 Systems Manager API의 sendCommand를 사용하여 Windows 인스턴스용 AWSEC2-RunSysprep 문서를 실행합니다. 이러한 작업은 AWS 이미지 강화 및 정리 모범 사례를 따릅니다.

기본 제한 시간: 60분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.RunSysprep.status

SanitizeInstance

이 단계 작업은 스냅샷을 위해 빌드 인스턴스를 종료하기 전에 Linux 인스턴스용 권장 삭제 스크립트를 실행합니다. 삭제 스크립트는 최종 이미지가 보안 모범 사례를 따르는지 확인하고 스냅샷으로 전달해서는 안 되는 빌드 아티팩트 또는 설정을 제거하는 데 도움이 됩니다. 스크립트에 대한 자세한 내용은 빌드 후 정리 필요 섹션을 참조하세요. 이 단계 작업은 컨테이너 이미지에 적용되지 않습니다.

Image Builder는 Systems Manager API의 sendCommand를 사용하여 이 스크립트를 실행합니다. 자세한 내용은 AWS Systems Manager Run Command를 참조하세요.

기본 제한 시간: 60분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.SanitizeStep.status

TerminateInstance

이 단계 작업은 instanceId 입력으로 지정한 인스턴스를 종료합니다. 기본적으로 종료를 시작하고 기다리지 않고 다음 단계로 이동합니다. 백그라운드 프로세스는 종료 시 EC2 서비스 오류가 발생하는 경우 정리를 처리합니다. 계속하기 전에 완전히 종료될 때까지 기다리려면 waitForTermination 입력을 로 설정합니다true.

기본 제한 시간: 30분

최대 제한 시간: 720분(12시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 이 단계 작업에 대한 출력이 없습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

WaitForAction

이 단계 작업은 실행 중인 워크플로를 일시 중지하고 Image Builder SendWorkflowStepAction API 작업으로부터 외부 작업을 수신할 때까지 기다립니다. 이 단계에서는 EventBridge 이벤트를 세부 정보 유형 EC2 Image Builder Workflow Step Waiting과 함께 기본 EventBridge 이벤트 버스에 게시합니다. 이 단계에서는 SNS 주제 ARN을 제공하는 경우 SNS 알림을 보내거나 Lambda 함수 이름을 제공하는 경우 Lambda 함수를 비동기적으로 호출할 수도 있습니다.

일시 중지 및 재개 작동 방식

WaitForAction 단계가 실행되면 Image Builder는 단계 상태를 WAITING 로 설정하고 EventBridge 이벤트(세부 정보 유형 EC2 Image Builder Workflow Step Waiting)를 게시합니다. 를 제공하면 Amazon SNS 알림snsTopicArn도 전송됩니다. 를 제공하면 해당 함수가 비동기적으로 lambdaFunctionName호출됩니다. 워크플로는 다음 중 하나가 발생할 때까지 일시 중지된 상태로 유지됩니다.

에 reason 전달하는 SendWorkflowStepAction는 단계와 함께 저장되며 이후 단계에서 단계의 reason 출력으로 사용할 수 있습니다.

기본 제한 시간: 3일

최대 제한 시간: 7일(604,800초)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

IAM 권한 필요

이 단계 작업을 사용하려면 사용자 지정 실행 역할에 다음 권한이 있어야 합니다.

예제

SNS 알림을 사용하여 워크플로 문서에서 단계 작업을 지정합니다.

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

Lambda 함수 호출을 사용하여 워크플로 문서에서 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.SendEventAndWait.reason

WaitForSSMAgent

이 단계 작업은 예상 무응답 기간이 지난 후에서 AWS Systems Manager EC2 인스턴스를 관리할 수 있을 때까지 기다립니다. 시스템 재부팅, OS 업그레이드 또는 SSM에서 인스턴스를 일시적으로 연결 해제하는 플랫폼별 작업과 같이 알려진 인스턴스 중단이 있는 워크플로에 특히 유용합니다. Image Builder는 SSM 연결을 다시 얻거나 시간이 초과될 때까지 인스턴스를 모니터링합니다.

기본 제한 시간: 60분

최대 제한 시간: 180분(3시간)

표시된 최대값timeoutSeconds까지 로 기본값을 재정의할 수 있습니다. 최대값을 초과하는 값은 검증에 실패합니다.

롤백: 이 단계 작업에는 롤백이 없습니다.

입력: 다음 표에는 이 단계 작업에 지원되는 입력이 포함되어 있습니다.

출력: 다음 표에는 이 단계 작업의 출력이 포함되어 있습니다.

예제

워크플로 문서에 단계 작업을 지정합니다.

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

워크플로 문서에 있는 단계 작업 값의 출력을 사용합니다.

$.stepOutputs.WaitForInstanceAfterReboot.status