기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Image Builder가 AWS Task Orchestrator and Executor 애플리케이션을 사용하여 구성 요소를 관리하는 방법 EC2 Image Builder는 AWS Task Orchestrator and Executor (AWSTOE) 애플리케이션을 사용하여 복잡한 워크플로를 오케스트레이션하고, 시스템 구성을 수정하고, 추가 개발 스크립트 또는 코드 없이 이미지를 테스트합니다. 이 애플리케이션은 선언적 문서 스키마를 구현하는 구성 요소를 관리하고 실행합니다. AWSTOE 는 이미지를 생성할 때 Image Builder가 빌드 및 테스트 인스턴스에 설치하는 독립 실행형 애플리케이션입니다. EC2 인스턴스에 수동으로 설치하여 사용자 지정 구성 요소를 생성할 수도 있습니다. 추가 설정이 필요하지 않으며 온프레미스에서 실행할 수도 있습니다. **Topics** + [AWSTOE 다운로드](#toe-downloads) + [지원되는 리전](#toe-supported-regions) + [AWSTOE 명령 참조](#toe-commands) + [를 사용하여 사용자 지정 구성 요소를 개발하도록 수동 설정 AWSTOE](toe-get-started.md) + [사용자 지정 AWSTOE 구성 요소에 구성 요소 문서 프레임워크 사용](toe-use-documents.md) + [AWSTOE 구성 요소 관리자가 지원하는 작업 모듈](toe-action-modules.md) + [AWSTOE run 명령에 대한 입력 구성](toe-run-config-input.md) ## AWSTOE 다운로드 설치하려면 아키텍처 및 플랫폼의 다운로드 링크를 AWSTOE선택합니다. 서비스의 VPC 엔드포인트(예: Image Builder)에 연결하는 경우 AWSTOE 다운로드를 위해 S3 버킷에 대한 액세스를 포함하는 사용자 지정 엔드포인트 정책이 연결되어 있어야 합니다. 그렇지 않으면 빌드 및 테스트 인스턴스가 부트스트랩 스크립트(`bootstrap.sh`)를 다운로드하고 AWSTOE 애플리케이션을 설치할 수 없습니다. 자세한 내용은 [Image Builder에 대한 VPC 엔드포인트 정책 생성하기](vpc-interface-endpoints.md#vpc-endpoint-policy)을 참조하세요. **중요** AWS 는 TLS 버전 1.0 및 1.1에 대한 지원을 단계적으로 중단합니다. AWSTOE 다운로드를 위해 S3 버킷에 액세스하려면 클라이언트 소프트웨어가 TLS 버전 1.2 이상을 사용해야 합니다. 자세한 내용은 [AWS 보안 블로그 게시물](https://aws.amazon.com/blogs/security/tls-1-2-required-for-aws-endpoints/)을 참조하세요. | 아키텍처 | 플랫폼 | 다운로드 링크 | 예제 | | --- | --- | --- | --- | | 386 | AL 2 및 2023
RHEL 7, 8 및 9
Ubuntu 16.04, 18.04, 20.04, 22.04 및 24.04
CentOS 7 및 8
SUSE 12 및 15 | `https://awstoe-.s3..amazonaws.com/latest/linux/386/awstoe` | [https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/386/awstoe](https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/386/awstoe) | | AMD64 | AL 2 및 2023
RHEL 7, 8 및 9
Ubuntu 16.04, 18.04, 20.04, 22.04 및 24.04
CentOS 7 및 8
CentOS Stream 8
SUSE 12 및 15 | https://awstoe-.s3..amazonaws.com/latest/linux/amd64/awstoe | [https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/amd64/awstoe](https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/amd64/awstoe) | | AMD64 | macOS 10.14.x(Mojave), 10.15.x(Catalina), 11.x(Big Sur), 12.x(Monterey) | https://awstoe-{{region}}.s3.{{region}}.amazonaws.com/latest/darwin/amd64/awstoe | [https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/darwin/amd64/awstoe](https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/darwin/amd64/awstoe) | | AMD64 | Windows Server 2012 R2, 2016, 2019 및 2022 | `https://awstoe-.s3..amazonaws.com/latest/windows/amd64/awstoe.exe` | [https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/windows/amd64/awstoe.exe](https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/windows/amd64/awstoe.exe) | | ARM64 | AL 2 및 2023
RHEL 7, 8 및 9
Ubuntu 16.04, 18.04, 20.04, 22.04 및 24.04
CentOS 7 및 8
CentOS Stream 8
SUSE 12 및 15 | https://awstoe-.s3..amazonaws.com/latest/linux/arm64/awstoe | [https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/arm64/awstoe](https://awstoe-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/arm64/awstoe) | ## 지원되는 리전 AWSTOE 는 다음 리전에서 독립 실행형 애플리케이션으로 지원됩니다. | AWS 리전 이름 | AWS 리전 | | --- | --- | | 미국 동부(오하이오) | us-east-2 | | 미국 동부(버지니아 북부) | us-east-1 | | AWS GovCloud(미국 동부) | us-gov-east-1 | | AWS GovCloud(미국 서부) | us-gov-west-1 | | 미국 서부(캘리포니아 북부) | us-west-1 | | 미국 서부(오리건) | us-west-2 | | 아프리카(케이프타운) | af-south-1 | | 아시아 태평양(홍콩) | ap-east-1 | | 아시아 태평양(오사카) | ap-northeast-3 | | 아시아 태평양(서울) | ap-northeast-2 | | 아시아 태평양(뭄바이) | ap-south-1 | | 아시아 태평양(하이데라바드) | ap-south-2 | | 아시아 태평양(싱가포르) | ap-southeast-1 | | 아시아 태평양(시드니) | ap-southeast-2 | | 아시아 태평양(자카르타) | ap-southeast-3 | | 아시아 태평양(도쿄) | ap-northeast-1 | | 캐나다(중부) | ca-central-1 | | 유럽(프랑크푸르트) | eu-central-1 | | 유럽(취리히) | eu-central-2 | | 유럽(스톡홀름) | eu-north-1 | | 유럽(밀라노) | eu-south-1 | | 유럽(스페인) | eu-south-2 | | 유럽(아일랜드) | eu-west-1 | | 유럽(런던) | eu-west-2 | | 유럽(파리) | eu-west-3 | | 이스라엘(텔아비브) | il-central-1 | | 중동(UAE) | me-central-1 | | 중동(바레인) | me-south-1 | | 남아메리카(상파울루) | sa-east-1 | | 중국(베이징) | cn-north-1 | | 중국(닝샤) | cn-northwest-1 | ## AWSTOE 명령 참조 AWSTOE 는 Amazon EC2 인스턴스에서 실행되는 명령줄 구성 요소 관리 애플리케이션입니다. Image Builder는 EC2 빌드 또는 테스트 인스턴스를 시작할 때 인스턴스 AWSTOE 에를 설치합니다. 그런 다음에서 AWSTOE 명령을 실행 AWS CLI 하여 이미지 또는 컨테이너 레시피에 지정된 구성 요소를 설치하거나 검증합니다. **참고** 일부 AWSTOE 작업 모듈을 Linux 서버에서 실행하려면 승격된 권한이 필요합니다. 상승된 권한을 사용하려면 명령 구문에 접두사로 **sudo**을(를) 붙이거나 아래 링크된 **sudo su** 명령을 실행하기 전에 로그인할 때 명령을 한 번 실행하세요. AWSTOE 작업 모듈에 대한 자세한 내용은 섹션을 참조하세요[AWSTOE 구성 요소 관리자가 지원하는 작업 모듈](toe-action-modules.md). ***[run](#cmd-run)*** **run** 명령을 사용하여 하나 이상의 구성 요소 문서에 대해 YAML 문서 스크립트를 실행합니다. ***[검증](#cmd-validate)*** **validate** 명령을 실행하여 하나 이상의 구성 요소 문서에 대해 YAML 문서 의미 체계를 검증합니다. ### awstoe 실행 명령 이 명령은 `--documents` 매개 변수로 지정된 구성 파일 또는 `--config` 매개 변수로 지정된 구성 요소 문서 목록에 포함된 순서대로 YAML 구성 요소 문서 스크립트를 실행합니다. **참고** 다음 매개변수 중 하나를 정확히 지정해야 합니다. --config --documents #### 구문 ``` awstoe run [--config ] [--cw-ignore-failures ] [--cw-log-group ] [--cw-log-region {{us-west-2}}] [--cw-log-stream ] [--document-s3-bucket-owner ] [--documents ] [--execution-id ] [--log-directory ] [--log-s3-bucket-name ] [--log-s3-bucket-owner ] [--log-s3-key-prefix ] [--parameters {{name1}}={{value1}},{{name2}}={{value2}}...] [--phases ] [--state-directory ] [--version ] [--help] [--trace] ``` #### 매개 변수 및 옵션 매개 변수 **--config {{`./config-example.json`}}** 간략한 형식: -c {{`./config-example.json`}} 구성 파일*(조건부)* 이 매개 변수는 이 명령이 실행 중인 구성 요소의 구성 설정이 포함된 JSON 파일의 파일 위치를 포함합니다. 구성 파일에 **run** 명령 설정을 지정하는 경우, `--documents` 매개 변수를 지정하면 안 됩니다. 입력 구성에 대한 자세한 정보는 [AWSTOE run 명령에 대한 입력 구성](toe-run-config-input.md) 섹션을 참조하세요. 유효한 위치에는 다음이 포함됩니다. + 로컬 파일 경로({{`./config-example.json`}}) + S3 URI(`s3://{{bucket/key}}`) **--cw-ignore-failures** 간략한 형식: 해당 사항 없음 CloudWatch Logs의 로깅 실패는 무시하세요. **--cw-log-group** 간략한 형식: 해당 사항 없음 CloudWatch Logs의 `LogGroup` 이름입니다. **--cw-log-region** 간략한 형식: 해당 사항 없음 CloudWatch Logs에 적용되는 AWS 리전입니다. **--cw-log-stream** 간략한 형식: 해당 사항 없음 `console.log` 파일을 스트리밍할 AWSTOE 위치를 지정하는 CloudWatch Logs의 `LogStream` 이름입니다. **--document-s3-bucket-owner** 간략한 형식: 해당 사항 없음 S3 URI 기반 문서에 대한 버킷 소유자의 계정 ID입니다. **--documents {{`./doc-1.yaml`,`./doc-n.yaml`}}** Short form: -d {{`./doc-1.yaml`}},{{`./doc-n`}} 구성 요소 문서*(조건부)* 이 매개 변수에는 실행할 YAML 구성 요소 문서의 쉼표로 구분된 파일 위치 목록이 포함됩니다. `--config` 매개 변수를 사용하여 **run** 명령에 대한 YAML 문서를 지정하는 경우, `--documents` 매개 변수를 지정하지 않아야 합니다. 유효한 위치에는 다음이 포함됩니다. + 로컬 파일 경로({{./component-doc-example.yaml}}). + S3 URI(`s3://{{bucket/key}}`). + Image Builder 컴포넌트 빌드 버전 ARN(arn:aws:imagebuilder:us-west-{{2:123456789012}}:component/{{my-example-component}}/2021.12.02/1). 목록의 항목 사이에는 공백이 없고 쉼표만 있습니다. **--execution-id** 간략한 형식: -i 현재 **run** 명령 실행에 적용되는 고유 ID입니다. 이 ID는 해당 파일을 고유하게 식별하고 현재 명령 실행에 연결하기 위해 출력 및 로그 파일 이름에 포함됩니다. 이 설정을 생략하면가 GUID를 AWSTOE 생성합니다. **--log-directory** 간략한 형식: -l 가이 명령 실행의 모든 로그 파일을 AWSTOE 저장하는 대상 디렉터리입니다. 기본적으로 이 파일은 `TOE__` 디렉터리에 위치합니다. 로그 디렉터리를 지정하지 않으면는 현재 작업 디렉터리()를 AWSTOE 사용합니다`.`. **--log-s3-bucket-name** 간략한 형식: -b 구성 요소 로그가 Amazon S3에 저장되는 경우(권장)는 구성 요소 애플리케이션 로그를이 파라미터에 이름이 지정된 S3 버킷에 AWSTOE 업로드합니다. **--log-s3-bucket-owner** 간략한 형식: 해당 사항 없음 구성 요소 로그가 Amazon S3에 저장되는 경우(권장),가 로그 파일을 AWSTOE 작성하는 버킷의 소유자 계정 ID입니다. **--log-s3-key-prefix** 간략한 형식: -k 구성 요소 로그가 Amazon S3에 저장되어 있는 경우(권장), 이 접두사는 버킷 내 로그 위치의 S3 객체 키 접두사입니다. **--parameters {{name1}}={{value1}},{{name2}}={{value2}}...** 간략한 형식: 해당 사항 없음 매개변수는 구성 요소 문서에 정의된 변경 가능한 변수로, 호출 애플케이션이 런타임에 제공할 수 있는 설정을 포함합니다. **--phases** 간략한 형식: -p YAML 구성 요소 문서에서 실행할 단계를 지정하는 쉼표로 구분된 목록입니다. 구성 요소 문서에 추가 단계가 포함된 경우, 해당 단계는 실행되지 않습니다. **--state-directory** 간략한 형식: -s 상태 추적 파일이 저장되는 파일 경로입니다. **--version** 간략한 형식: -v 구성 요소 애플케이션 버전을 지정합니다.옵션 **--help** 간략한 형식: -h 구성 요소 관리 애플케이션 옵션 사용에 대한 도움말 설명서를 표시합니다. **--trace** 간략한 형식: -t 콘솔에 대한 자세한 로깅을 활성화합니다. ### awstoe 검증 명령 이 명령을 실행하면 `--documents` 매개 변수로 지정된 각 구성 요소 문서의 YAML 문서 구문을 검증합니다. #### 구문 ``` awstoe validate [--document-s3-bucket-owner ] --documents [--help] [--trace] ``` #### 매개 변수 및 옵션 매개 변수 **--document-s3-bucket-owner** 간략한 형식: 해당 사항 없음 제공된 S3 URI 기반 문서의 소스 계정 ID **--documents {{`./doc-1.yaml`,`./doc-n.yaml`}}** Short form: -d {{`./doc-1.yaml`}},{{`./doc-n`}} 구성 요소 문서*(필수)* 이 매개 변수에는 실행할 YAML 구성 요소 문서의 쉼표로 구분된 파일 위치 목록이 포함됩니다. 유효한 위치에는 다음이 포함됩니다. + 로컬 파일 경로({{./component-doc-example.yaml}}) + S3 URI(`s3://{{bucket/key}}`) + Image Builder 컴포넌트 빌드 버전 ARN(arn:aws:imagebuilder:us-west-{{2:123456789012}}:component/{{my-example-component}}/2021.12.02/1) 목록의 항목 사이에는 공백이 없고 쉼표만 있습니다.옵션 **--help** 간략한 형식: -h 구성 요소 관리 애플케이션 옵션 사용에 대한 도움말 설명서를 표시합니다. **--trace** 간략한 형식: -t 콘솔에 대한 자세한 로깅을 활성화합니다.