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

이미지 및 빌드 버전 나열

Image Builder 콘솔의 이미지 페이지에서 사용자가 소유하고, 사용자와 공유되고, 사용자가 액세스할 수 있는 모든 Image Builder 이미지 리소스의 목록을 볼 수 있습니다. 목록 결과에는 해당 리소스에 대한 몇 가지 주요 세부 정보가 포함됩니다.

또한 계정에서 워크플로 작업이 보류 중인 이미지도 모두 볼 수 있습니다.

이미지 나열

이 섹션에서는 이미지에 대한 정보를 나열할 수 있는 다양한 방법을 설명합니다.

액세스할 수 있는 Image Builder 이미지 리소스를 다음 방법 중 하나를 사용하여 나열할 수 있습니다. API 작업은 EC2 Image Builder API 참조ListImages의 섹션을 참조하세요. 관련 SDK 요청은 동일한 페이지의 참조 링크도 참조하세요.

콘솔에 이미지 나열

다음 단계에 따라 콘솔에서 이미지 목록 페이지를 엽니다.

콘솔의 이미지 페이지는 이미지 소유권 또는 보류 중인 워크플로 작업에 따라 탭으로 구분됩니다. 이 섹션에서는 소유하거나 액세스 권한이 있는 이미지를 보여주는 처음 3개의 탭을 다룹니다.

AWS CLI 명령을 사용하여 이미지 나열

에서 list-images 명령을 실행하면 소유하거나 액세스할 AWS CLI수 있는 이미지 목록을 가져올 수 있습니다.

다음 명령 예제는 필터 없이 list-images 명령을 사용하여 소유한 Image Builder 이미지 리소스를 모두 나열하는 방법을 보여줍니다.

예제: 모든 이미지 나열

aws imagebuilder list-images

출력:

{
	"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
	"imageVersionList": [
		{
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0",
				"name": "image-recipe-name",
				"type": "AMI",
				"version": "1.0.0",
				"platform": "Linux",
				"owner": "123456789012",
				"dateCreated": "2022-04-28T01:38:23.286Z"
		},
		{
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-win/1.0.1",
				"name": "image-recipe-win",
				"type": "AMI",
				"version": "1.0.1",
				"platform": "Windows",
				"owner": "123456789012",
				"dateCreated": "2022-04-28T01:38:23.286Z"
		},
		{
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-macos/1.1.1",
				"name": "image-recipe-macos",
				"type": "AMI",
				"version": "1.1.1",
				"platform": "macOS",
				"owner": "123456789012",
				"dateCreated": "2022-04-28T01:38:23.286Z"
		}
	]
}

list-images 명령을 실행할 때 다음 예제와 같이 필터를 적용하여 결과를 간소화할 수 있습니다. 결과를 필터링하는 방법에 대한 자세한 내용은 AWS CLI 명령 참조의 list-images 명령을 참조하십시오.

예제: Linux 이미지용 필터

aws imagebuilder list-images --filters name="platform",values="Linux"

출력:

{
	"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
	"imageVersionList": [
		{
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0",
				"name": "image-recipe-name",
				"type": "AMI",
				"version": "1.0.0",
				"platform": "Linux",
				"owner": "123456789012",
				"dateCreated": "2022-04-28T01:38:23.286Z"
		}
	]
}

작업 대기 중인 이미지 나열

이미지 워크플로에서 WaitForAction 단계 작업을 사용하면 처리를 재개하거나 워크플로에 실패하라는 신호를 보낼 때까지 워크플로가 일시 중지됩니다. 계속하기 전에 외부 프로세스를 실행해야 하는 경우 이 단계 작업을 사용할 수 있습니다. 그런 다음 SendWorkflowStepAction을 사용하여 일시 중지된 단계에 RESUME 또는 STOP으로 신호를 보낼 수 있습니다. 콘솔에서 워크플로를 중지하거나 재개할 수도 있습니다.

다음 탭은 현재 일시 중지되어 재개 또는 중지 신호를 기다리는 워크플로 단계를 통해 계정의 모든 이미지 리소스 목록을 가져오는 방법을 보여줍니다. 탭에는 콘솔 단계와 AWS CLI 명령이 포함됩니다.

