> 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/administrator/host-machine/compute-node.md).

# 컴퓨트 노드

**컴퓨트 노드** 메뉴에서는 Cloud:iA에 등록된 컴퓨트 노드의 상태와 리소스 정보를 확인하고, 오버커밋 비율을 관리할 수 있습니다. 컴퓨트 노드 상세 화면에서는 리소스, 시스템 정보, 인스턴스, 스토리지 도메인 정보를 탭으로 구분하여 제공합니다.

***

## 컴퓨트 노드 목록

컴퓨트 노드 목록 화면에서는 등록된 컴퓨트 노드의 상태와 기본 운영 정보를 확인할 수 있습니다.

### 주요 작업

* **`편집`**: 노드를 한 개 선택했을 때 활성화됩니다. 클릭 시 **컴퓨트 노드 편집** 화면으로 이동합니다.
* **이름 클릭**: 선택한 컴퓨트 노드의 **상세 화면**으로 이동합니다.

> 💡 **참고:** 컴퓨트 노드 메뉴에서는 생성/삭제 기능을 제공하지 않으며, 편집 기능만 제공합니다.

### 테이블 컬럼

| 컬럼              | 설명                                |
| --------------- | --------------------------------- |
| **이름**          | 컴퓨트 노드 이름입니다. 클릭 시 상세 화면으로 이동합니다. |
| **상태**          | 현재 컴퓨트 노드 상태입니다.                  |
| **인스턴스 수**      | 해당 노드에 배치된 인스턴스의 수입니다.            |
| **CPU 오버커밋 비율** | CPU 오버커밋 비율입니다.                   |
| **메모리 오버커밋 비율** | 메모리 오버커밋 비율입니다.                   |
| **생성 일시**       | 컴퓨트 노드가 등록된 일시입니다.                |

### 상태 이해하기

목록과 상세 화면에 표시되는 컴퓨트 노드 상태는 다음과 같습니다.

| 상태              | 의미                                               |
| --------------- | ------------------------------------------------ |
| **`실행 중`**      | 노드가 정상 동작 중이며 인스턴스를 배치할 수 있습니다.                  |
| **`생성 중`**      | 노드가 등록·준비 중입니다.                                  |
| **`삭제 중`**      | 노드 삭제가 진행 중입니다.                                  |
| **`페일오버 진행 중`** | 노드 장애가 감지되어 해당 노드의 인스턴스를 다른 노드로 옮기는 작업이 진행 중입니다. |
| **`정지됨`**       | 노드가 중지되었거나 연결이 끊긴 상태입니다.                         |
| **`에러`**        | 내부 복구 실패 등 오류가 발생한 상태입니다.                        |

***

## 컴퓨트 노드 편집

컴퓨트 노드 편집 화면에서는 노드 이름은 조회만 가능하며, CPU/메모리 오버커밋 비율만 수정할 수 있습니다.

### 입력 항목

| 항목              | 설명               |
| --------------- | ---------------- |
| **이름**          | 읽기 전용 항목입니다.     |
| **CPU 오버커밋 비율** | 슬라이더로 비율을 조정합니다. |
| **메모리 오버커밋 비율** | 슬라이더로 비율을 조정합니다. |

### 오버커밋 비율 규칙

* 설정 범위: **1.00 \~ 2.00**
* 권장 기준: **1.5 이하**
* 기존 값과 동일하면 **저장 버튼이 비활성화**됩니다.

### 저장/취소

* **`저장`**: 변경한 오버커밋 비율을 반영하고 목록 화면으로 이동합니다.
* **`취소`**: 변경 사항을 저장하지 않고 목록 화면으로 이동합니다.

***

## 컴퓨트 노드 상세

컴퓨트 노드 상세 화면은 상단 **기본 정보**와 하단 **탭 정보**로 구성됩니다.

### 기본 정보

| 항목              | 설명                       |
| --------------- | ------------------------ |
| **이름**          | 컴퓨트 노드 이름입니다.            |
| **상태**          | 컴퓨트 노드 운영 상태입니다.         |
| **VDSM 연결 상태**  | VDSM 연결 상태를 표시합니다.       |
| **Agent 연결 상태** | Host Agent 연결 상태를 표시합니다. |
| **네트워크 상태**     | 네트워크 점검 결과를 표시합니다.       |
| **인스턴스 수**      | 노드에 배치된 인스턴스의 수입니다.      |
| **CPU 오버커밋 비율** | CPU 오버커밋 비율입니다.          |
| **메모리 오버커밋 비율** | 메모리 오버커밋 비율입니다.          |
| **생성 일시**       | 컴퓨트 노드 생성 일시입니다.         |

#### 연결 상태 값

`VDSM 연결 상태`, `Agent 연결 상태`, `네트워크 상태`는 다음 값으로 표시됩니다.

