> For the complete documentation index, see [llms.txt](https://ia-cloud.gitbook.io/cloudia-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ia-cloud.gitbook.io/cloudia-manual/storage/image.md).

# 이미지

`이미지`는 가상머신 생성에 필요한 운영체제(OS) 이미지를 업로드하고 관리할 수 있는 공간입니다.\
사용자는 프로젝트 내에서 이미지 목록을 확인하고, 새 이미지를 추가하거나 기존 이미지를 삭제할 수 있습니다.\
또한, 관리자가 추가한 이미지는 모든 프로젝트에서 공통적으로 사용할 수 있습니다.

## 화면 개요

* `목록 화면`: 이미지 현황을 조회하고 업로드, 복제, 삭제 작업을 시작합니다.
* `업로드 화면`: 스토리지 도메인과 이미지 파일을 지정해 새 프로젝트 이미지를 등록합니다.
* `복제 모달`: 선택한 이미지를 다른 스토리지 도메인으로 복제합니다.

## 이미지 목록

### 주요 작업

* `업로드`: 새로운 프로젝트 이미지를 업로드합니다.
* `복제`: 선택한 1개 이미지를 다른 스토리지 도메인으로 복제합니다.
* `삭제`: 선택한 1개 이미지를 삭제합니다.

> 💡 **참고:** 목록은 단일 선택 방식으로 동작합니다.

### 검색

* **검색 조건**: `이름`
* **검색어 입력**: 검색어를 입력합니다.
* **검색 버튼**: 조건에 맞는 이미지를 조회합니다.

### 테이블 컬럼

| 컬럼           | 설명                                                                                                   |
| ------------ | ---------------------------------------------------------------------------------------------------- |
| **이름**       | <p>이미지 이름입니다.<br>생성 시 사용한 이미지 파일 이름과 동일합니다.</p>                                                      |
| **ID**       | 이미지 고유 ID입니다.                                                                                        |
| **분류**       | <p>이미지 분류입니다.<br><code>프로젝트 이미지</code>, <code>공용 이미지</code>로 구분됩니다.</p>                              |
| **OS 타입**    | 이미지의 OS 타입(Variant)입니다.                                                                              |
| **크기**       | <p>이미지 파일 크기입니다.<br>업로드·변환이 진행 중인 이미지는 크기 대신 <code>생성 중</code>으로 표시되며, 변환이 완료되면 실제 크기로 자동 전환됩니다.</p> |
| **스토리지 도메인** | 이미지가 저장된 스토리지 도메인입니다.                                                                                |
| **생성 일시**    | 이미지를 추가한 일시입니다.                                                                                      |

### 이미지 분류

이미지 분류는 프로젝트 이미지와 공용 이미지로 구성되어 있습니다.\
프로젝트 이미지는 사용자가 추가하여 특정 프로젝트 내에서만 사용할 수 있는 이미지이고,\
공용 이미지는 관리자가 추가하여 모든 프로젝트에서 공통적으로 사용할 수 있는 이미지입니다.
--------------------------------------------------

## 이미지 업로드

### 기본 정보

* **스토리지 도메인**: 이미지가 저장될 스토리지 도메인을 선택합니다.
* **이미지 파일**: `.qcow2`, `.img` 확장자의 운영체제(OS) 이미지 파일을 업로드합니다.
* **부팅 펌웨어**: 이미지에 선언할 부팅 펌웨어를 `지정 안 함`, `BIOS`, `UEFI` 중에서 선택합니다.

### 입력 필드 유효성

| 필드           | 허용 값                      | 검증 규칙                       | 비고                                                                                                 |
| ------------ | ------------------------- | --------------------------- | -------------------------------------------------------------------------------------------------- |
| **스토리지 도메인** | 현재 프로젝트에서 선택 가능한 스토리지 도메인 | 필수입니다. 1개를 선택합니다.           | 저장 위치입니다.                                                                                          |
| **이미지 파일**   | `.qcow2`, `.img` 파일       | 필수입니다. 파일을 선택해야 합니다.        | 업로드 대상입니다.                                                                                         |
| **부팅 펌웨어**   | `지정 안 함`, `BIOS`, `UEFI`  | 선택 항목입니다. 기본값은 `지정 안 함`입니다. | 지정 안 함으로 두면 이미지에 펌웨어를 선언하지 않습니다. `BIOS` 또는 `UEFI`를 선택하면 해당 값이 이 이미지로 인스턴스를 생성할 때 기본 부팅 펌웨어로 사용됩니다. |

### 업로드 시 참고 사항

* 스토리지 도메인과 이미지 파일을 모두 선택하면 `업로드` 버튼이 활성화됩니다.
* 이미지 업로드는 비동기로 처리됩니다. 업로드를 시작하면 목록에 이미지가 `생성 중`으로 표시되고, 파일 복사·변환이 끝나면 실제 크기로 전환됩니다. 프로젝트 이미지와 공용 이미지 모두 동일하게 동작합니다.
* `생성 중`인 이미지는 인스턴스 생성의 부팅 소스로 선택할 수 없으며, 복제·삭제도 변환이 완료된 뒤에 할 수 있습니다.
* 변환에 실패하면 `생성 중`이던 이미지는 목록에서 자동으로 제거됩니다.

### 이미지 활용

* **가상머신 > 인스턴스 생성**에서 인스턴스 생성을 위한 OS 이미지로 활용합니다.
* **가상머신 > 시작 템플릿**에서 인스턴스 템플릿 생성을 위한 OS 이미지로 활용합니다.

***

## 이미지 복제

1. 목록에서 복제할 이미지를 선택합니다.
2. `복제`를 클릭합니다.
3. 대상 스토리지 도메인을 선택합니다.
4. 복제를 실행합니다.

> ⚠️ **주의:** 원본 이미지와 동일한 스토리지 도메인은 복제 대상으로 선택할 수 없습니다.

***

## 이미지 삭제

1. 목록에서 삭제할 이미지를 선택합니다.
2. `삭제`를 클릭합니다.
3. 삭제 확인 창에서 내용을 확인한 뒤 삭제를 진행합니다.

> ⚠️ **주의:** 프로젝트 영역에서는 `프로젝트 이미지`만 삭제할 수 있습니다. `공용 이미지`는 관리자 영역의 **공용 이미지 관리**에서 삭제할 수 있습니다.