컨테이너 레시피의 새 버전 생성

새 컨테이너 레시피 버전을 생성하려면:

1. 컨테이너 레시피 세부 정보 페이지 상단에서 새 버전 생성을 선택합니다. 컨테이너 레시피의 레시피 생성 페이지로 이동합니다.

2. 새 버전을 만들려면 변경한 다음 레시피 생성을 선택합니다.

1. CLI입력 JSON 파일 생성

   create-container-recipe 명령의 모든 입력을 인라인 명령 파라미터로 제공할 수 있습니다. 하지만 결과로 생성되는 명령은 상당히 길 수 있습니다. 명령을 간소화하기 위해 대신 모든 컨테이너 레시피 JSON 설정이 포함된 파일을 제공할 수 있습니다.

   참고

   JSON파일에 있는 데이터 값의 명명 규칙은 Image Builder API 작업 요청 매개변수에 지정된 패턴을 따릅니다. API명령 요청 파라미터를 검토하려면 EC2Image Builder API 레퍼런스의 CreateContainerRecipe명령을 참조하십시오.

   데이터 값을 명령줄 매개 변수로 제공하려면 에 지정된 매개 변수 이름을 참조하십시오. AWS CLI 명령 참조.

   다음은 이 예제의 파라미터를 요약한 것입니다.

   • 구성 요소(객체 배열, 필수) - ComponentConfiguration 객체 배열을 포함합니다. 빌드 구성 요소를 하나 이상 지정해야 합니다.

     참고

     Image Builder는 레시피에 지정한 순서대로 구성 요소를 설치합니다. 하지만 벤치마크 테스트가 출력 이미지에 대해 실행되도록 하기 위해 CIS 강화 구성 요소는 항상 마지막에 실행됩니다.

     • 구성 요소 ARN (문자열, 필수) — 구성 요소입니다. ARN

       작은 정보

       예제를 사용하여 자체 컨테이너 레시피를 만들려면 예제를 레시피에 사용 중인 구성 요소의 ARNs 로 바꾸십시오. ARNs 여기에는 다음이 포함됩니다. AWS 리전, 이름, 각각의 버전 번호.

     • 파라미터(객체 배열) - ComponentParameter 객체 배열을 포함합니다. 입력 매개 변수가 필요하지만 구성 요소에 정의된 기본값이 없는 경우 값을 제공해야 합니다. 필수 매개변수가 누락되어 있고 기본값이 정의되지 않은 경우 Image Builder는 레시피 버전을 생성하지 않습니다.

       중요

       구성 요소 매개변수는 일반 텍스트 값이며 로그인되어 있습니다. AWS CloudTrail을 사용할 것을 권장합니다. AWS Secrets Manager 또는 AWS Systems Manager 비밀번호를 저장하기 위한 파라미터 스토어. Secrets Manager에 대한 자세한 내용은 Secrets Manager란 무엇입니까? 를 참조하십시오. ... 에서 AWS Secrets Manager 사용자 가이드. 에 대한 자세한 내용은 AWS Systems Manager 파라미터 저장소는 다음을 참조하십시오. AWS Systems Manager의 파라미터 저장소 AWS Systems Manager 사용자 가이드.

       • 이름(문자열, 필수) — 설정할 구성 요소 파라미터의 이름입니다.

       • 값(문자열 배열, 필수) - 명명된 구성 요소 파라미터의 값을 설정하는 문자열 배열을 포함합니다. 구성 요소에 대해 정의된 기본값이 있고 다른 값이 제공되지 않은 경우 AWSTOE 기본값을 사용합니다.

   • containerType(문자열, 필수) — 생성할 컨테이너의 유형입니다. 유효한 값으로는 DOCKER가 포함됩니다.

   • dockerfileTemplateData(문자열) — 이미지를 빌드하는 데 사용되는 Dockerfile 템플릿으로, 인라인 데이터 블롭으로 표현됩니다.

   • name(문자열, 필수) - 컨테이너 레시피의 이름입니다.

   • description(문자열) - 컨테이너 레시피에 대한 설명입니다.

   • parentImage(문자열, 필수) — 컨테이너 레시피가 사용자 지정 이미지의 기반으로 사용하는 이미지입니다. 값은 기본 이미지 ARN 또는 AMI ID일 수 있습니다.

   • platformOverride(문자열) - 사용자 지정 기본 이미지를 사용할 때의 운영 체제 플랫폼을 지정합니다.

   • semanticVersion<major>(문자열, 필수) — 다음 형식으로 지정된 컨테이너 레시피의 시맨틱 버전으로, 각 위치에는 특정 버전을 나타내는 숫자 값이 있습니다. <minor>. <patch>. 예를 들어 1.0.0(이)가 됩니다. Image Builder 리소스의 시맨틱 버전 관리에 대한 자세한 내용은 Image Builder의 시맨틱 버전 관리(을)를 참조하십시오.

   • tags(문자열 맵) – 컨테이너 레시피에 연결되는 태그입니다.

   • instanceConfiguration(객체) — 컨테이너 이미지를 빌드하고 테스트하기 위한 인스턴스를 구성하는 데 사용할 수 있는 옵션 그룹입니다.

     • image (string) — 컨테이너 빌드 및 테스트 인스턴스의 기본 이미지로 사용할 AMI ID입니다. 이 값을 지정하지 않으면 Image Builder는 적절한 아마존 ECS 최적화 AMI 이미지를 기본 이미지로 사용합니다.

     • blockDeviceMappings(객체 배열) — image 매개변수에 AMI 지정된 Image Builder에서 인스턴스를 빌드하기 위해 연결할 블록 디바이스를 정의합니다.

       • deviceName(문자열) — 이러한 매핑이 적용되는 기기입니다.

       • ebs (object) — 이 매핑에 대한 Amazon EBS 특정 구성을 관리하는 데 사용됩니다.

         • deleteOnTermination(Boolean) — 연결된 디바이스 종료 시 삭제를 구성하는 데 사용됩니다.

         • encrypted(부울) – 장치 암호화를 구성하는 데 사용됩니다.

         • volumeSize(정수) - 디바이스의 볼륨 크기를 재정의하는 데 사용됩니다.

         • volumeType(문자열) - 기기의 볼륨 유형을 재정의하는 데 사용됩니다.

   • targetRepository(객체, 필수) — 파이프라인이 실행되는 리전 (리전 1) 에 대한 파이프라인 배포 구성에 지정된 다른 리포지토리가 없는 경우 컨테이너 이미지의 대상 리포지토리입니다.

     • repositoryName(문자열, 필수) — 출력 컨테이너 이미지가 저장되는 컨테이너 리포지토리의 이름입니다. 이 이름에 리포지토리 위치가 접두사로 추가됩니다.

     • service(문자열, 필수) – 이 이미지가 등록된 서비스를 지정합니다.

   • workingDirectory(문자열) — 빌드 및 테스트 워크플로 중에 사용할 작업 디렉토리입니다.

   {
   	"components": [ 
   	  { 
   		 "componentArn": "arn:aws:imagebuilder:us-east-1:123456789012:component/helloworldal2/x.x.x"
   	  }
   	],
   	"containerType": "DOCKER",
   	"description": "My Linux Docker container image",
   	"dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
   	"name": "amazonlinux-container-recipe",
   	"parentImage": "amazonlinux:latest",
   	"platformOverride": "Linux",
   	"semanticVersion": "1.0.2",
   	"tags": { 
   	  "sometag" : "Tag detail" 
   	},
   	"instanceConfiguration": {
   	  "image": "ami-1234567890",
   	  "blockDeviceMappings": [
   		 {
   			"deviceName": "/dev/xvda",
   			"ebs": {
   				"deleteOnTermination": true,
   				"encrypted": false,
   				"volumeSize": 8,
   				"volumeType": "gp2"
   			 }
   		  }			
   	  ]
   	},
   	"targetRepository": { 
   	  "repositoryName": "myrepo",
   	  "service": "ECR"
   	},
   	"workingDirectory": "/tmp"
   }

2. 레시피 생성

   다음 명령을 사용하여 레시피를 생성합니다. 이전 단계에서 만든 JSON 파일 이름을 --cli-input-json 파라미터에 입력합니다.

   aws imagebuilder create-container-recipe --cli-input-json file://create-container-recipe.json

   참고

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

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