제이브레인 시스템 트레이딩

Multi-tenant 로 MariaDB 검색 예제를 만들어보겠습니다.

1) Multi-tenant 설계

회사에서 개발을 할 때 Environment 를 Live, Stage, Dev 로 나누는 경우가 많습니다.

✅ 1.1 Dev (Development)

개발 환경

• 개발자들이 새로운 기능을 개발하거나 테스트하는 환경
• 버그가 많을 수 있음 (개발 중이기 때문에)
• 실제 데이터가 아닌 모의 데이터(mock data) 사용
• 자주 수정되고 재시작됨

🧪 예시:

"로그인 기능 새로 개발했는데 dev 환경에 올려볼게."

✅ 1.2 Stage (Staging)

사전 검증 환경 (실제 배포 전 테스트용)

• 운영 환경과 거의 동일한 구성 (서버, DB, 설정 등)
• QA 팀이 기능을 점검하거나 PM이 검토할 때 사용
• 실제 데이터와 유사한 테스트 데이터 사용
• 릴리스 전 최종 점검 단계

🧪 예시:

"이번 배포 전에 stage 환경에서 한번 더 테스트해보자."

✅ 1.3 Live (Production)

실제 서비스 운영 환경

• 유저들이 직접 사용하는 실제 서비스
• 장애 발생 시 비즈니스에 바로 영향을 줌 ⚠️
• 코드와 데이터 모두 신중히 다뤄야 함
• 실시간 트래픽, 진짜 사용자 데이터

그리고 각 Environment 를 first, second,  ... 와 같이 db_type 으로 나누기도 합니다.

이는 각 고객이나 서비스를 type 별로 구별하여 좀더 세분화 하기 위해서 입니다.

이를 scale out 이라고 합니다. 

scale out 이 scale up 보다 장점이 많이 존재합니다.

✅ db_type으로 나누는 Scale-Out의 장점

❌ Scale-Up 방식의 한계

🎯 예시: multi-tenant + scale-out 구조

예를 들면 아래와 같이 first DB 는 주문 처리를 하고 second DB 는 상품 관리를 하는 것과 같이 분리할 수 있습니다.

다음은 전체 설계 내용입니다.

Environment 로 Lvie(상용 서버 배포), Stage(상용 배포전 사전 검증), Dev(개발 서버) 로 구분하였습니다.

db_type 으로 first, second 를 분리하였습니다.

ChatGPT 에 사용한 프롬프트입니다.

vagrant 로 rocky 9 OS에 mariadb VM 6개를 만들려고 합니다. 
mariadb 는 password vagrant 로 접속 가능하게 해주세요.
외부에서 3306 포트로 접속이 가능하게 해주세요.
sample db 도 만들고 sample table 도 생성하고 sample data 도 추가해주세요.

multi-tenant 로 environment, db_type 으로 구분하려고 합니다.
environment 는 Live, Stage, Dev 로 나눌 예정이며
db_type 은 first, second 로 나눌 예정입니다.
VM 이름과 IP 는 다음과 같습니다.
dev_first : 192.168.56.20
dev_second : 192.168.56.21
stage_first : 192.168.56.22
stage_second : 192.168.56.23
live_first : 192.168.56.24
live_second : 192.168.56.25

python 으로 environment, db_type 이라는 파라미터 입력을 받아서
각 VM 에 설치된 mariadb 의 sample table 을 검색하는 예제를 만들어주세요.
first 에는 sample table 로 주문 처리 관련 테이블을 생성하고 sample 데이터도 넣어주세요.
second 에는 sample table 로 상품 관리 테이블을 생성하고 sample 데이터도 넣어주세요.

생성된 Vagrantfile 입니다.

아래 파일은 다음 git 에서 다운로드 가능합니다.

git clone git@github.com:jbpark/jbDeskExample.git
cd jbDeskExample/jbDesk/ch2.3

✅ 1) VM 구성 (Vagrantfile 예시)

VAGRANT_BOX = "generic/rocky9"
DB_PASSWORD = "vagrant"
MARIADB_PORT = 3306