| 구분              | 값        | 의미                             |
| --------------- | -------- | ------------------------------ |
| **VDSM 연결 상태**  | `연결`     | VDSM과 정상적으로 연결되어 있습니다.         |
|                 | `해제`     | VDSM 연결이 끊겼습니다.                |
|                 | `도달 불가`  | VDSM에 도달할 수 없습니다.              |
|                 | `알 수 없음` | 연결 상태를 확인할 수 없습니다.             |
| **Agent 연결 상태** | `연결`     | Host Agent와 정상적으로 연결되어 있습니다.   |
|                 | `해제`     | Host Agent 연결이 끊겼습니다.          |
| **네트워크 상태**     | `정상`     | 내부망과 외부망 점검이 모두 정상입니다.         |
|                 | `내부만 정상` | 내부망 점검은 정상이고 외부망 점검은 정상이 아닙니다. |
|                 | `외부만 정상` | 외부망 점검은 정상이고 내부망 점검은 정상이 아닙니다. |
|                 | `에러`     | 네트워크 점검이 정상이 아닙니다.             |
|                 | `알 수 없음` | 네트워크 상태를 확인할 수 없습니다.           |

### 탭 구성

#### 리소스

| 항목               | 설명                   |
| ---------------- | -------------------- |
| **전체 논리 CPU 수**  | 노드의 전체 논리 CPU 수입니다.  |
| **할당된 논리 CPU 수** | 현재 할당된 논리 CPU 수입니다.  |
| **전체 메모리**       | 전체 메모리 용량입니다.        |
| **할당된 메모리**      | 현재 할당된 메모리 용량입니다.    |
| **수정 일시**        | 리소스 정보 마지막 갱신 시각입니다. |

#### 시스템 정보

| 항목              | 설명                      |
| --------------- | ----------------------- |
| **커널 버전**       | 운영체제 커널 버전입니다.          |
| **QEMU-KVM 버전** | 하이퍼바이저(QEMU-KVM) 버전입니다. |
| **Libvirt 버전**  | Libvirt 버전입니다.          |
| **VDSM 버전**     | VDSM 버전입니다.             |
| **하이퍼스레딩**      | 하이퍼스레딩 사용 여부입니다.        |

#### 인스턴스

인스턴스 탭에서는 현재 컴퓨트 노드에 배치된 인스턴스 목록을 제공합니다.

| 컬럼        | 설명                   |
| --------- | -------------------- |
| **이름**    | 인스턴스 이름입니다.          |
| **ID**    | 인스턴스 ID입니다.          |
| **상태**    | 인스턴스 상태입니다.          |
| **보안 유형** | 인스턴스 보안 타입입니다.       |
| **vCPU**  | 인스턴스에 할당된 vCPU 수입니다. |
| **메모리**   | 인스턴스 메모리 용량입니다.      |
| **IP 주소** | 인스턴스 IP 주소입니다.       |
| **생성 일시** | 인스턴스 생성 일시입니다.       |

#### 스토리지 도메인

스토리지 도메인 탭에서는 현재 컴퓨트 노드가 접근하는 스토리지 도메인 목록을 제공합니다.

| 컬럼          | 설명                                             |
| ----------- | ---------------------------------------------- |
| **이름**      | 스토리지 도메인 이름입니다.                                |
| **ID**      | 스토리지 도메인 ID입니다.                                |
| **타입**      | 스토리지 도메인 타입입니다.                                |
| **상태**      | 스토리지 도메인 자체의 상태입니다.                            |
| **접근 가능**   | 이 컴퓨트 노드에서 해당 스토리지 도메인에 정상적으로 접근할 수 있는지 여부입니다. |
| **마운트 포인트** | 스토리지 도메인의 마운트 경로입니다. 타입에 따라 제공되지 않을 수 있습니다.    |
| **풀 이름**    | 스토리지 도메인이 속한 풀 이름입니다. 타입에 따라 제공되지 않을 수 있습니다.   |
| **생성 일시**   | 스토리지 도메인 생성 일시입니다.                             |

### 인스턴스 마이그레이션

인스턴스 탭에서 인스턴스를 한 개 선택하면 **`마이그레이션`** 버튼이 활성화됩니다.

#### 수행 절차

* 마이그레이션 모달에서 상단 **`라이브 마이그레이션` 토글**로 방식 선택이 가능합니다.
  * 토글 `OFF`: **콜드 마이그레이션**
  * 토글 `ON`: **라이브 마이그레이션**
* 대상 노드 목록에는 먼저 **현재 인스턴스를 옮길 수 있는 노드만** 표시됩니다.
* 현재 인스턴스가 배치된 노드는 대상에서 제외됩니다.
* 대상 노드를 선택하지 않으면 `실행` 버튼이 비활성화됩니다.
* 대상 노드를 선택하면 `실행` 버튼이 활성화됩니다.

#### 대상 노드 선택 기준

* 공통 조건:
  * 상태가 정상이어야 합니다.
  * 현재 인스턴스가 사용하는 스토리지에 접근할 수 있어야 합니다.
* **콜드 마이그레이션**(`라이브 마이그레이션` 토글 `OFF`):
  * 공통 조건을 만족하는 노드는 모두 선택할 수 있습니다.
* **라이브 마이그레이션**(`라이브 마이그레이션` 토글 `ON`):
  * 공통 조건에 더해 CPU 호환이 되는 노드만 선택할 수 있습니다.
  * 인스턴스가 라이브 마이그레이션을 지원하지 않으면 라이브 가능한 대상 노드가 표시되지 않을 수 있습니다.
  * SEV 계열(`SEV`, `SEV-ES`, `SEV-SNP`) 보안 유형 인스턴스와 `NPU`를 사용하는 인스턴스는 라이브 마이그레이션을 지원하지 않습니다. 이 경우 라이브 마이그레이션 가능한 대상 노드가 표시되지 않습니다.