기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 이미지 및 빌드 버전 나열
Image Builder 콘솔의 **이미지** 페이지에서 사용자가 소유하고, 사용자와 공유되고, 사용자가 액세스할 수 있는 모든 Image Builder 이미지 리소스의 목록을 볼 수 있습니다. 목록 결과에는 해당 리소스에 대한 몇 가지 주요 세부 정보가 포함됩니다.
또한 계정에서 워크플로 작업이 보류 중인 이미지도 모두 볼 수 있습니다.
**Topics**
+ [이미지 나열](#list-images)
+ [작업 대기 중인 이미지 나열](#list-images-waiting-for-action)
+ [이미지 빌드 버전 나열](#list-image-build-versions)
## 이미지 나열
이 섹션에서는 이미지에 대한 정보를 나열할 수 있는 다양한 방법을 설명합니다.
액세스할 수 있는 Image Builder 이미지 리소스를 다음 방법 중 하나를 사용하여 나열할 수 있습니다. API 작업에 대한 내용은 *EC2 Image Builder API 참조*의 [ListImages](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html)를 참조하십시오. 연결된 SDK 요청의 경우, 같은 페이지의 [참고 항목](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html#API_ListImages_SeeAlso) 링크를 참조하세요.
**Topics**
+ [콘솔에 이미지 나열](#list-images-console)
+ [AWS CLI 명령을 사용하여 이미지 나열](#list-images-cli)
### 콘솔에 이미지 나열
다음 단계에 따라 콘솔에서 **이미지** 목록 페이지를 엽니다.
1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)에서 EC2 Image Builder 콘솔을 엽니다.
1. 탐색 창에서 **이미지**를 선택합니다.
콘솔의 **이미지** 페이지는 이미지 소유권 또는 보류 중인 워크플로 작업에 따라 탭으로 구분됩니다. 이 섹션에서는 소유하거나 액세스 권한이 있는 이미지를 보여주는 처음 3개의 탭을 다룹니다.
#### 콘솔 탭: 내 소유
**내 소유** 탭에서 다음 필터를 사용하여 이미지 목록 결과를 간소화할 수 있습니다.
+ 검색 창에 이름 전체 또는 일부를 검색할 수 있습니다.
+ 운영 체제 플랫폼(Windows, Linux 또는 macOS)에 따라 이미지를 필터링할 수 있습니다.
+ 생성되는 출력 유형(AMI 또는 컨테이너 이미지)에 따라 이미지를 필터링할 수 있습니다.
+ **필터 소스를** 사용하여 가상 머신(VMIE) 또는 ISO 디스크 이미지에서 가져온 이미지를 찾을 수 있습니다.
필터 제어에 따라 **내 소유** 탭에는 사용자가 만든 Image Builder 이미지 목록이 표시되며 나열된 리소스에 대한 다음 세부 정보가 포함됩니다.
**이름/버전**
Image Builder 이미지 리소스 이름은 빌드된 레시피 이름과 버전으로 시작됩니다. 링크를 선택하면 관련된 모든 이미지 빌드 버전을 볼 수 있습니다.
**유형**
Image Builder가 이 이미지 리소스(AMI 또는 컨테이너 이미지)에 대해 생성한 출력 이미지 유형입니다.
**플랫폼**
이미지 리소스의 운영 체제 플랫폼(예: "Linux", "Windows" 또는 "macOS")입니다.
**이미지 소스**
Image Builder가 이 이미지 리소스를 만드는 데 사용한 기본 이미지의 출처입니다. 주로 가상 컴퓨터(**VMIE**)에서 가져온 이미지의 결과를 필터링하는 데 사용됩니다.
**생성 시간**
Image Builder에서 이미지 리소스의 현재 버전을 만든 날짜와 시간입니다.
**ARN**
현재 이미지 리소스 버전의 Amazon 리소스 이름(ARN)입니다.
#### 콘솔 탭: 나와 공유됨
**나와 공유됨** 탭에서 다음 필터를 사용하여 이미지 목록 결과를 간소화할 수 있습니다.
+ 검색 창에 이름 전체 또는 일부를 검색할 수 있습니다.
+ 운영 체제 플랫폼(Windows, Linux 또는 macOS)에 따라 이미지를 필터링할 수 있습니다.
+ 생성되는 출력 유형(AMI 또는 컨테이너 이미지)에 따라 이미지를 필터링할 수 있습니다.
+ **필터 소스를** 사용하여 가상 머신(VMIE) 또는 ISO 디스크 이미지에서 가져온 이미지를 찾을 수 있습니다.
필터 제어에 따라 **나와 공유됨** 탭에는 사용자와 공유된 Image Builder 이미지 목록이 표시되며 나열된 리소스에 대한 다음 세부 정보가 포함됩니다.
**이미지 이름**
사용자와 공유된 이미지 리소스의 이름입니다. 레시피에서 공유 이미지를 사용하려면 **관리 이미지 선택** 옵션을 선택하고 **이미지 출처**를 **나와 공유된 이미지**로 변경합니다.
**유형**
Image Builder가 이 이미지 리소스(AMI 또는 컨테이너 이미지)에 대해 생성한 출력 이미지 유형입니다.
**버전**
이미지 리소스의 운영 체제 플랫폼 버전으로, 일반적으로 .. 형식의 숫자 필드입니다.
**이미지 소스**
해당하는 경우 Image Builder가 이 이미지 리소스를 만드는 데 사용한 기본 이미지의 출처입니다. 주로 가상 컴퓨터(**VMIE**)에서 가져온 이미지의 결과를 필터링하는 데 사용됩니다.
**플랫폼**
이미지 리소스의 운영 체제 플랫폼(예: "Linux", "Windows" 또는 "macOS")입니다.
**생성 시간**
Image Builder에서 사용자와 공유된 이미지 리소스 버전을 만든 날짜와 시간입니다.
**소유자**
공유된 이미지 리소스의 소유자입니다.
**ARN**
사용자와 공유된 이미지 리소스 버전의 Amazon 리소스 이름(ARN)입니다.
#### 콘솔 탭: Amazon에서 관리
**Amazon에서 관리** 탭에서 다음 필터를 사용하여 이미지 목록 결과를 간소화할 수 있습니다.
+ 검색 창에 이름 전체 또는 일부를 검색할 수 있습니다.
+ 운영 체제 플랫폼(Windows, Linux 또는 macOS)에 따라 이미지를 필터링할 수 있습니다.
+ 생성되는 출력 유형(AMI 또는 컨테이너 이미지)에 따라 이미지를 필터링할 수 있습니다.
+ **필터 소스를** 사용하여 가상 머신(VMIE) 또는 ISO 디스크 이미지에서 가져온 이미지를 찾을 수 있습니다.
필터 제어에 따라 **Amazon에서 관리** 탭에는 레시피의 기본 이미지로 사용할 수 있는 Amazon 관리형 Image Builder 이미지 목록이 표시됩니다. Image Builder는 나열된 리소스에 대해 다음과 같은 세부 정보를 표시합니다.
**이미지 이름**
관리형 이미지의 이름입니다. 레시피를 생성할 때 기본 이미지의 기본값은 **빠른 시작(Amazon에서 관리)**입니다. 이 탭에 나열된 이미지는 레시피를 생성할 때 기본 이미지로 선택한 운영 체제 플랫폼과 관련된 **이미지 이름** 목록을 채웁니다.
**유형**
Image Builder가 이 이미지 리소스(AMI 또는 컨테이너 이미지)에 대해 생성한 출력 이미지 유형입니다.
**버전**
이미지 리소스의 운영 체제 플랫폼 버전으로, 일반적으로 .. 형식의 숫자 필드입니다.
**플랫폼**
이미지 리소스의 운영 체제 플랫폼(예: "Linux", "Windows" 또는 "macOS")입니다.
**생성 시간**
Image Builder에서 사용자와 공유된 이미지 리소스 버전을 만든 날짜와 시간입니다.
**소유자**
Amazon은 관리형 이미지를 소유합니다.
**ARN**
사용자와 공유된 이미지 리소스 버전의 Amazon 리소스 이름(ARN)입니다.
### AWS CLI 명령을 사용하여 이미지 나열
에서 **[list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)** 명령을 실행하면 소유하거나 액세스할 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html) 명령을 참조하십시오.
**예제: 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](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html)를 참조하세요. 연결된 SDK 요청의 경우, 같은 페이지의 [참고 항목](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html#API_ListWaitingWorkflowSteps_SeeAlso) 링크를 참조하세요.
------
#### [ Console ]
콘솔의 **작업 대기** 탭으로 이동하려면 다음 단계를 따르세요.
1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)에서 EC2 Image Builder 콘솔을 엽니다.
1. 탐색 창에서 **이미지**를 선택합니다. 그러면 **이미지** 목록 페이지가 열립니다.
1. 목록 페이지에서 **작업 대기** 탭을 선택합니다.
1. (선택 사항) 단계를 중지하거나 재개하려면 이름 옆의 확인란을 선택한 다음 **단계 중지** 또는 **단계 재개**를 선택합니다. 확인란을 2개 이상 선택하여 선택한 모든 단계에 대해 동일한 작업을 수행할 수 있습니다.
**보류 중인 워크플로 단계 세부 정보**
보류 단계의 워크플로 세부 정보는 다음과 같습니다.
+ **이미지 이름**-보류 단계가 있는 이미지 리소스의 이름입니다. 이름 링크를 선택하여 해당 이미지의 세부 정보 페이지를 표시할 수 있습니다.
+ **보류 단계 이름**-작업을 기다리고 있는 워크플로 단계의 이름입니다.
+ **단계 실행 ID**-워크플로 단계의 런타임 인스턴스를 고유하게 식별합니다. 연결된 ID를 선택하여 단계의 런타임 세부 정보를 표시할 수 있습니다.
+ **단계 시작**-이 워크플로의 런타임 인스턴스가 시작된 시점의 타임스탬프입니다.
+ **워크플로 ARN**-보류 중인 단계가 있는 워크플로의 Amazon 리소스 이름(ARN)입니다.
+ **작업**-대기 상태에 있는 단계 작업입니다.
------
#### [ AWS CLI ]
에서 **[list-waiting-workflow-steps](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-waiting-workflow-steps.html)** 명령을 실행하면 이미지 생성 프로세스를 완료하기 전에 작업을 기다리는 워크플로 단계가 있는 계정의 모든 이미지 목록이 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](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html)를 참조하십시오. 연결된 SDK 요청의 경우, 같은 페이지의 [참고 항목](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html#API_ListImageBuildVersions_SeeAlso) 링크를 참조하세요.
------
#### [ Console ]
**버전 세부 정보**
Image Builder 콘솔의 **이미지 빌드 버전** 페이지에 있는 세부 정보는 다음과 같습니다.
+ **버전** — 이미지 리소스 빌드 버전. Image Builder 콘솔에서 버전은 이미지 세부 정보 페이지에 연결됩니다.
+ **유형** — Image Builder가 이 이미지 리소스(AMI 또는 컨테이너 이미지)를 생성할 때 배포한 출력 유형.
+ **생성 날짜** — Image Builder에서 이미지 빌드 버전을 만든 날짜 및 시간.
+ **이미지 상태** – 이미지 빌드 버전의 현재 상태. 상태는 이미지 빌드 또는 배치와 관련될 수 있습니다. 예를 들어 빌드 프로세스 중에 `Building` 또는 `Distributing` 상태가 표시될 수 있습니다. 이미지 배치의 경우 `Deprecated` 또는 `Deleted` 상태가 표시될 수 있습니다.
+ **실패 이유** — 이미지 상태의 이유. Image Builder 콘솔에는 빌드가 실패한 이유만 표시됩니다(**이미지 상태**는 `Failed`(와)과 같음).
+ **보안 조사 결과** - 참조된 이미지 빌드 버전의 집계된 이미지 스캔 결과.
+ **ARN** — 이미지 리소스의 참조 버전의 Amazon 리소스 이름(ARN).
+ **로그 스트림** - 참조된 이미지 빌드 버전의 로그 스트림 세부 정보에 대한 링크.
**목록 버전**
Image Builder 콘솔에서 이미지 빌드 버전을 나열하려면 다음 단계를 수행하십시오.
1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)에서 EC2 Image Builder 콘솔을 엽니다.
1. 탐색 창에서 **이미지**를 선택합니다. 기본적으로 이미지 목록에는 소유하고 있는 각 이미지의 현재 버전이 표시됩니다.
1. 이미지의 모든 버전 목록을 보려면 현재 버전 링크를 선택합니다. 링크를 클릭하면 특정 이미지의 모든 빌드 버전이 나열된 **이미지 빌드 버전** 페이지가 열립니다.
------
#### [ AWS CLI ]
에서 **[list-image-build-versions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html)** 명령을 실행하면 지정된 이미지 리소스에 대한 빌드 버전의 전체 목록이 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** 명령의 출력에는 보안 조사 결과나 로그 스트림이 포함되지 않습니다.
------