MySQLのレプリケーションをLinuxサーバー2台で構築する手順｜binlogとGTIDによるソース・レプリカ設定

この記事のポイント

・MySQLレプリケーションはbinlogを介してソースからレプリカへ更新を自動同期する仕組み
・binlogポジション方式はFile名+位置で同期、GTID方式は一意IDで自動追跡する
・MySQL 8.4ではCHANGE MASTER TO等の旧構文が廃止。新コマンドへの対応が必須
・SHOW REPLICA STATUSでIO/SQLスレッド両方がYesなら正常動作している

# 確認コマンド（両サーバーで実行）
cat /etc/redhat-release
rpm -q mysql-community-server

# 出力例
Rocky Linux release 9.4 (Blue Onyx)
mysql-community-server-8.4.5-1.el9.x86_64

# レプリカサーバー（192.168.1.20）から実行
nc -zv 192.168.1.10 3306

# 疎通OKの場合の出力
Ncat: Version 7.92 ( https://nmap.org/ncat )
Ncat: Connected to 192.168.1.10:3306.
Ncat: 0 bytes sent, 0 bytes received in 0.00s.

# ソースサーバーで実行（レプリカのIPからのみ許可）
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="192.168.1.20/32" port port="3306" protocol="tcp" accept'
sudo firewall-cmd --reload

# /etc/my.cnf.d/mysql-server.cnf（ソースサーバー）に追記
[mysqld]
# レプリケーション設定
server-id = 1
log_bin = /var/lib/mysql/mysql-bin
binlog_format = ROW
binlog_expire_logs_seconds = 604800
max_binlog_size = 100M

# ソースサーバーで実行
sudo systemctl restart mysqld
sudo systemctl status mysqld

# 出力例（Active: active (running) を確認）
* mysqld.service - MySQL Server
     Loaded: loaded (/usr/lib/systemd/system/mysqld.service; enabled; preset: disabled)
     Active: active (running) since Mon 2026-08-10 09:12:43 JST; 3s ago

-- ソースサーバーのMySQLで実行
-- レプリカのIPアドレス（192.168.1.20）からのみ接続を許可
CREATE USER 'repl'@'192.168.1.20' IDENTIFIED WITH mysql_native_password BY 'ReplPassword123!';
GRANT REPLICATION SLAVE ON *.* TO 'repl'@'192.168.1.20';
FLUSH PRIVILEGES;

-- ソースサーバーのMySQLで実行
FLUSH TABLES WITH READ LOCK;
SHOW BINARY LOG STATUS;

-- 出力例
+------------------+----------+--------------+------------------+
| File             | Position | Binlog_Do_DB | Binlog_Ignore_DB |
+------------------+----------+--------------+------------------+
| mysql-bin.000003 |      897 |              |                  |
+------------------+----------+--------------+------------------+

# /etc/my.cnf.d/mysql-server.cnf（レプリカサーバー）に追記
[mysqld]
server-id = 2
relay_log = /var/lib/mysql/relay-bin
read_only = ON

sudo systemctl restart mysqld

-- レプリカサーバーのMySQLで実行
CHANGE REPLICATION SOURCE TO
  SOURCE_HOST='192.168.1.10',
  SOURCE_USER='repl',
  SOURCE_PASSWORD='ReplPassword123!',
  SOURCE_LOG_FILE='mysql-bin.000003',
  SOURCE_LOG_POS=897;

-- レプリカサーバーのMySQLで実行
START REPLICA;
SHOW REPLICA STATUS\G

-- SHOW REPLICA STATUS\G の出力（成功時・抜粋）
             Replica_IO_Running: Yes
            Replica_SQL_Running: Yes
                   Source_Host: 192.168.1.10
                   Source_User: repl
                   Source_Port: 3306
              Source_Log_File: mysql-bin.000003
          Read_Source_Log_Pos: 897
          Seconds_Behind_Source: 0

-- ソースサーバーのMySQLで実行（FLUSH TABLES WITH READ LOCKのセッション）
UNLOCK TABLES;

# ソース・レプリカ両方の /etc/my.cnf.d/mysql-server.cnf に追記
[mysqld]
gtid_mode = ON
enforce_gtid_consistency = ON

-- レプリカサーバーのMySQLで実行（GTIDモード）
CHANGE REPLICATION SOURCE TO
  SOURCE_HOST='192.168.1.10',
  SOURCE_USER='repl',
  SOURCE_PASSWORD='ReplPassword123!',
  SOURCE_AUTO_POSITION=1;

START REPLICA;
SHOW REPLICA STATUS\G

-- ソースサーバーのMySQLで実行
CREATE DATABASE repl_test;
USE repl_test;
CREATE TABLE check_table (
  id INT AUTO_INCREMENT PRIMARY KEY,
  val VARCHAR(50),
  created_at DATETIME DEFAULT NOW()
);
INSERT INTO check_table (val) VALUES ('test_row_001');
SELECT * FROM check_table;

-- 出力例
+----+--------------+---------------------+
| id | val          | created_at          |
+----+--------------+---------------------+
|  1 | test_row_001 | 2026-08-10 09:35:12 |
+----+--------------+---------------------+

-- レプリカサーバーのMySQLで実行（数秒後）
USE repl_test;
SELECT * FROM check_table;

-- 出力例（ソースと同じデータが確認できる）
+----+--------------+---------------------+
| id | val          | created_at          |
+----+--------------+---------------------+
|  1 | test_row_001 | 2026-08-10 09:35:12 |
+----+--------------+---------------------+

-- エラー確認
SHOW REPLICA STATUS\G

-- 出力例（エラー箇所のみ抜粋）
Last_SQL_Error: Error 'Duplicate entry '1' for key 'PRIMARY'' on query. ...