를 사용하여 구성 요소 만들기 AWS CLI - EC2 Image Builder
구성 요소 생성(AWS CLI)

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

를 사용하여 구성 요소 만들기 AWS CLI

이 섹션에서는 Image Builder 명령을 사용하여 에서 AWS Task Orchestrator and Executor (AWSTOE) 구성 요소를 만드는 방법을 설명합니다 AWS Command Line Interface. 구성 요소를 빌드하려면, YAML 애플리케이션 구성 요소 문서를 제공하십시오. 이는 구성 요소를 만드는 데 필요한 단계를 나타냅니다. 새 YAML 구성 요소 문서를 만들려면 YAML 구성 요소 문서 생성(을)를 참조하십시오.

다음을 사용하여 Image Builder로 AWSTOE 구성 요소를 생성합니다. AWS CLI

이 섹션에서는 다음과 같이 에서 Image Builder 명령을 설정하고 사용하여 AWSTOE 응용 프로그램 구성 요소를 만드는 AWS CLI 방법을 알아봅니다.

  • YAML 구성 요소 문서를 명령줄에서 참조할 수 있는 S3 버킷에 업로드합니다.

  • create-component명령을 사용하여 AWSTOE 애플리케이션 구성 요소를 생성합니다.

  • list-components 명령과 이름 필터를 사용하여 구성 요소 버전을 나열하여 이미 존재하는 버전을 확인합니다. 출력을 사용하여 업데이트에 사용할 다음 버전을 결정할 수 있습니다.

입력 YAML 문서에서 AWSTOE 애플리케이션 구성 요소를 만들려면 이미지 운영 체제 플랫폼에 맞는 단계를 따르세요.

Linux
Amazon S3에 애플리케이션 구성 요소 문서 저장

S3 버킷을 AWSTOE 애플리케이션 구성 요소 소스 문서의 리포지토리로 사용할 수 있습니다. 구성 요소 문서를 저장하려면 다음 단계를 수행합니다.

  • Amazon S3에 문서 업로드

    문서가 64KB 미만인 경우 이 단계를 건너뛸 수 있습니다. 크기가 64KB 이상인 문서는 Amazon S3에 저장해야 합니다.

    aws s3 cp update-linux-os.yaml s3://my-s3-bucket/my-path/update-linux-os.yaml
YAML 문서에서 구성 요소 생성

에서 사용하는 create-component 명령을 간소화하려면 명령에 전달하려는 모든 구성 요소 파라미터가 포함된 JSON 파일을 생성하십시오. AWS CLI이전 단계에서 만든 update-linux-os.yaml 문서의 위치를 포함하십시오. uri 키-값 페어에는 파일 참조가 포함됩니다.

참고

JSON 파일의 데이터 값에 대한 명명 규칙은 Image Builder API 작업 요청 파라미터에 지정된 패턴을 따릅니다. API 명령 요청 파라미터를 검토하려면 EC2 Image Builder API 참조의 CreateComponent명령을 참조하십시오.

데이터 값을 명령줄 파라미터로 제공하려면 AWS CLI 명령 참조에 지정된 파라미터 이름을 참조하십시오.

  1. CLI 입력 JSON 파일 생성

    파일 편집 도구를 사용하여 create-update-linux-os-component.json(이)라는 이름의 파일을 생성합니다. 다음 콘텐츠를 포함합니다.

    {
	"name": "update-linux-os",
	"semanticVersion": "1.1.2",
	"description": "An example component that updates the Linux operating system",
	"changeDescription": "Initial version.",
	"platform": "Linux",
	"uri": "s3://my-s3-bucket/my-path/update-linux-os.yaml",
	"kmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/98765432-b123-456b-7f89-0123456f789c",
	"tags": {
		"MyTagKey-purpose": "security-updates"
	}
}
    참고

    • JSON 파일 경로의 시작 부분에 file:// 표기법을 포함시켜야 합니다.

    • JSON 파일의 경로는 명령을 실행하는 기본 운영 체제에 대한 적절한 규칙을 따라야 합니다. 예를 들어 Windows에서는 디렉터리 경로를 참조하기 위해 백슬래시(\)를 사용하고 Linux에서는 슬래시(/)를 사용합니다.

  2. 구성 요소 생성

    이전 단계에서 만든 JSON 파일의 파일 이름을 참조하여 다음 명령을 사용하여 구성 요소를 생성합니다.

    aws imagebuilder create-component --cli-input-json file://create-update-linux-os-component.json
    참고

    • JSON 파일 경로의 시작 부분에 file:// 표기법을 포함시켜야 합니다.

    • JSON 파일의 경로는 명령을 실행하는 기본 운영 체제에 대한 적절한 규칙을 따라야 합니다. 예를 들어 Windows에서는 디렉터리 경로를 참조하기 위해 백슬래시(\)를 사용하고 Linux에서는 슬래시(/)를 사용합니다.

Windows
Amazon S3에 애플리케이션 구성 요소 문서 저장

