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

YAML 워크플로 문서 생성

YAML 형식 정의 문서는 이미지 생성 프로세스의 빌드, 테스트 및 배포 단계에 대한 입력, 출력 및 워크플로 단계를 구성합니다. 세 워크플로 유형 모두에 동일한 문서 형식이 적용됩니다. 표준화된 단계가 포함된 템플릿에서 시작하거나 처음부터 시작하여 고유한 워크플로를 정의할 수 있습니다. 템플릿을 사용하든 처음부터 시작하든 관계없이 필요에 따라 워크플로를 사용자 정의할 수 있습니다.

YAML 워크플로 문서의 구조

다음 섹션에서는 Image Builder가 이미지 빌드, 테스트 및 배포 작업을 수행하는 데 사용하는 YAML 워크플로 문서의 구조를 설명합니다.

워크플로 문서 식별

워크플로를 고유하게 식별합니다. 이 섹션에는 다음과 같은 속성이 포함될 수 있습니다.

예제

---
name: sample-test-image
description: Workflow for a sample image, with extra configuration options exposed through workflow parameters.
schemaVersion: 1.0

워크플로 문서 입력 파라미터

워크플로 문서의 이 부분에서는 호출자가 지정할 수 있는 입력 파라미터를 정의합니다. 파라미터가 없는 경우이 섹션을 생략할 수 있습니다. 파라미터를 지정하는 경우 각 파라미터에 다음 속성이 포함될 수 있습니다.

워크플로 문서에서 최대 25개의 파라미터를 정의할 수 있습니다. 각 파라미터 값은 최대 1,024자를 포함할 수 있습니다. 파라미터는 string, integer, boolean또는 네 가지 지원되는 데이터 형식 중 하나를 사용해야 합니다stringList. 파라미터 default 값을 지정하지 않으면 런타임에 파라미터 값을 제공해야 합니다.

예제

워크플로 문서에 파라미터를 지정합니다.

parameters:
  - name: waitForActionAtEnd
    type: boolean
    default: true
    description: "Wait for an external action at the end of the workflow"

워크플로 문서의 파라미터 값을 사용합니다.

$.parameters.waitForActionAtEnd

워크플로 문서 단계

워크플로에 대해 최대 15 단계의 작업을 지정합니다. 단계는 워크플로 문서에 정의된 순서대로 실행됩니다. 실패할 경우 롤백은 실패한 단계부터 시작하여 이전 단계를 거꾸로 진행하면서 역순으로 실행됩니다.

각 단계는 이전 단계 작업의 출력을 참조할 수 있습니다. 이를 체이닝 또는 참조라고합니다. JSONPath 선택기를 사용하여 이전 단계 작업의 결과를 참조할 수 있습니다. 예제:

$.stepOutputs.step-name.output-name

자세한 내용은 워크플로 문서에 동적 변수 사용 섹션을 참조하세요.

각 단계에 다음 속성이 포함될 수 있습니다.

예제

다음 예제에서는 워크플로 문서가 parameters 해당 섹션에서 선언해야 하는 waitForActionAtEnd 파라미터를 사용합니다.

steps:
  - name: LaunchTestInstance
    action: LaunchInstance
    onFailure: Abort
    inputs:
      waitFor: "ssmAgent"

  - name: ApplyTestComponents
    action: ExecuteComponents
    onFailure: Abort
    inputs:
      instanceId.$: "$.stepOutputs.LaunchTestInstance.instanceId"

  - name: TerminateTestInstance
    action: TerminateInstance
    onFailure: Continue
    inputs:
      instanceId.$: "$.stepOutputs.LaunchTestInstance.instanceId"

  - name: WaitForActionAtEnd
    action: WaitForAction
    if:
      booleanEquals: true
      value: "$.parameters.waitForActionAtEnd"

실패한 워크플로 단계 재시도

기본적으로 워크플로의 각 단계는 한 번 실행됩니다. Image Builder가 실패할 때 단계를 자동으로 다시 실행하도록 하려면 단계에 retry 속성을 추가합니다. retry 속성에는 다음 필드가 포함됩니다.

재시도는 다음과 같이 작동합니다.

일부 단계 작업에는 추가 재시도 동작이 있습니다.

단계가 실행된 횟수를 확인하려면 GetWorkflowStepExecution 또는 ListWorkflowStepExecutions API 작업을 사용합니다. 응답에는 단계의 attemptNumber 및 maxAttempts 필드가 포함됩니다.

예제

steps:
  - name: LaunchBuildInstance
    action: LaunchInstance
    onFailure: Abort
    retry:
      maxAttempts: 3
      backoffSeconds: 60
    inputs:
      waitFor: "ssmAgent"

워크플로 문서 출력

워크플로의 출력을 정의합니다. 각 출력은 출력의 이름과 값을 지정하는 키 값 페어입니다. 출력을 사용하여 런타임 시 후속 워크플로에서 사용할 수 있는 데이터를 내보낼 수 있습니다. 이 섹션은 선택 사항입니다.

워크플로 문서에서 최대 25개의 출력을 정의할 수 있습니다. 각 출력 이름은 파이프라인에 포함하는 모든 워크플로에서 고유해야 합니다. 이후 워크플로는를 사용하여 이름별로 출력을 참조할 수 있습니다$.workflowOutputs.name.

정의하는 각 출력에는 다음 속성이 포함됩니다.

예제

createProdImage 단계의 단계 출력을 사용하여 워크플로 문서의 출력 이미지 ID를 생성합니다.

outputs:
  - name: 'outputImageId'
    value: '$.stepOutputs.createProdImage.imageId'

다음 워크플로의 워크플로 출력을 참조하세요.

$.workflowOutputs.outputImageId