diff --git a/docs/assets/images/checklist/checklist-ha-detail-1.png b/docs/assets/images/checklist/checklist-ha-detail-1.png new file mode 100644 index 00000000..083d2585 Binary files /dev/null and b/docs/assets/images/checklist/checklist-ha-detail-1.png differ diff --git a/docs/assets/images/checklist/checklist-ha-detail-2.png b/docs/assets/images/checklist/checklist-ha-detail-2.png new file mode 100644 index 00000000..a8c38420 Binary files /dev/null and b/docs/assets/images/checklist/checklist-ha-detail-2.png differ diff --git a/docs/assets/images/checklist/checklist-ha-detail-3.png b/docs/assets/images/checklist/checklist-ha-detail-3.png new file mode 100644 index 00000000..24c43938 Binary files /dev/null and b/docs/assets/images/checklist/checklist-ha-detail-3.png differ diff --git a/docs/assets/images/checklist/checklist-ha-detail-4.png b/docs/assets/images/checklist/checklist-ha-detail-4.png new file mode 100644 index 00000000..85148246 Binary files /dev/null and b/docs/assets/images/checklist/checklist-ha-detail-4.png differ diff --git a/docs/getting-started/checklist.md b/docs/getting-started/checklist.md index 8fb91ac7..52247091 100644 --- a/docs/getting-started/checklist.md +++ b/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,6 +355,8 @@ ABLESTACK 설치 완료 후 서비스 운영 전 아래 항목을 최종 확인 - 네트워크 구성이 정상적으로 표시되는지 확인합니다. - 템플릿과 ISO가 정상적으로 등록되어 사용 가능한 상태인지 확인합니다. +--- + ### 3. Wall 구성 확인 - Grafana 대시보드에 정상적으로 접속되는지 확인합니다. @@ -291,6 +364,8 @@ ABLESTACK 설치 완료 후 서비스 운영 전 아래 항목을 최종 확인 - Exporter 수집 상태가 정상인지 확인합니다. - 주요 알림 룰이 정상적으로 동작하는지 확인합니다. +--- + ### 4. 최종 정상 기준 - 가상머신 생성이 정상적으로 수행됩니다. @@ -298,3 +373,5 @@ ABLESTACK 설치 완료 후 서비스 운영 전 아래 항목을 최종 확인 - 가상머신 네트워크 통신이 정상적으로 수행됩니다. - 스토리지 읽기 및 쓰기 작업이 정상적으로 수행됩니다. - 모니터링 데이터가 정상적으로 수집됩니다. + +--- diff --git a/mkdocs.yml b/mkdocs.yml index 5534d427..0530aea9 100644 --- a/mkdocs.yml +++ b/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