구성 확인 쪽에서 HA 활성화 확인 추가

docs/getting-started/checklist.md

@@ -1,12 +1,15 @@
 
 # ABLESTACK 구성확인 가이드
 
+---
+
 ## 개요
 
 본 문서는 ABLESTACK 설치 완료 후 주요 구성요소가 정상적으로 구성되었는지 확인하기 위한 가이드입니다. Mold에서는 Zone, 클러스터, 호스트, 시스템 VM, 스토리지 및 네트워크 상태를 확인하고, Cube에서는 주요 서비스, 스토리지 연결 상태, 네트워크 구성, 가상머신 실행 상태를 점검합니다.
 
 이를 통해 서비스 운영 전 구성 누락, 서비스 비정상, 스토리지 연결 오류, 네트워크 구성 오류, 가상머신 실행 문제를 사전에 확인할 수 있습니다.
 
+---
 
 ## 클라우드 대시보드(Mold)
 
@@ -17,6 +20,8 @@
 
 ![Mold대시보드 화면](../assets/images/checklist/checklist-mold-dashboard.png){ .imgCenter .imgBorder }
 
+---
+
 ### Zone 확인
 
 Zone은 ABLESTACK 클라우드 환경의 최상위 인프라 관리 단위로, 클러스터, 호스트, 스토리지, 네트워크 등의 주요 자원을 포함합니다.
@@ -27,6 +32,8 @@ Mold 대시보드에서 설치 과정에서 생성한 Zone이 정상적으로 
 ![Zone 화면1](../assets/images/checklist/checklist-zone-1.png){ .imgCenter .imgBorder }
 ![Zone 화면2](../assets/images/checklist/checklist-zone-2.png){ .imgCenter .imgBorder }
 
+---
+
 ### 클러스터 확인
 
 클러스터는 Zone 내에서 여러 호스트를 하나의 컴퓨트 자원 그룹으로 묶어 관리하는 단위입니다. 클러스터에는 가상머신이 실행되는 호스트들이 포함되며, 동일한 클러스터 내의 호스트는 가상머신 배치, 마이그레이션, 리소스 관리 등에 사용됩니다.
@@ -39,6 +46,8 @@ Mold 대시보드에서 설치 과정에서 구성한 클러스터가 정상적
 ![클러스터 화면1](../assets/images/checklist/checklist-cluster-1.png){ .imgCenter .imgBorder }
 ![클러스터 화면2](../assets/images/checklist/checklist-cluster-2.png){ .imgCenter .imgBorder }
 
+---
+
 ### 호스트 확인
 
 호스트는 가상머신이 실제로 실행되는 물리 서버로, Cluster 내에서 CPU, Memory, 네트워크, 스토리지 자원을 제공합니다.
@@ -49,6 +58,8 @@ Mold 대시보드에서 설치 과정에서 추가한 호스트가 정상적으
 ![호스트 화면1](../assets/images/checklist/checklist-host-1.png){ .imgCenter .imgBorder }
 ![호스트 화면2](../assets/images/checklist/checklist-host-2.png){ .imgCenter .imgBorder }
 
+---
+
 ### 시스템 VM 확인
 
 시스템 VM은 ABLESTACK 클라우드 서비스 운영에 필요한 내부 기능을 제공하는 시스템 가상머신입니다. Console Proxy VM, Secondary Storage VM, Virtual Router 등이 포함되며, 가상머신 콘솔 접속, 템플릿 및 ISO 관리, 네트워크 서비스 제공 등에 사용됩니다.
@@ -60,6 +71,8 @@ Mold 대시보드에서 시스템 VM이 정상적으로 생성되고 실행 중
 
 ![시스템 VM 화면](../assets/images/checklist/checklist-systemvm.png){ .imgCenter .imgBorder }
 
+---
+
 #### 기본 스토리지 확인
 
 기본 스토리지는 가상머신의 루트 디스크와 데이터 디스크가 저장되는 기본 스토리지입니다.
@@ -69,6 +82,8 @@ Mold 대시보드에서 기본 스토리지가 정상적으로 등록되어 있
 
 따라서 구성확인 단계에서는 기본 스토리지의 상태뿐만 아니라, 연결된 클러스터와 호스트에서 정상적으로 접근 가능한지 함께 점검합니다.
 
+---
+
 확인 항목은 다음과 같습니다.
 
 - 기본 스토리지가 목록에 정상적으로 표시되는지 확인합니다.
@@ -79,11 +94,15 @@ Mold 대시보드에서 기본 스토리지가 정상적으로 등록되어 있
 - 가상머신 디스크가 생성될 수 있는 상태인지 확인합니다.
 - 스토리지 관련 경고나 오류 이벤트가 발생하지 않았는지 확인합니다.
 