API 또는를 사용하여 작업을 기다리는 워크플로 단계 목록을 SDK 가져올 수도 있습니다. API 작업은 EC2 Image Builder API 참조ListWaitingWorkflowSteps의 섹션을 참조하세요. 관련 SDK 요청은 동일한 페이지의 추가 링크 참조를 참조하세요.

Console

콘솔의 작업 대기 탭으로 이동하려면 다음 단계를 따르세요.

1. 에서 EC2 Image Builder 콘솔을 엽니다https://console.aws.amazon.com/imagebuilder/.

2. 탐색 창에서 이미지를 선택합니다. 그러면 이미지 목록 페이지가 열립니다.

3. 목록 페이지에서 작업 대기 탭을 선택합니다.

4. (선택 사항) 단계를 중지하거나 재개하려면 이름 옆의 확인란을 선택한 다음 단계 중지 또는 단계 재개를 선택합니다. 확인란을 2개 이상 선택하여 선택한 모든 단계에 대해 동일한 작업을 수행할 수 있습니다.

보류 중인 워크플로 단계 세부 정보

보류 단계의 워크플로 세부 정보는 다음과 같습니다.

• 이미지 이름-보류 단계가 있는 이미지 리소스의 이름입니다. 이름 링크를 선택하여 해당 이미지의 세부 정보 페이지를 표시할 수 있습니다.

• 보류 단계 이름-작업을 기다리고 있는 워크플로 단계의 이름입니다.

• 단계 실행 ID-워크플로 단계의 런타임 인스턴스를 고유하게 식별합니다. 연결된 ID를 선택하여 단계의 런타임 세부 정보를 표시할 수 있습니다.

• 단계 시작-이 워크플로의 런타임 인스턴스가 시작된 시점의 타임스탬프입니다.

• 워크플로 ARN - 보류 중인 단계가 있는 워크플로의 Amazon 리소스 이름(ARN)입니다.

• 작업-대기 상태에 있는 단계 작업입니다.

AWS CLI

에서 list-waiting-workflow-steps 명령을 실행하면 이미지 생성 프로세스를 완료하기 전에 작업을 기다리는 워크플로 단계가 있는 계정의 모든 이미지 목록이 AWS CLI표시됩니다.

다음 명령 예제는 list-waiting-workflow-steps 명령을 사용하여 작업 대기 중인 워크플로 단계가 있는 계정의 모든 이미지를 나열하는 방법을 보여줍니다.

예: 대기 중인 워크플로 단계가 있는 계정의 이미지 나열

aws imagebuilder list-waiting-workflow-steps

출력:

이 예제의 출력에는 작업을 대기 중인 단계가 있는 계정 내 이미지 하나가 표시됩니다.

{
    "steps": [
        {
            "imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:image/example-image/1.0.0/8",
            "name": "WaitForAction",
            "workflowExecutionId": "wf-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "stepExecutionId": "step-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/wait-for-action/1.0.0/1",
            "startTime": "2023-11-21T23:21:23.609Z",
            "action": "WaitForAction"
        }
    ]
}

이미지 빌드 버전 나열

Image Builder 콘솔의 이미지 빌드 버전 페이지에서 빌드 버전 목록과 소유한 이미지 리소스의 추가 세부 정보를 확인할 수 있습니다. Image Builder API, SDKs또는에서 명령 또는 작업을 사용하여 이미지 빌드 버전을 나열 AWS CLI 할 수도 있습니다.

다음 방법 중 하나를 사용하여 소유한 이미지 리소스의 이미지 빌드 버전을 나열할 수 있습니다. API 작업은 EC2 Image Builder API 참조ListImageBuildVersions의 섹션을 참조하세요. 연결된 SDK 요청은 동일한 페이지의 참조 링크도 참조하세요.

Console

버전 세부 정보

Image Builder 콘솔의 이미지 빌드 버전 페이지에 있는 세부 정보는 다음과 같습니다.

• 버전 — 이미지 리소스 빌드 버전. Image Builder 콘솔에서 버전은 이미지 세부 정보 페이지에 연결됩니다.