S3 버킷을 AWSTOE 애플리케이션 구성 요소 소스 문서의 리포지토리로 사용할 수 있습니다. 구성 요소 문서를 저장하려면 다음 단계를 수행합니다.

  • Amazon S3에 문서 업로드

    문서가 64KB 미만인 경우 이 단계를 건너뛸 수 있습니다. 크기가 64KB 이상인 문서는 Amazon S3에 저장해야 합니다.

    aws s3 cp update-windows-os.yaml s3://my-s3-bucket/my-path/update-windows-os.yaml
YAML 문서에서 구성 요소 생성

에서 사용하는 create-component 명령을 간소화하려면 명령에 전달하려는 모든 구성 요소 파라미터가 포함된 JSON 파일을 생성하십시오. AWS CLI이전 단계에서 만든 update-windows-os.yaml 문서의 위치를 포함하십시오. uri 키-값 페어에는 파일 참조가 포함됩니다.

참고

JSON 파일의 데이터 값에 대한 명명 규칙은 Image Builder API 작업 요청 파라미터에 지정된 패턴을 따릅니다. API 명령 요청 파라미터를 검토하려면 EC2 Image Builder API 참조의 CreateComponent명령을 참조하십시오.

데이터 값을 명령줄 파라미터로 제공하려면 AWS CLI 명령 참조에 지정된 파라미터 이름을 참조하십시오.

  1. CLI 입력 JSON 파일 생성

    파일 편집 도구를 사용하여 create-update-windows-os-component.json(이)라는 이름의 파일을 생성합니다. 다음 콘텐츠를 포함합니다.

    {
	"name": "update-windows-os",
	"semanticVersion": "1.1.2",
	"description": "An example component that updates the Windows operating system.",
	"changeDescription": "Initial version.",
	"platform": "Windows",
	"uri": "s3://my-s3-bucket/my-path/update-windows-os.yaml",
	"kmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/98765432-b123-456b-7f89-0123456f789c",
	"tags": {
		"MyTagKey-purpose": "security-updates"
	}
}
    참고

    • JSON 파일 경로의 시작 부분에 file:// 표기법을 포함시켜야 합니다.

    • JSON 파일의 경로는 명령을 실행하는 기본 운영 체제에 대한 적절한 규칙을 따라야 합니다. 예를 들어 Windows에서는 디렉터리 경로를 참조하기 위해 백슬래시(\)를 사용하고 Linux에서는 슬래시(/)를 사용합니다.

  2. 구성 요소 생성

    이전 단계에서 만든 JSON 파일의 파일 이름을 참조하여 다음 명령을 사용하여 구성 요소를 생성합니다.

    aws imagebuilder create-component --cli-input-json file://create-update-windows-os-component.json
    참고

    • JSON 파일 경로의 시작 부분에 file:// 표기법을 포함시켜야 합니다.

    • JSON 파일의 경로는 명령을 실행하는 기본 운영 체제에 대한 적절한 규칙을 따라야 합니다. 예를 들어 Windows에서는 디렉터리 경로를 참조하기 위해 백슬래시(\)를 사용하고 Linux에서는 슬래시(/)를 사용합니다.

AWSTOE 업데이트를 위한 구성 요소 버전 관리 ()AWS CLI

AWSTOE 구성 요소 이름 및 버전은 구성 요소 접두사 뒤에 구성 요소의 Amazon 리소스 이름 (ARN) 에 포함됩니다. 구성 요소의 새 버전마다 고유한 ARN이 있습니다. 새 버전을 생성하는 단계는 새 구성 요소를 만드는 단계와 완전히 동일합니다. 단, 시맨틱 버전이 해당 구성 요소 이름에 고유해야 합니다. Image Builder 리소스의 시맨틱 버전 관리에 대한 자세한 내용은 의미 체계 버전 관리(을)를 참조하십시오.

다음 논리적 버전을 할당하려면 먼저 변경하려는 구성 요소의 기존 버전 목록을 가져오십시오. list-components명령을 AWS CLI, 와 함께 사용하고 이름을 필터링합니다.

이 예제에서는 이전 Linux 예제에서 만든 구성 요소의 이름을 기준으로 필터링합니다. 생성한 구성 요소를 나열하려면 create-component 명령에서 사용한 JSON 파일의 name 파라미터 값을 사용합니다.

aws imagebuilder list-components --filters name="name",values="update-linux-os"	
{
    "requestId": "123a4567-b890-123c-45d6-ef789ab0cd1e",
    "componentVersionList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:1234560087789012:component/update-linux-os/1.0.0",
            "name": "update-linux-os",
            "version": "1.0.0",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2020-09-24T16:58:24.444Z"
        },
        {
            "arn": "arn:aws:imagebuilder:us-west-2:1234560087789012:component/update-linux-os/1.0.1",
            "name": "update-linux-os",
            "version": "1.0.1",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2021-07-10T03:38:46.091Z"
        }
    ]
}

결과를 바탕으로 다음 버전을 결정할 수 있습니다.