Galera Cluster로 구축하는 OpenStack 환경의 고가용성 MySQL 데이터베이스 완벽 가이드

서론: 왜 Galera Cluster를 사용하는가?

시스템 요구사항

MySQL 설치

# 패키지 업데이트
sudo apt update

# MySQL 서버 설치 (MariaDB도 가능)
sudo apt install mysql-server -y

# Galera 플러그인 수동 설치 (필요시)
sudo apt install galera-4 -y

1번 노드 설정 (Bootstrap 노드)

설정 파일 편집

sudo vi /etc/mysql/mariadb.conf.d/60-galera.cnf

#
# * Galera-related settings
#
[galera]
# 필수 설정
wsrep_on                 = ON
wsrep_cluster_name       = "openstack-galera-cluster"
wsrep_cluster_address    = "gcomm://"                    # 첫 노드는 비워둡니다
binlog_format            = row
default_storage_engine   = InnoDB
innodb_autoinc_lock_mode = 2

# 네트워크 설정
bind-address = 0.0.0.0

# 노드 식별 설정
wsrep_sst_method         = rsync
wsrep_node_address       = "<1번 노드 IP>"
wsrep_node_name          = "<1번 노드 hostname>"
wsrep_provider           = /usr/lib/galera/libgalera_smm.so

주요 설정 옵션 설명

클러스터 초기화

sudo galera_new_cluster

2번 노드 설정

설정 파일 편집

sudo vi /etc/mysql/mariadb.conf.d/60-galera.cnf

#
# * Galera-related settings
#
[galera]
# 필수 설정
wsrep_on                 = ON
wsrep_cluster_name       = "openstack-galera-cluster"
wsrep_cluster_address    = "gcomm://<1번 노드 IP>,<2번 노드 IP>"
binlog_format            = row
default_storage_engine   = InnoDB
innodb_autoinc_lock_mode = 2

# 네트워크 설정
bind-address = 0.0.0.0

# 노드 식별 설정
wsrep_sst_method         = rsync
wsrep_node_address       = "<2번 노드 IP>"
wsrep_node_name          = "<2번 노드 hostname>"
wsrep_provider           = /usr/lib/galera/libgalera_smm.so

MySQL 재시작

sudo systemctl restart mysql

3번 노드 설정

wsrep_cluster_address    = "gcomm://<1번 노드 IP>,<2번 노드 IP>,<3번 노드 IP>"
wsrep_node_address       = "<3번 노드 IP>"
wsrep_node_name          = "<3번 노드 hostname>"

sudo systemctl restart mysql

클러스터 상태 확인

mysql -u root -p

동기화 상태 확인

SHOW GLOBAL STATUS LIKE 'wsrep_local_state_comment';

+---------------------------+--------+
| Variable_name             | Value  |
+---------------------------+--------+
| wsrep_local_state_comment | Synced |
+---------------------------+--------+

클러스터 크기 확인

SHOW GLOBAL STATUS LIKE 'wsrep_cluster_size';

+--------------------+-------+
| Variable_name      | Value |
+--------------------+-------+
| wsrep_cluster_size | 3     |
+--------------------+-------+

클러스터 상태 및 연결된 노드 확인

-- Primary 상태 확인 (마스터가 될 자격이 있는지)
SHOW GLOBAL STATUS LIKE 'wsrep_cluster_status';

-- 연결 상태 확인
SHOW GLOBAL STATUS LIKE 'wsrep_connected';

-- 연결된 노드 IP 확인
SHOW GLOBAL STATUS LIKE 'wsrep_incoming_addresses';

1번 노드 wsrep_cluster_address 재설정

sudo vi /etc/mysql/mariadb.conf.d/60-galera.cnf

# 변경 전
wsrep_cluster_address    = "gcomm://"

# 변경 후
wsrep_cluster_address    = "gcomm://<1번 노드 IP>,<2번 노드 IP>,<3번 노드 IP>"

트러블슈팅: 전체 재시작 또는 전원 손실 후

flowchart TD
  A["모든 MariaDB inactive?"] -->|아니오| Z["중단: 이미 Primary가 있을 수 있음"]
  A -->|예| B["cluster UUID 동일?"]
  B -->|아니오| Z2["중단: 다른 클러스터"]
  B -->|예| C["recovered seqno 최고 노드 = safe_to_bootstrap 1?"]
  C -->|예| D["그 노드만 galera_new_cluster"]
  C -->|아니오| Z3["중단: 수동 변경 금지, 일관성 검토"]
  D --> E["나머지 노드를 Synced/Ready 확인 후 순차 합류"]

하지 말 것

• 관례상 1번 노드라는 이유만으로 galera_new_cluster

• wsrep_cluster_address를 비우고 아무 노드나 bootstrap

• seqno 비교 없이 grastate.dat의 safe_to_bootstrap을 1로 수정

• 세 노드에서 동시에 galera_new_cluster

• Galera보다 앞에 OpenStack 컨테이너를 일괄 재시작

해야 할 것

1. 모든 MariaDB가 중지 또는 실패 상태인지 확인한다.

2. 각 노드의 cluster UUID가 같은지 확인한다.

3. grastate.dat와 journal의 Recovered position을 비교한다. seqno: -1이어도 실패로 단정하지 말 것.

4. recovered seqno가 가장 높은 노드가 safe_to_bootstrap: 1인지 확인한다.

5. 두 조건이 일치할 때만 그 노드에서 galera_new_cluster를 실행한다.

6. 나머지 노드는 systemctl start mariadb로 하나씩 합류한다. Synced / Ready ON을 확인한 뒤에 다음 노드를 시작한다.

7. UUID가 다르거나 최고 seqno 노드와 safe 노드가 다르면 중단한다.

# 각 노드에서 수집
systemctl is-active mariadb || true
sudo sed -n '1,20p' /var/lib/mysql/grastate.dat
sudo journalctl -u mariadb -b --no-pager | grep "Recovered position" | tail -1

# 기준 노드만, MariaDB가 안 돌고 있을 때
sudo galera_new_cluster

# 나머지 노드는 일반 시작
sudo systemctl start mariadb

전원 복구 시 OpenStack·Ceph

openstack token issue
openstack compute service list
openstack volume service list

HAProxy + Keepalived로 고가용성 구성

HAProxy 설정

sudo vi /etc/haproxy/haproxy.cfg

listen galera_cluster
    bind <VIP>:3306
    mode tcp
    option tcpka
    balance source
    
    # 옵션: MySQL 헬스체크
    # option mysql-check user haproxy
    
    server galera-node1 <1번 노드 IP>:3306 check weight 1
    server galera-node2 <2번 노드 IP>:3306 backup check weight 1
    server galera-node3 <3번 노드 IP>:3306 backup check weight 1

핵심 정리

주의사항

참고 자료

• MariaDB Galera Cluster 공식 문서

• Galera Cluster for MySQL 공식 문서

• HAProxy 공식 문서

• Recovering from a Non-Primary Cluster

• MariaDB — Recovering a Galera Cluster

• Ceph 클러스터 안전한 종료 및 재부팅 가이드: 전원 꺼짐과 문제 해결 방법