VMs = {
  "dev-first"    => "192.168.56.20",
  "dev-second"   => "192.168.56.21",
  "stage-first"  => "192.168.56.22",
  "stage-second" => "192.168.56.23",
  "live-first"   => "192.168.56.24",
  "live-second"  => "192.168.56.25"
}

Vagrant.configure("2") do |config|
  config.vm.box = VAGRANT_BOX

  VMs.each do |name, ip|
    config.vm.define name do |vm_config|
      vm_config.vm.hostname = name
      vm_config.vm.network "private_network", ip: ip
      vm_config.vm.provider "virtualbox" do |vb|
        vb.name = name
        vb.memory = 1024
        vb.cpus = 1
      end

      # Determine table type based on VM name
      table_sql = if name.include?("first")
        <<-SQL
          CREATE TABLE IF NOT EXISTS orders (
              id INT AUTO_INCREMENT PRIMARY KEY,
              customer_name VARCHAR(100),
              product VARCHAR(100),
              quantity INT,
              order_date DATE
          );

          INSERT IGNORE INTO orders (customer_name, product, quantity, order_date)
          VALUES ('John Doe', 'Laptop', 1, '2025-04-01'),
                 ('Jane Smith', 'Monitor', 2, '2025-04-02');
        SQL
      else
        <<-SQL
          CREATE TABLE IF NOT EXISTS products (
              id INT AUTO_INCREMENT PRIMARY KEY,
              name VARCHAR(100),
              price INT,
              stock INT
          );

          INSERT IGNORE INTO products (name, price, stock)
          VALUES ('Laptop', 1200000, 10),
                 ('Monitor', 300000, 25);
        SQL
      end

      vm_config.vm.provision "shell", inline: <<-SHELL
        dnf install -y mariadb-server
        systemctl enable mariadb
        systemctl start mariadb

        echo "[+] Configuring MariaDB to allow remote access..."

        # bind-address=0.0.0.0 설정
        sed -i 's/^bind-address=127.0.0.1/bind-address=0.0.0.0/' /etc/my.cnf.d/mariadb-server.cnf || \
        echo -e "[mysqld]\nbind-address=0.0.0.0" >> /etc/my.cnf.d/mariadb-server.cnf

        systemctl restart mariadb

        echo "[+] Creating remote-accessible root user..."
        mariadb -e "GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'vagrant' WITH GRANT OPTION;"
        mariadb -e "FLUSH PRIVILEGES;"

        # Create sample DB and appropriate table
        mysql -uroot -p#{DB_PASSWORD} <<EOF
CREATE DATABASE IF NOT EXISTS sample;
USE sample;
#{table_sql}
EOF

        echo "[+] Opening firewall for MariaDB..."
        firewall-cmd --permanent --add-port=3306/tcp
        firewall-cmd --reload
      SHELL
    end
  end
end

📝 실행 방법

vagrant up

✅ 2) Python 예제 (query_sample_table.py)

import pymysql

# VM 정보 매핑
VM_INFO = {
    "dev_first":    {"ip": "192.168.56.20"},
    "dev_second":   {"ip": "192.168.56.21"},
    "stage_first":  {"ip": "192.168.56.22"},
    "stage_second": {"ip": "192.168.56.23"},
    "live_first":   {"ip": "192.168.56.24"},
    "live_second":  {"ip": "192.168.56.25"},
}

def get_vm_name(environment: str, db_type: str) -> str:
    return f"{environment.lower()}_{db_type.lower()}"

def table_exists(cursor, table_name: str) -> bool:
    cursor.execute(f"SHOW TABLES LIKE '{table_name}';")
    return cursor.fetchone() is not None

def query_sample_tables(ip: str, user: str = "root", password: str = "vagrant", db: str = "sample"):
    try:
        conn = pymysql.connect(host=ip, port=3306, user=user, password=password, database=db)
        cursor = conn.cursor()

        if table_exists(cursor, "orders"):
            print("[orders 테이블]")
            cursor.execute("SELECT * FROM orders;")
            for row in cursor.fetchall():
                print(row)
        else:
            print("[orders 테이블 없음]")

        if table_exists(cursor, "products"):
            print("\n[products 테이블]")
            cursor.execute("SELECT * FROM products;")
            for row in cursor.fetchall():
                print(row)
        else:
            print("[products 테이블 없음]")

        cursor.close()
        conn.close()
    except Exception as e:
        print(f"[!] 접속 실패: {e}")