• 유형 - Image Builder가이 이미지 리소스(AMI또는 컨테이너 이미지)를 생성할 때 배포한 출력 유형입니다.

• 생성 날짜 — Image Builder에서 이미지 빌드 버전을 만든 날짜 및 시간.

• 이미지 상태 – 이미지 빌드 버전의 현재 상태. 상태는 이미지 빌드 또는 배치와 관련될 수 있습니다. 예를 들어 빌드 프로세스 중에 Building 또는 Distributing 상태가 표시될 수 있습니다. 이미지 배치의 경우 Deprecated 또는 Deleted 상태가 표시될 수 있습니다.

• 실패 이유 — 이미지 상태의 이유. Image Builder 콘솔에는 빌드가 실패한 이유만 표시됩니다(이미지 상태는 Failed(와)과 같음).

• 보안 조사 결과 - 참조된 이미지 빌드 버전의 집계된 이미지 스캔 결과.

• ARN - 이미지 리소스의 참조 버전에 대한 Amazon 리소스 이름(ARN)입니다.

• 로그 스트림 - 참조된 이미지 빌드 버전의 로그 스트림 세부 정보에 대한 링크.

목록 버전

Image Builder 콘솔에서 이미지 빌드 버전을 나열하려면 다음 단계를 수행하십시오.

1. 에서 EC2 Image Builder 콘솔을 엽니다https://console.aws.amazon.com/imagebuilder/.

2. 탐색 창에서 이미지를 선택합니다. 기본적으로 이미지 목록에는 소유하고 있는 각 이미지의 현재 버전이 표시됩니다.

3. 이미지의 모든 버전 목록을 보려면 현재 버전 링크를 선택합니다. 링크를 클릭하면 특정 이미지의 모든 빌드 버전이 나열된 이미지 빌드 버전 페이지가 열립니다.

AWS CLI

에서 list-image-build-versions 명령을 실행하면 지정된 이미지 리소스에 대한 빌드 버전의 전체 목록이 AWS CLI표시됩니다. 이 명령을 실행하려면 이미지를 소유해야 합니다.

다음 명령 예제는 list-image-build-versions 명령을 사용하여 지정된 이미지의 모든 빌드 버전을 나열하는 방법을 보여줍니다.

예제: 특정 이미지의 빌드 버전 나열

aws imagebuilder list-image-build-versions --image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0

출력:

이 예제의 출력에는 지정된 이미지 레시피에 대한 두 개의 빌드 버전이 포함됩니다.

{
	 "requestId": "12f3e45d-67cb-8901-af23-45ed678c9b01",
	 "imageSummaryList": [
		  {
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/2",
				"name": "image-recipe-name",
				"type": "AMI",
				"version": "1.0.0/2",
				"platform": "Linux",
				"osVersion": "Amazon Linux 2",
				"state": {
					 "status": "AVAILABLE"
				},
				"owner": "123456789012",
				"dateCreated": "2023-03-10T01:04:40.609Z",
				"outputResources": {
					 "amis": [
						  {
								"region": "us-west-2",
								"image": "ami-012b3456789012c3d",
								"name": "image-recipe-name 2023-03-10T01-05-12.541Z",
								"description": "First verison of image-recipe-name",
								"accountId": "123456789012"
						  }
					 ]
				},
				"tags": {}
		  },
		  {
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/1",
				"name": "image-recipe-name",
				"type": "AMI",
				"version": "1.0.0/1",
				"platform": "Linux",
				"osVersion": "Amazon Linux 2",
				"state": {
					 "status": "AVAILABLE"
				},
				"owner": "123456789012",
				"dateCreated": "2023-03-10T00:07:16.384Z",
				"outputResources": {
					 "amis": [
						  {
								"region": "us-west-2",
								"image": "ami-0d1e23456789f0a12",
								"name": "image-recipe-name 2023-03-10T00-07-18.146132Z",
								"description": "First verison of image-recipe-name",
								"accountId": "123456789012"
						  }
					 ]
				},
				"tags": {}
		  }
	 ]
}

참고

현재 list-image-build-versions 명령의 출력에는 보안 조사 결과나 로그 스트림이 포함되지 않습니다.