1. 개요
- Proxmox를 사용하여 고가용성(HA) 환경을 구축하거나 여러 노드를 관리할 때 클러스터를 구성하면 더욱 효과적입니다.
- Proxmox 8.2 기준으로 클러스터 생성, 가입, 삭제 및 관리 방법을 다룹니다.
2. 버전
- Proxmox 8.2
3. Proxmox 클러스터란?
- Proxmox 클러스터는 여러 개의 Proxmox 노드를 하나의 관리 그룹으로 묶어 관리하는 방식입니다.
- 여러 노드를 하나의 인터페이스에서 관리 가능
- 가상 머신(VM)과 컨테이너(CT)의 라이브 마이그레이션 지원
- HA(High Availability) 설정 가능
4. GUI
4-1. 클러스터 생성

- Datacenter 탭에서 Cluster를 클릭합니다.
- Create Cluster 버튼을 선택합니다.

- 클러스터 이름을 입력하고 Create 버튼을 클릭합니다.

- 생성 완료 후 TASK OK 메시지를 확인합니다.

- 생성된 클러스터를 확인합니다.
4-2. 클러스터 가입

- 생성한 클러스터에서 Join Information 버튼을 클릭합니다.
- Copy Information 버튼을 눌러 클러스터 정보를 복사합니다.

- Datacenter > Cluster 메뉴로 이동합니다.
- Join Cluster 버튼을 클릭합니다.

- 클러스터 정보를 입력하고, Password를 입력한 후 Join Cluster를 클릭합니다.

- 노드가 정상적으로 추가되었는지 확인합니다.
5. CLI
5-1. 클러스터 생성
5-1-1. 클러스터 생성
PROX01 # pvecm create cluster01
출력 예시:
Corosync Cluster Engine Authentication key generator.
Gathering 2048 bits for key from /dev/urandom.
Writing corosync key to /etc/corosync/authkey.
Writing corosync config to /etc/pve/corosync.conf
Restart corosync and cluster filesystem
5-1-2. 클러스터 상태 확인
PROX01 # pvecm status
출력 예시:
Cluster information
-------------------
Name: cluster01
Config Version: 1
Transport: knet
Secure auth: on
Quorum information
------------------
Date: Fri Sep 6 15:47:03 2024
Quorum provider: corosync_votequorum
Nodes: 1
Node ID: 0x00000001
Ring ID: 1.40
Quorate: Yes
Votequorum information
----------------------
Expected votes: 1
Highest expected: 1
Total votes: 1
Quorum: 1
Flags: Quorate
Membership information
----------------------
Nodeid Votes Name
0x00000001 1 192.168.204.240 (local)
5-2. 클러스터 가입
5-2-1. 클러스터 가입
PROX02 # pvecm add 192.168.204.240
출력 예시:
Please enter superuser (root) password for '192.168.204.240': *******
Establishing API connection with host '192.168.204.240'
The authenticity of host '192.168.204.240' can't be established.
X509 SHA256 key fingerprint is 63:4A:20:E8:FB:6A:3E:72:50:61:1B:F0:01:F7:9C:61:29:0E:9C:52:48:C7:52:87:AC:71:CA:83:62:A0:3F:87.
Are you sure you want to continue connecting (yes/no)? yes
Login succeeded.
check cluster join API version
No cluster network links passed explicitly, fallback to local node IP '192.168.204.242'
Request addition of this node
Join request OK, finishing setup locally
stopping pve-cluster service
backup old database to '/var/lib/pve-cluster/backup/config-1725638089.sql.gz'
waiting for quorum...OK
(re)generate node files
generate new node certificate
merge authorized SSH keys
generated new node certificate, restart pveproxy and pvedaemon services
successfully added node 'DELL' to cluster.
5-2-2. 클러스터 확인
PROX02 # pvecm status
출력 예시:
Cluster information
-------------------
Name: cluster01
Config Version: 2
Transport: knet
Secure auth: on
Quorum information
------------------
Date: Sat Sep 7 00:57:02 2024
Quorum provider: corosync_votequorum
Nodes: 2
Node ID: 0x00000002
Ring ID: 1.44
Quorate: Yes
Votequorum information
----------------------
Expected votes: 2
Highest expected: 2
Total votes: 2
Quorum: 2
Flags: Quorate
Membership information
----------------------
Nodeid Votes Name
0x00000001 1 192.168.204.240
0x00000002 1 192.168.204.242 (local)
6. 클러스터 노드 삭제
6-1. 클러스터 멤버 확인
# pvecm nodes
출력 예시:
Membership information
----------------------
Nodeid Votes Name
1 1 SUPERMICRO (local)
2 1 DELL
3 1 LENOVO
6-2. 삭제할 노드 제거
# pvecm delnode LENOVO
출력 예시:
Killing node 3
6-3. 클러스터 설정에서 해당 노드 삭제
# rm -rf /etc/pve/nodes/LENOVO
7. 클러스터 재가입 및 초기화
7-1. 특정 노드 강제 제거
# systemctl stop pve-cluster corosync
# pmxcfs -l
# rm /etc/corosync/*
# rm /etc/pve/corosync.conf
# killall pmxcfs
# rm -rf /etc/pve/nodes/SUPERMICRO
# rm -rf /etc/pve/nodes/DELL
# systemctl start pve-cluster
7-2. 전체 클러스터 초기화
# systemctl stop pve-cluster corosync
# pmxcfs -l
# rm /etc/corosync/*
# rm /etc/pve/corosync.conf
# killall pmxcfs
# systemctl start pve-cluster