+---
+
 아래 화면과 같이 기본 스토리지 목록에서 구성된 기본 스토리지의 상태를 확인합니다.
 
 ![기본 스토리지 화면1](../assets/images/checklist/checklist-primary-detail-1.png){ .imgCenter .imgBorder }
 ![기본 스토리지 화면2](../assets/images/checklist/checklist-primary-detail-2.png){ .imgCenter .imgBorder }
 
+---
+
 #### 2차 스토리지 확인
 
 2차 스토리지는 템플릿, ISO, 스냅샷, 볼륨 백업 등 보조 데이터를 저장하는 스토리지입니다.
@@ -93,6 +112,8 @@ Mold 대시보드에서 2차 스토리지가 정상적으로 등록되어 있고
 
 따라서 구성확인 단계에서는 2차 스토리지의 상태와 용량뿐만 아니라, Secondary Storage VM과의 연결 상태 및 브라우저를 통한 접근 가능 여부를 함께 점검합니다.
 
+---
+
 확인 항목은 다음과 같습니다.
 
 - 2차 스토리지가 목록에 정상적으로 표시되는지 확인합니다.
@@ -104,11 +125,49 @@ Mold 대시보드에서 2차 스토리지가 정상적으로 등록되어 있고
 - 2차 스토리지 관련 경고나 오류 이벤트가 발생하지 않았는지 확인합니다.
 - 브라우저에서 2차 스토리지 접근 URL 또는 관련 상태 페이지에 접속 가능한지 확인합니다.
 
+---
+
 아래 화면과 같이 2차 스토리지 목록에서 구성된 2차 스토리지의 상태를 확인합니다.
 
 ![2차 스토리지 화면1](../assets/images/checklist/checklist-secondary-detail-1.png){ .imgCenter .imgBorder }
 ![2차 스토리지 화면2](../assets/images/checklist/checklist-secondary-detail-2.png){ .imgCenter .imgBorder }
 
+---
+
+### HA(고가용성) 확인
+
+HA(High Availability, 고가용성)는 장애가 발생했을 때 서비스 중단을 최소화하기 위한 기능입니다.
+물리 서버(Cube)에 장애가 발생하면 해당 서버에서 실행 중이던 가상머신을 다른 정상 서버에서 자동으로 다시 실행합니다. 이를 통해 사용자는 서버 장애 상황에서도 서비스를 보다 안정적으로 운영할 수 있습니다.
+다만 HA는 완전한 무중단 기능은 아니며, 가상머신이 다른 서버에서 재시작되는 동안 짧은 서비스 중단이 발생할 수 있습니다.
+
+HA 기능이 정상적으로 동작하려면 공유 스토리지, 네트워크, 클러스터 구성이 올바르게 준비되어 있어야 합니다.
+
+확인 항목은 다음과 같습니다.
+
+1. 공유 스토리지(Glue)의 Heartbeat 체크 설정 값이 **"true"** 인지 확인합니다.
+2. 클러스터에서 HA 기능이 활성화되어 있는지 확인합니다.
+3. 호스트(Cube)의 HA 활성화 여부와 HA 상태가 정상인지 확인합니다.
+4. Cube 터미널에서 Heartbeat 값이 주기적으로 확인되는지 점검합니다.
+
+---
+
+!!! warning "주의사항"
+    1. HA 기능이 필요하지 않은 환경에서는 불필요하게 활성화하지 않는 것이 좋습니다.
+    2. 여러 클러스터를 사용하는 경우, HA 대상 클러스터와 연결된 공유 스토리지의 Heartbeat 체크 설정 값을 **"true"** 로 등록해야 합니다.
+    3. 모든 공유 스토리지에 Heartbeat 체크를 활성화하면 확인 부하와 응답 지연으로 인해 의도하지 않은 HA 동작이 발생할 수 있으므로 필요한 공유 스토리지에만 설정하는 것이 좋습니다.
+    4. 설정 후에는 해당 Cube의 터미널에서 Heartbeat 값이 정상적으로 주기 확인되는지 점검해야 합니다.
+
+---
+
+아래 화면과 같이 공유 스토리지, 클러스터, 호스트의 HA 관련 설정과 상태를 확인합니다.
+
+![HA 확인 화면1](../assets/images/checklist/checklist-ha-detail-1.png){ .imgCenter .imgBorder }
+![HA 확인 화면2](../assets/images/checklist/checklist-ha-detail-2.png){ .imgCenter .imgBorder }
+![HA 확인 화면3](../assets/images/checklist/checklist-ha-detail-3.png){ .imgCenter .imgBorder }
+![HA 확인 화면4](../assets/images/checklist/checklist-ha-detail-4.png){ .imgCenter .imgBorder }
+
+---
+
 ## 인프라 대시보드(Cube)
 
 인프라 대시보드(Cube)에서는 ABLESTACK을 구성하는 물리 호스트와 가상 어플라이언스의 상태를 확인할 수 있습니다.
