EC2 Image AWSTOE Builder를 사용하여 구성 요소 파라미터를 관리합니다.

EC2 Image Builder 콘솔에서 직접 또는 명령 또는 Image Builder SDK 중 하나를 AWS CLI 사용하여 구성 요소 파라미터 생성 및 설정을 비롯한 구성 요소를 관리할 AWSTOE 수 있습니다. 이 섹션에서는 구성 요소에서 매개 변수를 만들고 사용하고 Image Builder 콘솔 및 AWS CLI 명령을 통해 구성 요소 매개 변수를 설정하는 방법을 설명합니다.

중요

구성 요소 파라미터는 일반 텍스트 값이며 AWS CloudTrail에 기록됩니다. 암호를 저장하려면 AWS Systems Manager Parameter AWS Secrets Manager Store를 사용하는 것이 좋습니다. Secrets Manager에 대한 자세한 내용은 AWS Secrets Manager 사용 설명서의 Secrets Manager란 무엇입니까?를 참조하십시오. AWS Systems Manager Parameter Store에 대한 자세한 내용은 AWS Systems Manager 사용 설명서의 AWS Systems Manager Parameter Store 섹션을 참조하십시오.

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

구성 요소를 빌드하려면, YAML 애플리케이션 구성 요소 문서를 제공하십시오. 이는 구성 요소를 만드는 데 필요한 단계를 나타냅니다. 구성 요소를 참조하는 레시피는 파라미터를 설정하여 런타임에 값을 사용자 지정할 수 있으며, 파라미터가 특정 값으로 설정되지 않은 경우 적용되는 기본값을 사용할 수 있습니다.

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

이 단원에서는 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 Lint 확장을 사용하여 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 Lint 확장을 사용하여 YAML이 제대로 구성되어 있는지 확인하십시오.

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

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

AWSTOE 구성 요소를 만드는 데 어떤 방법을 사용하든 YAML 응용 프로그램 구성 요소 문서는 항상 기준으로 필요합니다.

• 이미지 빌더 콘솔을 사용하여 YAML 문서에서 직접 구성 요소를 만들려면 Image Builder 콘솔을 사용하여 구성 요소 생성 섹션을 참조하십시오.

• 에서 Image Builder 명령을 사용하여 구성 요소를 AWS CLI 만들려면 을 참조하십시오다음을 사용하여 Image Builder로 AWSTOE 구성 요소를 생성합니다. AWS CLI. 이 예제의 YAML 문서 이름을 Hello World YAML 문서(hello-world-test.yaml)의 이름으로 바꾸십시오.

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

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

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

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

• 파라미터 이름(편집 불가) – 파라미터 이름입니다.

• 설명(편집 불가) – 파라미터 설명입니다.

• 유형(편집 불가) – 파라미터 값의 데이터 유형입니다.

• 값 – 파라미터의 값입니다. 이 레시피에서 이 구성 요소를 처음 사용하고 입력 파라미터에 대해 기본값이 정의된 경우 기본값이 값 상자에 회색으로 표시된 텍스트와 함께 나타납니다. 다른 값을 입력하지 않은 경우 Image Builder는 기본값을 사용합니다.