if __name__ == "__main__":
    import argparse

    parser = argparse.ArgumentParser()
    parser.add_argument("--environment", choices=["dev", "stage", "live"], required=True)
    parser.add_argument("--db_type", choices=["first", "second"], required=True)
    args = parser.parse_args()

    vm_name = get_vm_name(args.environment, args.db_type)
    ip = VM_INFO.get(vm_name, {}).get("ip")

    if not ip:
        print(f"[!] VM 정보 없음: {vm_name}")
    else:
        print(f"[+] {vm_name} ({ip}) 에 접속합니다...")
        query_sample_tables(ip)

💻 실행 예시

python query_sample_table.py --environment dev --db_type first

위의 경우 environment 는 dev 를 db_type 은 first 로 쿼리 요청을 하면 host 는 dev-first 에 있는 mariadb 검색 요청을 합니다.

3) JbDesk 와 통합

통합된 코드는 다음에서 다운받을 수 있습니다.

Env 에서 environment 는 dev 를 db_type 은 first 로 쿼리 요청 시 dev-first 의 MariaDb 에서 검색 요청이 이루어집니다.

git clone git@github.com:jbpark/jbDesk.git
cd jbDesk

Vagrant 로 Rocky Linux 에 MariaDB 를 설치해보겠습니다.

이번에는 VM 3개에 MariaDB 를 설치하여 Multi-Tenant 를 구성해보겠습니다.

Multi-Tenant 는 단일 인스턴스가 여러 고객에게 서비스를 제공하는 아키텍처를 말합니다.

이제 MariaDB가 각기 다른 테넌트의 데이터베이스를 처리하도록 설정되었습니다. 이를 통해 여러 애플리케이션이 각기 다른 데이터베이스에 연결하여 독립적으로 작업할 수 있습니다. 예를 들어, 애플리케이션은 다음과 같이 각 MariaDB 인스턴스에 연결할 수 있습니다.

테넌트 1: mariadb1:3306

테넌트 2: mariadb2:3307

테넌트 3: mariadb3:3308

각 애플리케이션은 테넌트마다 고유한 데이터베이스에 연결하여 데이터를 처리하게 됩니다.

ChatGPT 에 사용한 프롬프트입니다

vagrant 로 virtualbox 에 rocky linux 9 에 mariadb 를 설치하는 VM 3개를 만들어주세요.
VM 의 IP 는 192.168.56.20, 192.168.56.21, 192.168.56.22 로 설정하고 
VM 이름은 maridb20, maridb21, maridb22 으로 설치하는 방법을 단계별로 알려주세요.
mariadb 는 password vagrant 로 접속 가능하게 해주세요.
외부에서 3306 포트로 접속이 가능하게 해주세요.
sample db 도 만들고 sample table 도 생성하고 sample data 도 추가해주세요.

1) Vagrant 설치

Vagrant 1.1편-Vagrant설치 를 참고해주세요.

2) 프로젝트 폴더 생성

프로젝트 폴더를 만들어주어야 합니다.

mkdir vagrant-rocky-mariadb
cd vagrant-rocky-mariadb

3) Vagrantfile 생성

생성된 Vagrantfile 입니다.

다음 파일은 아래 git 에서 다운받을 수 있습니다.

git clone git@github.com:jbpark/jbDeskExample.git
cd jbDeskExample/vagrant/ch1.3

프로젝트 폴더에 아래 Vagrnatfile 을 생성해주세요.

Vagrantfile

