이 가이드에서는 에어 갭이 적용된 Google Distributed Cloud(GDC) 환경의 3개 가용성 영역에 고가용성 MariaDB 12 클러스터를 배포하는 포괄적인 단계별 튜토리얼을 제공합니다. 이 아키텍처는 동기식 멀티 마스터 클러스터링을 위해 Galera를, 지능형 연결 라우팅을 위해 HAProxy를, 노드 상태를 관리하기 위해 경량 Python 상태 점검 서비스를 활용합니다. 가상 머신(VM)을 엄격하게 활용하는 이 구현은 교차 영역 Kubernetes 확장 클러스터와 관련된 현재 GDC 에어 갭 제한을 명시적으로 우회하여 데이터 손실 위험 없이 완전한 멀티 영역 복원력을 보장합니다.
아키텍처 다이어그램은 다음과 같습니다.

시작하기 전에
VM 배포
VM 인스턴스 만들기 및 시작에 따라 사용 가능한 3개 영역에 가상 머신 3개를 만듭니다.
키 쌍을 사용하여 VM에 SSH를 수행하도록 로컬 환경을 구성합니다. VM에 연결
패키지를 수동으로 SCP하는 데 필요합니다. 파일 전송
검증을 위해 Ubuntu 22.04 OS와 n3-standard-2-gdc 머신 유형을 사용했습니다.
프로덕션 환경의 경우 리소스가 더 많은 머신 유형을 사용합니다.
다음을 사용하여 VM의 IP를 가져옵니다.
VM_NAME=$1
if [[ -z "$VM_NAME" ]]; then
echo "Error: VM_NAME must be provided."
echo "Usage: $0 <VM_NAME>"
exit 1
fi
# 1. Get External IP from 'instances list'
EXT_IP=$(gdcloud compute instances list | awk -v vm="${VM_NAME}" '$1 == vm {print $5}')
if [[ -z "$EXT_IP" ]]; then
echo "Error: Could not find VM '${VM_NAME}' in the instance list."
exit 1
fi
INTERNAL_IP=$(gdcloud compute instances describe "${VM_NAME}" | awk '/^status:/ {in_status=1} in_status && /- [0-9]+\.[0-9]+\.[0-9]+\.[0-9]+/ {print $2; exit}' | cut -d'/' -f1)
if [[ -z "$INTERNAL_IP" ]]; then
INTERNAL_IP="<Not assigned or not found>"
fi
echo "${VM_NAME}"
echo "External IP: ${EXT_IP}"
echo "Internal IP: ${INTERNAL_IP}"
환경 변수 구성
이 가이드에서는 다음 환경 변수를 사용합니다. 로컬 워크스테이션 셸 세션에서 설정합니다.
export PROJECT_ID="your-project-id"
export VM1_NAME="db-node-1"
export VM2_NAME="db-node-2"
export VM3_NAME="db-node-3"
export VM1_IP="10.0.1.245" # Zone 1
export VM2_IP="10.0.1.241" # Zone 2
export VM3_IP="10.0.1.242" # Zone 3
네트워크 구성(프로젝트 네트워크 정책)
프로젝트 외부 또는 조직 외부에서 DB에 연결해야 하는 경우 그에 따라 PNP(프로젝트 네트워크 정책)를 설정해야 합니다.
사용 사례에 따라 PNP 개요 섹션을 따릅니다.
에어 갭 적용 소프트웨어 준비
대상 VM에 인터넷 액세스 권한이 없으므로 먼저 연결된 워크스테이션에서 아티팩트를 다운로드해야 합니다.
Docker를 통해 패키지 다운로드
Ubuntu Docker 컨테이너를 사용하여 로컬 워크스테이션에서 다음을 실행합니다.
mkdir -p ./packages
docker run --rm -v "$(pwd)/packages:/packages" ubuntu:22.04 bash -c "
apt-get update
apt-get install curl
curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | bash
apt-get update
cd packages
PACKAGES='mariadb-server mariadb-client mariadb-common mysql-common'
apt-get download \$(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances --no-pre-depends \${PACKAGES} | grep '^\w')
apt-get download libpam-modules-bin
"
전송 및 설치
다운로드한 .deb 파일을 3개의 VM 모두에서 /tmp/packages/에 업로드하고 설치합니다.
# From local workstation
scp ./packages/*.deb ${VM1_IP}:/tmp/packages/
scp ./packages/*.deb ${VM2_IP}:/tmp/packages/
scp ./packages/*.deb ${VM3_IP}:/tmp/packages/
# On each VM, run:
sudo apt update
sudo dpkg -i /tmp/packages/*.deb
dpkg에서 오류가 반환되지 않는지 확인합니다. 그렇다면 로그를 확인하여 누락된 deb 패키지를 확인하고 다운로드에 포함합니다.
MariaDB 및 Galera 초기화
모든 VM에서 Galera 구성
먼저 mariadb 서버를 중지합니다.
sudo systemctl stop mariadb
HAProxy(3306 소유)와의 포트 충돌을 방지하려면 MariaDB 기본 포트를 3308로 변경합니다. 모든 VM에서 /etc/mysql/mariadb.conf.d/60-galera.cnf 수정:
[mysqld]
bind-address = 0.0.0.0
port = 3308
binlog_format = ROW
default-storage-engine = innodb
innodb_autoinc_lock_mode = 2
# Galera Provider Configuration
wsrep_on = ON
wsrep_provider = /usr/lib/galera/libgalera_smm.so
wsrep_cluster_name = "mariadb-ha-cluster"
wsrep_cluster_address = "gcomm://${VM1_IP},${VM2_IP},${VM3_IP}" # explicitly set the IPs, do not leave bash syntax / environment variable
wsrep_sst_method = rsync
# Node-specific (Update per VM)
wsrep_node_address = "${VM1_IP}" # explicitly set the IPs, do not leave bash syntax / environment variable. Change for VM 2 and VM 3
wsrep_node_name = "db-node-1" # Change for VM 2 and VM 3
클러스터 부트스트랩
VM 1에서만 새 클러스터를 초기화합니다.
sudo galera_new_cluster
복제본 조인
VM 1이 성공적으로 실행되면 VM 2 및 VM 3에서 MariaDB 서비스를 순차적으로 시작합니다.
sudo systemctl start mariadb
참고: 각 노드가 완전히 동기화될 때까지 기다린 후 다음 노드를 시작하세요.
HA DB가 실행 중인지 확인
VM에서 다음을 실행합니다.
sudo mariadb
그런 다음:
MariaDB [(none)]> SHOW STATUS LIKE 'wsrep_cluster_size';
+--------------------+-------+
| Variable_name | Value |
+--------------------+-------+
| wsrep_cluster_size | 3 |
+--------------------+-------+
1 row in set (0.001 sec)
예상 값은 3입니다.
Python 상태 점검
Python의 기본 제공 http.server 라이브러리를 사용하고 이를 systemd 서비스에 래핑하여 포트 9200의 백그라운드에서 자동으로 실행되도록 합니다.
DB 사용자 만들기
한 VM에서 다음을 실행합니다.
CREATE USER 'clustercheck_user'@'localhost' IDENTIFIED BY 'clustercheck_password';
FLUSH PRIVILEGES;
Python 스크립트 만들기
VM 3개 모두에서 /usr/local/bin/clustercheck.py 스크립트를 만듭니다.
sudo nano /usr/local/bin/clustercheck.py
다음 코드를 정확하게 붙여넣습니다.
#!/usr/bin/env python3
import mysql.connector
from http.server import BaseHTTPRequestHandler, HTTPServer
class HealthHandler(BaseHTTPRequestHandler):
def do_GET(self):
try:
# Connect to backend MariaDB port 3308
db = mysql.connector.connect(user='clustercheck_user', password='clustercheck_password', host='127.0.0.1', port=3308)
cursor = db.cursor()
cursor.execute("SHOW GLOBAL STATUS LIKE 'wsrep_local_state_comment'")
state = cursor.fetchone()
# Galera 'Synced' state means the node is fully healthy
if state == 'Synced':
self.send_response(200)
self.end_headers()
self.wfile.write(b"Node is Healthy and Synced.\n")
else:
self.send_response(503)
self.end_headers()
self.wfile.write(b"Node is unavailable.\n")
except Exception as e:
self.send_response(503)
self.end_headers()
HTTPServer(('0.0.0.0', 9200), HealthHandler).serve_forever()
실행 파일로 만듭니다.
sudo chmod +x /usr/local/bin/clustercheck.py
systemd 서비스 만들기
Python 스크립트를 관리하는 서비스 파일을 만듭니다.
sudo nano /etc/systemd/system/clustercheck.service
이 구성을 붙여넣습니다.
[Unit]
Description=MariaDB Galera Health Check
After=network.target mariadb.service
[Service]
Type=simple
User=root
ExecStart=/usr/local/bin/clustercheck.py
Restart=always
[Install]
WantedBy=multi-user.target
서비스를 사용 설정하고 시작합니다.
sudo systemctl daemon-reload
sudo systemctl enable --now clustercheck.service
curl -i http://127.0.0.1:9200를 실행하여 로컬에서 테스트할 수 있습니다.
HAProxy 구성
동일한 절차를 수행하여 haproxy 패키지를 가져와 VM에 업로드합니다.
그런 다음 각 노드에서 HAProxy 구성 파일을 구성하여 트래픽 라우팅을 처리합니다.
HAProxy 구성
모든 VM에서 /etc/haproxy/haproxy.cfg을 수정합니다.
global
log /dev/log local0
user haproxy
group haproxy
daemon
defaults
log global
mode tcp
option tcplog
timeout connect 5000ms
timeout client 50000ms
timeout server 50000ms
# Write Port (Active/Backup)
listen galera_write
bind *:3306
mode tcp
option httpchk GET /
http-check expect status 200
server db-node-1 10.0.1.245:3308 check port 9200
server db-node-2 10.0.1.241:3308 check port 9200 backup
server db-node-3 10.0.1.242:3308 check port 9200 backup
# Read Port (Round-Robin)
listen galera_read
bind *:3307
mode tcp
balance roundrobin
option httpchk GET /
http-check expect status 200
server db-node-1 10.0.1.245:3308 check port 9200
server db-node-2 10.0.1.241:3308 check port 9200
server db-node-3 10.0.1.242:3308 check port 9200
중요: IP와 이름을 일치하도록 변경합니다.
노드를 하나씩 다시 시작하여 변경사항을 안전하게 적용합니다.
sudo systemctl restart haproxy
sudo systemctl enable haproxy
HAProxy 라우팅 동작 확인
다음 명령어를 실행하여 HAProxy가 활성/백업 토폴로지에 따라 읽기 및 쓰기를 처리하는지 확인합니다.
쓰기 라우팅 확인(활성/백업): HAProxy는 노드 1이 중단되지 않는 한 모든 포트
3306트래픽을 노드 1로만 전송하도록 구성됩니다. VM 2 또는 VM 3의 터미널에서 이 명령어를 연속으로 3~4회 실행합니다.mysql -h 127.0.0.1 -P 3306 -u clustercheck_user -pclustercheck_password -e "SELECT @@hostname;"예상 결과: 실행할 때마다 노드 1의 호스트 이름(예:
db-node-1)이 반환되어야 합니다. VM 2 또는 3에서 로컬 HAProxy를 쿼리하는 경우에도 네트워크를 통해 쓰기 연결을 노드 1로 올바르게 전달합니다.읽기 라우팅(라운드 로빈) 확인: HAProxy는 완전히 동기화된 모든 노드에 포트
3307트래픽을 균등하게 분산하도록 구성됩니다. 이 명령어를 연속으로 3~4회 실행합니다.mysql -h 127.0.0.1 -P 3307 -u clustercheck_user -pclustercheck_password -e "SELECT @@hostname;"예상 결과: 출력은 클러스터의 호스트 이름(예:
db-node-1,db-node-2,db-node-3)을 균등하게 순환해야 합니다.
전역 부하 분산기 설정
GDC 전역 L4 부하 분산기를 사용하여 애플리케이션에 안정적인 단일 가상 IP(VIP)를 제공합니다. 내부 전역 부하 분산기 구성에 따라 내부 전역 L4 부하 분산기를 설정하고 VM을 대상으로 설정합니다. VM을 부하 분산기 대상으로 설정
자동 장애 조치 테스트
가장 중요한 테스트입니다. 노드가 다운되면 Python 스크립트가 이를 감지하고 HAProxy가 즉시 트래픽을 다시 라우팅한다는 것을 증명해야 합니다.
A단계: 노드 1에서 장애 시뮬레이션: 노드 1에 SSH로 연결하고 데이터베이스를 완전히 중지합니다.
sudo systemctl stop mariadbB단계: 쓰기 포트 다시 테스트: VM 2 또는 VM 3에서 쓰기 테스트를 다시 실행합니다.
mysql -h 127.0.0.1 -P 3306 -u clustercheck_user -pclustercheck_password -e "SELECT @@hostname;"예상 결과: 노드 2(
db-node-2)를 즉시 반환해야 합니다. HAProxy는 Python 스크립트를 통해 노드 1이 중단되었음을 인식하고 첫 번째 백업 서버를 승격했습니다.C단계: 읽기 포트 다시 테스트: 읽기 테스트를 여러 번 실행합니다.
mysql -h 127.0.0.1 -P 3307 -u clustercheck_user -pclustercheck_password -e "SELECT @@hostname;"예상 결과: 노드 2와 노드 3 사이에서만 순환해야 합니다. 노드 1이 순환에서 완전히 삭제되었습니다.
D단계: 장애 복구 복구 및 확인: 노드 1에서 MariaDB를 다시 시작합니다.
sudo systemctl start mariadb동기화될 때까지 몇 초간 기다린 후(상태 4) 쓰기 테스트(포트 3306)를 마지막으로 한 번 더 실행합니다. HAProxy는 노드 1이 다시 정상 상태임을 자동으로 감지하고 노드 2에서 쓰기 트래픽을 다시 가져와야 합니다.