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

자습서: 입력 매개변수를 사용하여 사용자 지정 구성 요소 만들기

Image Builder 콘솔, Image Builder 또는 에서 직접 구성 요소 매개 변수 생성 및 설정을 비롯한 EC2 Image Builder 구성 요소를 관리할 API 수 SDKs 있습니다. AWS CLI이 섹션에서는 구성 요소에서 매개 변수를 만들고 사용하는 방법과 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 레시피로 구성 요소 매개변수 설정

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

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

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