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

자습서: 입력 파라미터를 사용하여 사용자 지정 구성 요소 생성

구성 요소 파라미터 생성 및 설정을 포함한 Image Builder 구성 요소를 EC2 Image Builder 콘솔, AWS CLI또는 Image Builder API 또는 에서 직접 관리할 수 있습니다SDKs. 이 섹션에서는 구성 요소의 파라미터 생성 및 사용, Image Builder 콘솔을 통한 구성 요소 파라미터 설정, 런타임 시 AWS CLI 명령을 다룹니다.

YAML 구성 요소 문서에서 파라미터 사용

구성 요소를 빌드하려면 YAML 또는 JSON 애플리케이션 구성 요소 문서를 제공해야 합니다. 문서에는 이미지에 대한 사용자 지정을 제공하기 위해 정의한 단계 및 단계 중에 실행되는 코드가 포함되어 있습니다. 구성 요소를 참조하는 레시피는 파라미터를 설정하여 런타임에 값을 사용자 지정할 수 있으며, 파라미터가 특정 값으로 설정되지 않은 경우 적용되는 기본값을 사용할 수 있습니다.

입력 파라미터를 사용하여 구성 요소 문서 만들기

이 섹션에서는 YAML 구성 요소 문서에서 입력 파라미터를 정의하고 사용하는 방법을 보여줍니다.

파라미터를 사용하고 Image Builder 빌드 또는 테스트 인스턴스에서 명령을 실행하는 YAML 애플리케이션 구성 요소 문서를 생성하려면 이미지 운영 체제와 일치하는 단계를 따르세요.

Linux

YAML 구성 요소 문서 생성

파일 편집 도구를 사용하여 구성 요소 문서 파일을 생성합니다. 설명서 예제에서는 다음 콘텐츠가 hello-world-test.yaml 포함된 라는 파일을 사용합니다.

# Document Start
# 
name: "HelloWorldTestingDocument-Linux"
description: "Hello world document to demonstrate parameters."
schemaVersion: 1.0
parameters:
  - MyInputParameter:
      type: string
      default: "It's me!"
      description: This is an input parameter.
phases:
  - name: build
    steps:
      - name: HelloWorldStep
        action: ExecuteBash
        inputs:
          commands:
            - echo "Hello World! Build phase. My input parameter value is {{ MyInputParameter }}"

  - name: validate
    steps:
      - name: HelloWorldStep
        action: ExecuteBash
        inputs:
          commands:
            - echo "Hello World! Validate phase. My input parameter value is {{ MyInputParameter }}"

  - name: test
    steps:
      - name: HelloWorldStep
        action: ExecuteBash
        inputs:
          commands:
            - echo "Hello World! Test phase. My input parameter value is {{ MyInputParameter }}"
# Document End

작은 정보

이 온라인 YAML 검사기 와 같은 도구 또는 코드 환경의 YAML 보풀 확장을 사용하여 YAML 가 잘 구성되었는지 확인합니다.

Windows

YAML 구성 요소 문서 생성

파일 편집 도구를 사용하여 구성 요소 문서 파일을 생성합니다. 설명서 예제에서는 다음 콘텐츠가 hello-world-test.yaml 포함된 라는 파일을 사용합니다.

# Document Start
# 
name: "HelloWorldTestingDocument-Windows"
description: "Hello world document to demonstrate parameters."
schemaVersion: 1.0
parameters:
  - MyInputParameter:
      type: string
      default: "It's me!"
      description: This is an input parameter.
phases:
  - name: build
    steps:
      - name: HelloWorldStep
        action: ExecutePowerShell
        inputs:
          commands:
            - Write-Host "Hello World! Build phase. My input parameter value is {{ MyInputParameter }}"

  - name: validate
    steps:
      - name: HelloWorldStep
        action: ExecutePowerShell
        inputs:
          commands:
            - Write-Host "Hello World! Validate phase. My input parameter value is {{ MyInputParameter }}"

  - name: test
    steps:
      - name: HelloWorldStep
        action: ExecutePowerShell
        inputs:
          commands:
            - Write-Host "Hello World! Test phase. My input parameter value is {{ MyInputParameter }}"
# Document End

작은 정보

이 온라인 YAML 검사기 와 같은 도구 또는 코드 환경의 YAML 보풀 확장을 사용하여 YAML 가 잘 구성되었는지 확인합니다.

애플리케이션 구성 요소 문서의 단계, 단계 및 구문에 대한 AWSTOE 자세한 내용은 의 문서 사용을 AWSTOE 참조하세요. 파라미터 및 해당 요구 사항에 대한 자세한 내용은 AWSTOE에서 변수 정의 및 참조 페이지의 파라미터 섹션을 참조하십시오.

구성 요소 문서에서 YAML 구성 요소 생성

AWSTOE 구성 요소를 생성하는 데 사용하는 메서드가 무엇이든 애플리케이션 YAML 구성 요소 문서는 항상 기준으로 필요합니다.

콘솔에서 Image Builder 레시피의 구성 요소 파라미터 설정

구성 요소 파라미터 설정은 이미지 레시피와 컨테이너 레시피에서 동일하게 작동합니다. 새 레시피 또는 새 버전의 레시피를 만들 때는 빌드 구성 요소 및 테스트 구성 요소 목록에서 포함할 구성 요소를 선택합니다. 구성 요소 목록에는 이미지용으로 선택한 기본 운영 체제에 적용할 수 있는 구성 요소가 포함됩니다.

구성 요소를 선택하면 구성 요소 목록 바로 아래의 선택된 구성 요소 섹션에 해당 구성 요소가 표시됩니다. 선택한 각 구성 요소에 대한 구성 옵션이 표시됩니다. 구성 요소에 입력 파라미터가 정의되어 있는 경우 입력 파라미터라는 확장 가능한 섹션으로 표시됩니다.

구성 요소에 정의된 각 파라미터에 대해 다음과 같은 파라미터 설정이 표시됩니다.