호스트 어그리게이트
호스트를 논리적으로 그룹핑하는 단위입니다. 각 Aggregate는 최대 하나의 가용 영역(AZ)에 매핑되며, 인스턴스 스케줄링의 기반이 됩니다.
- 진입 경로: Cloud Builder › Computer Nodes › Host Aggregates
- 검색:
Search host aggregates by attributes(기본 필터 키: Name) - 체크박스 없음 · CSV 내보내기 지원
AZ ↔ Aggregate 관계
AZ는 독립 객체가 아니라 availability_zone 메타데이터를 가진 Host Aggregate로 존재합니다. 같은 AZ 메타데이터를 여러 Aggregate가 공유할 수 있어 AZ ← Aggregate는 1:N이며, AZ는 그 Aggregate들의 호스트 합집합입니다. 또한 OpenStack 제약상 호스트는 AZ 하나에만 속할 수 있습니다.
목록 화면
1 사이드바 (SNB)
좌측 사이드바에서 각 화면으로 이동.

| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 1-1 | 서버 | Servers | · 베어메탈 서버 인벤토리(등록·할당·삭제). |
| 1-2 | 호스트 어그리게이트 | Host aggregates | · 호스트 논리 그룹. |
| 1-3 | 가용 영역 | Availability zones | · 가용 영역(AZ). |
| 1-4 | 컴퓨트 서비스 | Compute services | · 서비스 엔드포인트 현황. |
| 1-5 | 컴퓨트 노드 | Compute nodes | · 노드·하이퍼바이저·리소스 프로바이더. |
| 1-6 | 네트워크 에이전트 | Network agents | · Neutron 에이전트 상태. |
| 1-7 | 블록 스토리지 서비스 | Block storage services | · Cinder 서비스·백엔드. |
| 1-8 | 오케스트레이션 서비스 | Orchestration services | · Heat 엔진 상태. |
2 검색 · 생성
호스트 어그리게이트를 검색하거나 새로 생성한다.

| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 2-1 | 검색 | Search | · 이름 등 속성으로 검색. |
| 2-2 | 생성 | Create host aggregate | · 새 호스트 그룹 생성 드로어 열기. |
3 목록 테이블
호스트 어그리게이트 목록. 이름 좌측 토글로 Metadata 확장.

| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 3-1 | 목록 컬럼 | Name | Aggregate 이름(확장 시 Metadata 표시). |
| Availability zone | 매핑된 가용 영역. 없으면 -. | ||
| Hosts | 첫 호스트 + +N 배지(hover 시 전체). | ||
| Created at | 생성일시. | ||
| Action | Edit / Manage hosts / Manage metadata / Delete. |
생성 (Create)
이름과 가용 영역을 지정해 새 호스트 어그리게이트를 만듭니다.
1 생성 진입
클릭하면 생성 드로어가 열린다.

2 생성 드로어
이름과 가용 영역을 지정해 호스트 어그리게이트를 만든다.

| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 2-1 | 이름 | Name * | · Thaki 통일 이름 규칙(2~128자, 영/숫자 시작, 한글 불가). |
| 2-2 | 가용 영역 | Availability zone * | · 매핑할 가용 영역 선택(최대 1개). |
| 2-3 | 생성 / 취소 | Create / Cancel | · Create: 생성. Cancel: 닫기. |
수정 (Edit)
행 액션의 Edit로 이름·가용 영역을 변경합니다.
1 수정 진입(행 액션)
행 메뉴에서 Edit 선택.

2 수정 드로어
이름·가용 영역을 변경한다.

| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 2-1 | 이름 | Name | · Aggregate 이름 변경. |
| 2-2 | 수정 / 취소 | Edit / Cancel | · Edit: 저장. Cancel: 닫기. |
호스트 관리 (Manage hosts)
Aggregate에 호스트를 추가·제거합니다. 호스트는 AZ 하나에만 속할 수 있다는 OpenStack 제약 때문에, 추가 가능 여부는 대상 Aggregate의 AZ 유무로 갈립니다.
1 호스트 관리 진입(행 액션)
행 메뉴에서 Manage hosts 선택.

2 호스트 관리 드로어
Aggregate에 호스트를 추가/제거한다. AZ 제약(호스트는 AZ 1개)으로 다른 AZ 호스트는 비활성.

| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 2-1 | 호스트 검색 | Search hosts | · 추가/제거할 호스트를 검색·선택. |
| 2-2 | 저장 / 취소 | Save / Cancel | · Save: 반영. Cancel: 닫기. |
| 대상 Aggregate의 AZ | 호스트의 현재 AZ | 추가 |
|---|---|---|
| 없음 | 아무거나 | ✅ (충돌 검사 없음) |
| 있음 | 미지정 | ✅ 추가 시 그 AZ로 편입 |
| 있음 | 같은 AZ | ✅ |
| 있음 | 다른 AZ | ❌ 충돌(409) → 사전 차단 |
- 다른 AZ에 속한 호스트는 체크박스가 비활성화되고 사유 툴팁("이미 {AZ}에 속함")이 표시됩니다.
- 이미 소속된 호스트는 선택된 상태로 표시되며 해제(제거)는 허용됩니다.
메타데이터 관리 (Manage metadata)
Aggregate의 key-value 메타데이터를 편집합니다.
1 메타데이터 관리 진입(행 액션)
행 메뉴에서 Manage metadata 선택.

2 메타데이터 관리 드로어
Aggregate의 key-value 메타데이터를 편집한다.

| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 2-1 | 키 | Metadata key | · 커스텀 메타데이터 키 입력. |
| 2-2 | 값 | Value | · 해당 키의 값 입력. |
| 2-3 | 저장 / 취소 | Save / Cancel | · Save: 반영. Cancel: 닫기. |
삭제 (Delete)
행 액션의 Delete로 호스트 어그리게이트를 삭제합니다.
1 삭제 진입(행 액션)
행 메뉴에서 Delete 선택. 소속 호스트가 있으면 비활성.

2 삭제 확인 모달
호스트 어그리게이트를 삭제한다.

| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 2-1 | 취소 | Cancel | · 닫기. |
| 2-2 | 삭제 | Delete | · 영구 삭제. |
삭제 제약
소속 호스트가 있으면 Delete가 비활성화됩니다. 툴팁: "삭제 전에 어그리게이트에서 모든 호스트를 제거하세요".