SVNを継続利用したまま、リポジトリをクラウドのSVNホスティングへ移す手順を説明します。対象はファイルと履歴だけではありません。認証、権限、フック、外部連携、利用者の接続先も確認します。
本番切替には書き込みを停止する時間を設けます。検証移行で必要な時間と確認項目を把握し、どの条件で利用を再開するかを決めてから進めてください。
移行の流れ
準備と検証を先に行い、切替当日は最終状態の反映と確認に集中します。新環境で利用を再開するまで、旧環境への書き込みを禁止します。
図：旧環境の書き込み停止から、最終反映、確認、利用再開までの順序。画像を開くと拡大できます。
ステップ1 対象と保存要件を一覧にする
リポジトリ数、容量、利用者、認証方式、権限、SVNとOSのバージョンを記録します。フック、CI、課題管理、svn:externalsの参照先も含めてください。外部依存を取得する設定が残ると、移行後も旧サーバーへアクセスする場合があります。
使用中でないリポジトリも、保守や過去版の説明に必要か確認します。移さないものは保存場所と取出し方法を決めます。
ステップ2 バックアップと切り戻し条件を用意する
履歴と復旧に必要な設定を保全し、別の環境で復元できることを確認します。自社でサーバーを管理する場合は、svnadmin hotcopyなど、環境に適した方法を選びます。単に稼働中のリポジトリディレクトリをコピーする方法は、整合性を崩すおそれがあります。
切替を中止する条件、判断者、旧環境での再開手順を決めます。新環境で書き込みを再開した後の切り戻しは、新しい変更の回収が必要になるため、別に手順を用意してください。
ステップ3 移行方式を移行先と確認する
履歴を移す方法にはdump/load、svnrdump、svnsyncなどがあります。hotcopyを使う場合は、移行先の形式や実行環境との互換性を確認します。ホスティングではサーバー上の管理コマンドを利用できない場合があるため、提供元の取り込み方法に従います。
dump/loadを検証環境で試す場合の基本形は次のとおりです。管理権限があり、移行先に新規の空リポジトリを作る例です。既存データのある場所へ、そのまま実行しないでください。
svnadmin dump /path/to/oldrepo > repo.dump
svnadmin create /path/to/newrepo
svnadmin load /path/to/newrepo < repo.dump
svnadmin verify /path/to/newrepo
各処理の終了結果とエラーを確認してから次へ進みます。dumpには、フックやサーバー設定、現在のロック情報は含まれません。作業コピーをexportして新規登録する方法では、過去の履歴を引き継げません。
ステップ4 履歴と業務操作を検証する
最終リビジョン番号の一致だけで完了にせず、最新版と選定した過去版のファイル、属性、変更記録を照合します。サーバー側の整合性確認に加えて、利用者の権限で取得・更新・コミットを試してください。
権限、フック相当の処理、ロック、CI、課題管理の連携を確認します。利用できない機能は代替方法を決めます。接続先変更の手順もこの段階で検証して、利用者へ事前に配布します。
ステップ5 書き込みを停止して最終差分を反映する
旧環境の書き込み停止を確認し、確定した最終リビジョンを記録します。その状態までのバックアップを確保して、最終差分を移行先へ反映します。
事前同期で停止時間を短くする場合も、最後の同期と照合が必要です。同期対象外の設定や、既存リビジョンのログ変更も含め、選んだ方式で何が引き継がれるかを確認してください。
ステップ6 利用者と連携先の接続先を変更する
同じ履歴とリポジトリ内パスを維持し、UUIDも一致する移行では、svn relocateで作業コピーの接続先を変更できる場合があります。UUIDはリポジトリの識別子です。UUIDを合わせるだけで異なる履歴を同じものとして扱えるわけではありません。
これは接続先変更の例です。ローカルの未コミット変更を保全し、検証済みの手順で行ってください。履歴の再編やパスの変更がある場合は、再チェックアウトなど別の手順を検討します。CIや課題管理の接続先も変更します。
ステップ7 確認を終えてから利用を再開する
最終状態の照合、権限の許可・拒否、代表的な操作、外部連携を確認します。新環境のバックアップと復元方法も、利用再開前に準備しておきます。
確認結果を記録し、担当者が再開を判断します。旧環境への書き込みは禁止したまま、新環境での利用開始を周知します。
ステップ8 旧環境を保全してから廃止する
保存要件と保全期間に従って旧データを保管します。受け入れ確認が済み、必要な過去版と復旧手段を確保してから旧サーバーを廃止してください。不要になった認証情報や接続設定も整理します。
支援が必要な範囲を決める
社内で担当できる作業と、提供元へ依頼する作業を分けます。判断材料はリポジトリの規模だけでなく、許容停止時間、管理権限、外部連携、履歴の検証範囲です。
参考資料
確認日：2026年10月6日。 SVN Bookの参照先は1.7系列の説明です。実際の設定・操作は、使用中のバージョンと提供サービスの仕様も確認してください。
関連記事
この記事の著者
株式会社オープングルーヴ／tracpath編集部。バージョン管理サービスtracpathを提供。
