

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

# 에서 AMI 이미지 파이프라인 생성 AWS CLI
<a name="cli-create-image-pipeline"></a>

에서 이미지 파이프라인을 생성하려면 파이프라인에 적용되는 구성 옵션을 사용하여 **create-image-pipeline** 명령을 AWS CLI실행합니다. 모든 파이프라인 구성이 포함된 JSON 파일을 생성하거나 런타임 시 구성을 지정할 수 있습니다. 이 섹션에서는 JSON 구성 파일 메서드를 사용하여 명령을 단순화합니다.

파이프라인이 기본 이미지와 구성 요소의 보류 중인 업데이트를 통합하기 위해 새 이미지를 빌드하는 빈도는 구성한 `schedule`에 따라 다릅니다. `schedule`(에)는 다음 속성이 있습니다.
+ `scheduleExpression` - 파이프라인 실행 일정을 설정하여 `pipelineExecutionStartCondition`(을)를 평가하고 빌드를 시작할지 여부를 결정합니다. 일정은 cron 표현식으로 구성됩니다. Image Builder에서 cron 표현식의 형식을 지정하는 방법에 대한 자세한 내용은 [Image Builder에서 cron 표현식 사용](cron-expressions.md) 섹션을 참조하세요.
+ `pipelineExecutionStartCondition` - 파이프라인에서 빌드를 시작할지 여부를 결정합니다. 유효한 값으로는 다음이 포함됩니다.
  + `EXPRESSION_MATCH_ONLY` - 파이프라인은 cron 표현식이 현재 시간과 일치할 때마다 새 이미지를 생성합니다.
  + `EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE` - 기본 이미지나 구성 요소에 보류 중인 변경 사항이 없는 한 파이프라인에서 새 이미지 빌드를 시작하지 않습니다.

에서 **create-image-pipeline** 명령을 실행하면 AWS CLI많은 구성 리소스가 선택 사항입니다. 그러나 일부 리소스에는 파이프라인이 생성하는 이미지 유형에 따라 조건부 요구 사항이 있습니다. AMI 이미지 파이프라인에는 다음 리소스 식별자가 필요합니다.
+ 이미지 레시피 ARN
+ 인프라 구성 ARN

 

**예: Windows 2019 이미지 생성**  
이 예제에서는 매주 일요일에 실행되도록 예약된 파이프라인을 구성합니다. 첫 번째 단계에 표시된 구성 파일은 다른 설정과 함께 이미지 레시피, 인프라 및 배포 구성에 기존 리소스를 사용하여 Windows 2019 이미지를 생성합니다.

1. 

**구성 파일 생성(선택 사항)**

   이 예제에서는 라는 구성 파일을 `create-image-pipeline.json` 사용하여 한 곳에서 설정을 구성합니다. 또는 명령을 실행할 때 명령줄 옵션을 사용하여 구성 파일의 여기에 표시된 모든 세부 정보를 지정할 수 있습니다.

   ```
   {
   	"name": "{{ExampleWindows2019Pipeline}}",
   	"description": "{{Builds Windows 2019 Images}}",
   	"enhancedImageMetadataEnabled": true,
   	"imageRecipeArn": "arn:aws:imagebuilder:us-west-{{2:123456789012}}:image-recipe/{{my-example-recipe}}/2020.12.03",
   	"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-{{2:123456789012}}:infrastructure-configuration/{{my-example-infrastructure-configuration}}",
   	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-{{2:123456789012}}:distribution-configuration/{{my-example-distribution-configuration}}",
   	"imageTestsConfiguration": {
   		"imageTestsEnabled": true,
   		"timeoutMinutes": 60
   	},
   	"schedule": {
   		"scheduleExpression": "cron(0 0 * * SUN *)",
   		"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
   	},
   	"status": "ENABLED"
   }
   ```
**참고**  
JSON 파일 경로의 시작 부분에 `file://` 표기법을 포함시켜야 합니다.
JSON 파일의 경로는 명령을 실행하는 기본 운영 체제에 대한 적절한 규칙을 따라야 합니다. 예를 들어 Windows에서는 디렉터리 경로를 참조하기 위해 백슬래시(\\)를 사용하고 Linux 및 macOS에서는 슬래시(/)를 사용합니다.

1. 

**명령을 실행하여 이미지 생성**

   이 예제에서는 첫 번째 단계에서 생성된 구성 파일을 `create-image-pipeline` 명령에 대한 입력으로 사용합니다. 또는 명령을 실행할 때 파이프라인의 설정과 리소스를 직접 지정할 수 있습니다. 자세한 내용은 참조의 [create-image-pipeline](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-image-pipeline.html)을 *AWS CLI 참조*하세요.

   ```
   aws imagebuilder create-image-pipeline --cli-input-json file://create-image-pipeline.json
   ```