3.4 클러스터 (Cluster)

클러스터(Cluster)는 여러 대의 서버를 하나로 묶어 단일 시스템처럼 통합 관리하고 가용성을 극대화하는 환경입니다.

클러스터 현황

사용 전 확인사항

구분	내용
필요 권한	클러스터 생성은 Proxmox 클러스터 구성을 변경하는 관리자 기능입니다. 관리자 권한 계정으로 수행합니다.
사전 조건	각 노드의 네트워크 연결, 시간 동기화, 호스트명/IP 설정, Proxmox 계정 권한을 확인합니다.
비밀정보 처리	Proxmox Password는 화면 입력용 비밀값이며 제출문서에는 원문을 기재하지 않습니다.
영향 범위	클러스터 구성은 대시보드, HA, 마이그레이션, 공유 스토리지 기능에 영향을 줍니다.

클러스터 구성이 안되어 있을 때

클러스터 구성이 안되어 있을 때2

클러스터 구성이 안되어 있을 때3

클러스터 생성

항목	입력/선택 기준
클러스터 이름	영문, 숫자, 하이픈 등 허용된 문자로 입력합니다. 한글 입력은 제한됩니다.
Proxmox Password	클러스터 생성 권한이 있는 Proxmox 계정의 비밀번호를 입력합니다.
클러스터 네트워크	노드 간 통신이 가능한 네트워크를 선택합니다. 복수 링크를 사용할 경우 모든 참여 노드에 동일한 수의 네트워크를 준비합니다.

클러스터 생성 완료

클러스터 조인

신규 노드 직접 추가 기능을 통해 아직 클러스터에 속하지 않은 노드를 VirtOn에서 등록합니다.
신규 노드 접속 & 지문 확인 영역에서 신규 노드 IP와 포트를 입력한 뒤 지문 가져오기 버튼을 클릭합니다.
신규 노드의 TLS 지문을 확인하여 연결 대상 노드가 올바른지 검증합니다.
신규 노드 API 토큰 등록 영역에 신규 노드에서 생성한 Token ID와 Token Secret을 입력합니다.
API 토큰은 조인 수행 권한이 필요하며, 클러스터 조인 성공 후 자동으로 폐기됩니다.
현재 클러스터와 같은 Token ID는 사용할 수 없습니다. 토큰 충돌이 발생하면 VirtOn API 연결이 끊길 수 있으므로 신규 노드 전용 토큰을 사용합니다.
입력값 확인 후 신규 노드 등록 버튼을 클릭하여 클러스터 가입을 진행합니다.
작업 완료 후 우측 상단의 상태 새로고침 버튼으로 클러스터 상태와 노드 목록을 다시 확인합니다.

증상	확인 항목	조치 방법
클러스터 생성 실패	클러스터 이름, Proxmox Password, 노드 네트워크	입력값을 확인하고 노드 간 통신 가능 여부를 점검합니다.
클러스터 조인 실패	신규 노드 IP/포트, TLS 지문, API 토큰 권한	신규 노드 접속 정보와 토큰 권한을 확인한 뒤 다시 등록합니다.
클러스터 구성 후 조회 실패	새로고침, 쿼럼 상태, Proxmox API 연결	새로고침 후에도 실패하면 대시보드와 알림 페이지에서 클러스터 로그를 확인합니다.