• Home
• コーポレートブログ
• MySQL互換DB「TiDB」でRedmine互換OSS「RedMica」を動かす検証

こんにちは。吉岡です。
先日、AWS Summit Japan 2025 に参加して、そこで気になるサービスを見つけたので、その中から今日はTiDBについて書きたいと思います。

はじめに

社内タスク管理やプロジェクト管理でよく使われるRedmine。今回はMySQL互換の分散型クラウドデータベース TiDB を利用し、Redmine互換のOSS「RedMica」を実際に動かす検証を行いました。

セットアップ手順・ポイントを中心にまとめましたので、クラウド型MySQL互換DBの検証事例としてご参考ください。

TiDBを使うきっかけ

数年前、某エバンジェリストだった方にRDSのスケールで悩んでいると話をしたところ、TiDBを勧められたのがきっかけです。また、AWS Summit Japan 2025 の展示ブースでも実際に担当の方が非常に丁寧に製品の説明をしてくださり、「ぜひ使ってみたい」と思えるきっかけとなりました。もちろん前からTiDB自体には興味がありましたが、実際に説明を聞く機会（コミュニケーション）が試すきっかけになったことは間違いありません！

1. TiDBの準備（アカウント作成とデータベース作成）

TiDB Cloudアカウント作成・クラスタ作成

まずはTiDB Cloudのアカウントを作成し、新規にクラスタを作成します。

TiDB Cloudにアクセスし、「無料で始める」からアカウントを登録してください。

RedMica用データベース作成

クラスタ作成後、Redmica用のデータベース（例：redmica_sample）を作成します。SQL Editor から以下のコマンドを入力し、実行します。

CREATE DATABASE IF NOT EXISTS `redmica_sample`;

作成後は「Overview」の右上にある。「connect」から 接続情報（ホスト名、ユーザー名、パスワード、ポート番号など） を必ず控えておきましょう。（最初にpassword作成が必要です。）

TiDBのMySQL互換性

一部のMySQL特有SQLやプラグインが動作しない可能性があります。詳細は公式ドキュメントの「MySQL Compatibility」ページを参照するのがおすすめです。
MySQL Compatibility | TiDB Documentation

2. RedMicaアプリケーションのセットアップ

事前準備（必要なパッケージ・ライブラリのインストール）

RedMicaが依存するmysql2 gemをインストールするため、必要なパッケージをHomebrewで導入します。

brew install mysql@8.4

RedMicaリポジトリのクローン

GitHubからRedMicaを取得し、作業ディレクトリへ移動します。

git clone git@github.com:redmica/redmica.git redmica-tidb
cd redmica-tidb

必要なGemのインストール

mysql2 gemのビルドのため、環境変数を追加してからbundle installを実行します。

brew install zstd
export LIBRARY_PATH=$LIBRARY_PATH:$(brew --prefix zstd)/lib/
bundle install

mysql2 gemインストールエラー

macOS環境では、zstdやmysql@8.4などHomebrew経由のパッケージ不足でエラーが出ることがあります。
例：ld: library not found for -lzstd

対策として brew install zstd で事前にインストールし、LIBRARY_PATH環境変数をセットしてください。

RedMicaの初期設定

secret の設定

echo "RedmineApp::Application.config.secret_key_base = `bin/rails secret`" > config/initializers/secret_token.rb

データベース設定（database.yml）の作成・編集

サンプル設定ファイルをコピーし、TiDBの接続情報を記載します。

cp config/database.yml.example config/database.yml

config/database.yml の production セクションを下記のように編集します。

production:
  adapter: mysql2
  database: redmica_sample
  host: *********.tidbcloud.com
  username: ***********.root
  password: "***********"
  encoding: utf8mb4
  port: 4000
  variables:
    transaction_isolation: "READ-COMMITTED"

※各種接続情報はTiDBクラスタ作成時に控えた内容を設定してください。
※transaction_isolation は READ-COMMITTED 推奨（TiDB公式ドキュメント参照）

RedMicaの初期化と起動

データベースマイグレーションの実行

RAILS_ENV=production bin/rails db:migrate

初期データのロード

RAILS_ENV=production bin/rails redmine:load_default_data

サーバーの起動

RAILS_ENV=production rails s

ブラウザで http://localhost:3000 にアクセスし、RedMicaの画面が表示されればセットアップ完了です！

まとめ・ポイント

• TiDBはMySQL互換が高く、RedMicaも問題なくセットアップ可能
• brewで事前パッケージ（zstd, mysql8.4等）をインストールしておくとトラブルが少ない

気に入った点

• Writeスケーラビリティが高いため、大規模利用や将来的なスケールアウトも期待できる。
  （Redmine本体はDBスケールアウトが難しい構造なので、TiDBの強みを活かせそう）
• TiDBはAWS上でサービスが提供されているため、VPCピアリングを設定することができる。（セキュア＆低レイテンシー）
• 開発用途であれば無料枠の利用もできそうで、そのまま本番用途にスケールアップして課金プランへ移行することも可能。

参考

• TiDB公式ドキュメント
• MySQL Compatibility | TiDB Documentation
• RedMica GitHub リポジトリ

おわりに

今回の検証で、クラウド型MySQL互換DBであるTiDB上でもRedMicaが問題なく動作することを確認できました。今後も新しいインフラやミドルウェアの検証を進めていきます！

---