@@ -120,6 +179,8 @@ ABLESTACK-STANDALONE 구성에서는 로컬 디스크 상태, 클라우드센터
 
 이를 통해 설치 구성 방식에 따라 스토리지, 클러스터, 가상 어플라이언스, 디스크 상태가 정상적으로 구성되었는지 확인할 수 있습니다.
 
+---
+
 ### ABLESTACK-HCI
 ABLESTACK-HCI는 클라우드 관리 기능과 분산 스토리지 기능을 함께 제공하는 HCI 구성 방식입니다.
 Cube 대시보드에서는 Glue 기반 스토리지센터 클러스터와 Mold 기반 클라우드센터 클러스터의 상태를 함께 확인할 수 있습니다.
@@ -172,6 +233,8 @@ Mold 서비스, Mold DB, CPU, Memory, ROOT Disk, 세컨더리 Disk, 관리 NIC 
 
 인프라 대시보드의 클라우드센터 가상머신 상태 영역에서 가상머신 실행 상태, Mold 서비스 상태, Mold DB 상태, 자원 및 네트워크 정보를 확인합니다.
 
+---
+
 ### ABLESTACK-VM
 
 ABLESTACK-VM은 외부 또는 공유 스토리지 기반으로 클라우드센터를 구성하는 방식입니다.
@@ -229,6 +292,8 @@ Mold 서비스, Mold DB, CPU, Memory, ROOT Disk, 세컨더리 Disk, 관리 NIC 
 
 인프라 대시보드의 클라우드센터 가상머신 상태 영역에서 가상머신 실행 상태, Mold 서비스 상태, Mold DB 상태, 자원 및 네트워크 정보를 확인합니다.
 
+---
+
 ### ABLESTACK-STANDALONE
 
 ABLESTACK-STANDALONE은 단일 노드 기반으로 클라우드센터를 구성하는 방식입니다.
@@ -260,11 +325,15 @@ Mold 서비스, Mold DB, CPU, Memory, ROOT Disk, 세컨더리 Disk, 관리 NIC 
 
 인프라 대시보드의 클라우드센터 가상머신 상태 영역에서 가상머신 실행 상태, Mold 서비스 상태, Mold DB 상태, 자원 및 네트워크 정보를 확인합니다.
 
+---
+
 ## 구성확인 체크리스트
 
 ABLESTACK 설치 완료 후 서비스 운영 전 아래 항목을 최종 확인합니다.
 각 항목이 정상 상태로 확인되면 기본적인 클라우드 관리, 가상머신 실행, 스토리지 사용, 모니터링 구성이 정상적으로 완료된 것으로 판단할 수 있습니다.
 
+---
+
 ### 1. Cube 구성 확인
 
 - 주요 서비스가 정상적으로 실행 중인지 확인합니다.
@@ -274,6 +343,8 @@ ABLESTACK 설치 완료 후 서비스 운영 전 아래 항목을 최종 확인
 - 가상머신이 정상적으로 실행 중인지 확인합니다.
 - 시스템 로그에서 주요 오류가 발생하지 않았는지 확인합니다.
 
+---
+
 ### 2. Mold 구성 확인
 
 - Zone이 정상적으로 표시되고 사용 가능한 상태인지 확인합니다.
@@ -284,17 +355,23 @@ ABLESTACK 설치 완료 후 서비스 운영 전 아래 항목을 최종 확인
 - 네트워크 구성이 정상적으로 표시되는지 확인합니다.
 - 템플릿과 ISO가 정상적으로 등록되어 사용 가능한 상태인지 확인합니다.
 
+---
+
 ### 3. Wall 구성 확인
 
 - Grafana 대시보드에 정상적으로 접속되는지 확인합니다.
 - Prometheus Target이 정상 상태인지 확인합니다.
 - Exporter 수집 상태가 정상인지 확인합니다.
 - 주요 알림 룰이 정상적으로 동작하는지 확인합니다.
 
+---
+
 ### 4. 최종 정상 기준
 
 - 가상머신 생성이 정상적으로 수행됩니다.
 - 가상머신 콘솔 접속이 정상적으로 수행됩니다.
 - 가상머신 네트워크 통신이 정상적으로 수행됩니다.
 - 스토리지 읽기 및 쓰기 작업이 정상적으로 수행됩니다.
 - 모니터링 데이터가 정상적으로 수집됩니다.
+
+---

mkdocs.yml

@@ -84,7 +84,7 @@ plugins:
   - exporter:
       formats:
         pdf:
-          enabled: !ENV [MKDOCS_EXPORTER_PDF, true]
+          enabled: !ENV [MKDOCS_EXPORTER_PDF, false]
           concurrency: 16
           stylesheets:
             - resources/stylesheets/pdf.scss