バージョンアップとサーバ移行、一緒にやって大丈夫?

バージョンアップとサーバ移行、一緒にやって大丈夫？第30回 redmine.tokyo 勉強会 2026年5月16日(土) 高江洲尚樹 / @naopontan
〜同時に進めるときの注意点〜

自己紹介高江洲(タカエス)と申します。沖縄県在住。バックエンド開発を中心に、SE として長くシステム開発に従事してきました。現在は株式会社アジャイルウェアと連携し、テクニカルサポートを担当しています。 X (Twitter) https://x.com/naopontan

はじめに Redmineのバージョンアップとサーバ移行、一緒にやってしまいたくなりませんか？一度で済ませたい、効率的に感じますよね。でも本来この2つは別々に考えるべき作業です。それでも同時に進めたい場合の注意点と、サポートを通じて見えてきたことをお話しします。

Redmineバージョンアップのおさらい  公式 RedmineUpgrade wiki は最も信頼できる一次情報  https://www.redmine.org/projects/redmine/wiki/RedmineUpgrade

Redmineバージョンアップのおさらい同一サーバ上でのバージョンアップは意外とシンプル 1. 要件確認 2. バックアップ 3. アップグレード 1. 新フォルダに新しいRedmineをダウンロード
2. 必要なファイルを新しいRedmine上にコピー 3. bundle install 4. DBの更新(マイグレーション) 5. 後処理(キャッシュクリア、httpdの参照先フォルダ変更など) 要件確認大事。ここには OS や Ruby、その他ミドルウェアのバージョンアップは含まれていないのがポイント

全体の流れ 1. 旧サーバで可能な限りバージョンアップをしておく 2. 要件確認(旧環境・新環境の差分) 3. 新サーバ構築 4. 移行

要件確認  バージョン情報  OS / RDBMS / Ruby 
プラグイン対応状況  /admin/info の出力をテキスト保存  ローカル変更  configuration.yml やテーマの配置先確認など  attachments_storage_path の実体パス / 別マウントの有無など  外部連携  メール / SCM連携 / 認証連携 / cron / API連携など

プラグイン互換性チェック旧 plugins/ をそのまま新サーバへコピーするのは絶対に避ける棚卸し → 各プラグインの新 Redmine 対応版を調査して判定 ①
対応版あり新 Redmine 対応のタグ／ブランチを git clone または git checkout → 最も楽なケース ② 自社カスタム新 Redmine の API に合わせてソースを修正（要工数見積） → 開発リソース確保が必須 ③ 廃止／非対応機能削除をステークホルダと合意し、Redmine 標準機能での代替を検討 → ファイルを削除しただけでは DB テーブルが残る点に注意プラグイン旧バージョン新対応版判定 redmine_xxx 1.2.3 1.5.0 ①入れ替え redmine_yyy 0.9.0 なし ②コード調整 redmine_zzz 2.0.1 廃止 ③除外

新サーバ構築  OS / DB / Webサーバ / Appサーバ /
Ruby  空DBで疎通確認(db:create → db:migrate → 起動 → db:drop) ここまでのゴール: 新サーバで「新 Redmine」が空 DB のまま動く旧データはまだ載せない。プラグインも入れない。

移行(カットオーバー) 旧サーバ新サーバ ▸ DB ダンプを取得 ▸ 添付ファイルを取得（tar /
rsync） ▸ リストア（DB / 添付ファイル） ▸ マイグレーション bundle exec rake db:migrate RAILS_ENV=production bundle exec rake redmine:plugins RAILS_ENV=production ▸ 動作確認 cron / チケット作成 / 添付ファイルアップロード / メール配信など

まとめ  「引っ越し」と「バージョンアップ」は同時実行も可能だが、頭の中では必ず別作業として切り分ける  可能なら別タイミングで実施したほうがトラブルは減る  バージョンアップ作業は長期間放置せず、適度な粒度で行うことが望ましい

ご清聴ありがとうございました

バージョンアップとサーバ移行、一緒にやって大丈夫?

バージョンアップとサーバ移行、一緒にやって大丈夫?

[email protected]

Featured

Transcript