Vagrant.configure("2") do |config|
  nodes = [
    { :name => "mariadb20", :ip => "192.168.56.20" },
    { :name => "mariadb21", :ip => "192.168.56.21" },
    { :name => "mariadb22", :ip => "192.168.56.22" }
  ]

  nodes.each do |node|
    config.vm.define node[:name] do |node_config|
      node_config.vm.box = "rockylinux/9"
      node_config.vm.hostname = node[:name]
      node_config.vm.network "private_network", ip: node[:ip]

      node_config.vm.provider "virtualbox" do |vb|
        vb.name = node[:name]
        vb.memory = 1024
        vb.cpus = 1
      end

      node_config.vm.network "forwarded_port", guest: 3306, host: 3306, auto_correct: true

      node_config.vm.provision "shell", inline: <<-SHELL
        dnf install -y mariadb-server
        systemctl enable mariadb
        systemctl start mariadb

        echo "[+] Configuring MariaDB to allow remote access..."

        # bind-address=0.0.0.0 설정
        sed -i 's/^bind-address=127.0.0.1/bind-address=0.0.0.0/' /etc/my.cnf.d/mariadb-server.cnf || \
        echo -e "[mysqld]\nbind-address=0.0.0.0" >> /etc/my.cnf.d/mariadb-server.cnf

        systemctl restart mariadb

        echo "[+] Creating remote-accessible root user..."
        mariadb -e "GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'vagrant' WITH GRANT OPTION;"
        mariadb -e "FLUSH PRIVILEGES;"

        echo "[+] Creating sample DB, tables, and inserting sample data..."
        mariadb -u root <<EOF
CREATE DATABASE IF NOT EXISTS sample;
USE sample;

CREATE TABLE IF NOT EXISTS users (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(100),
    email VARCHAR(100),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE IF NOT EXISTS products (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(100),
    price DECIMAL(10, 2),
    stock INT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

INSERT INTO users (name, email) VALUES
    ('Alice', 'alice@example.com'),
    ('Bob', 'bob@example.com'),
    ('Charlie', 'charlie@example.com');

INSERT INTO products (name, price, stock) VALUES
    ('Laptop', 1200.00, 10),
    ('Smartphone', 800.00, 25),
    ('Headphones', 150.00, 50);
EOF

        echo "[+] Opening firewall for MariaDB..."
        firewall-cmd --permanent --add-port=3306/tcp
        firewall-cmd --reload
      SHELL
    end
  end
end

4) VM 생성 및 구동

vagrant up

5) VM 접속

각 VM 에는 아래와 같이 접속이 가능합니다.

vagrant ssh mariadb20
vagrant ssh mariadb21
vagrant ssh mariadb22

6) MariaDb 접속

Dbeaver 로는 Database Client 프로그램으로 접속해보겠습니다.

✅ 1. DBeaver 다운로드 및 설치

1. 공식 홈페이지 방문
   👉 https://dbeaver.io/download/
2. OS에 맞는 설치파일 다운로드
   • Windows: DBeaver Community Edition Windows Installer
   • Mac: .dmg
   • Linux: .deb 또는 .rpm
3. 설치 프로그램 실행 후, 기본 설정으로 설치 진행

✅ 2. MariaDB 접속 정보 확인

MariaDB 서버가 로컬 Vagrant VM에서 구동 중이라면 다음과 같이 확인하세요:

※ vagrantfile에서 root 사용자의 비밀번호를 vagrant로 설정한 경우입니다.

✅ 3. DBeaver에서 MariaDB 접속

1. DBeaver 실행 후 왼쪽 상단 [Database] → [New Database Connection] 클릭
   또는 단축키 Ctrl + N
2. 검색창에 "MariaDB" 입력 → MariaDB 선택 → Next
3. 다음 정보를 입력:
4. yaml
   복사편집
   Host: 127.0.0.1 Port: 3306 Database: sample Username: root Password: vagrant
5. [Test Connection] 버튼 클릭 → 정상 연결되면 성공
6. Finish 버튼을 눌러 접속 완료

✅ 4. 접속 확인

• 왼쪽 탐색창에서 sample DB 아래 tables 를 확장하면
  users, products 테이블을 볼 수 있습니다.
• 마우스 우클릭 → View Data → View All Rows 선택 시 데이터 조회 가능