cloud-migrator

OneDrive を転送元として、SharePoint Online または Dropbox へファイルを移行する .NET 10 CLI ツールです。

現在のステータス

• 最新バージョン: 0.3.0
• 配布方式: GitHub Releases（MSI インストーラー / Windows ZIP / Linux・macOS tar.gz）
• 実運用実績: OneDrive -> Dropbox 大容量転送フローは検証済み
• 実装状況: SharePoint 向け基本機能は実装済み、最適化フェーズは継続中

主な機能

• 転送先切り替え: destinationProvider で sharepoint / dropbox を選択
• Dropbox 最適化パイプライン:
  • SQLite 状態管理（再開・再試行・チェックポイント）
  • bounded channel + Parallel.ForEachAsync による並列実行
  • status / dashboard による進捗可視化
• Graph/OneDrive 連携:
  • 4MB 未満は単純アップロード
  • 4MB 以上は LargeFileUploadTask によるチャンク転送
  • oneDriveSourceFolder 指定によるサブフォルダ起点クロール
• 運用補助:
  • watchdog によるフリーズ検知・再起動
  • file-crawler によるクロール比較/検証
  • quality-metrics / security-scan による品質チェック

アーキテクチャ

src/
  CloudMigrator.Cli/                    CLI エントリーポイント
  CloudMigrator.Setup.Cli/              初期設定支援CLI（bootstrap/doctor/init/verify）
  CloudMigrator.Core/                   ドメイン・ユースケース
  CloudMigrator.Providers.Abstractions/ IStorageProvider 契約
  CloudMigrator.Providers.Graph/        Microsoft Graph 実装
  CloudMigrator.Providers.Dropbox/      Dropbox 実装
  CloudMigrator.Dashboard/              Webダッシュボード
  CloudMigrator.Observability/          構造化ログ
  CloudMigrator.Testing/                テスト共通ユーティリティ
tests/
  unit/ integration/ e2e/

前提条件

• .NET 10 SDK
• PowerShell 5.1 以上（Windows PowerShell 5.1 / PowerShell 7+。tools/Get-DropboxToken.ps1 を使う場合）
• セットアップCLI（setup bootstrap / setup init）で生成される %APPDATA%\CloudMigrator\configs\config.json と環境変数

設定優先順位は以下です。

1. 環境変数
2. configs/config.json
3. 既定値

クイックスタート（Dropbox 転送）

GitHub Releases から最新版をインストール後、以下の手順で転送を開始できます。 詳細なインストール手順は usage.md を参照してください。

1. セットアップウィザードを実行

cloud-migrator setup bootstrap --destination dropbox

2. 接続検証

cloud-migrator setup doctor
cloud-migrator setup verify --skip-sharepoint

3. 転送開始

cloud-migrator transfer

4. 進捗確認

cloud-migrator status
cloud-migrator dashboard

ソースからビルドして実行する場合は、各コマンド先頭を dotnet run --project src/CloudMigrator.Cli -- に置き換えてください。たとえば cloud-migrator setup doctor は dotnet run --project src/CloudMigrator.Cli -- setup doctor です。

主要コマンド

CloudMigrator.Cli

• transfer:
  • destinationProvider=dropbox なら Dropbox パイプラインで転送
  • それ以外は SharePoint パイプラインで転送
• status: Dropbox 転送 DB から進捗ダッシュボードを表示
• dashboard: Web UI で転送メトリクスを表示
• rebuild-skiplist: SharePoint の skip_list を再構築（転送なし）
• watchdog: transfer の自動監視・再起動
• file-crawler: クロール/比較/検証補助
• quality-metrics: テストとカバレッジの集計
• security-scan: NuGet 脆弱性スキャン

CloudMigrator.Setup.Cli

• bootstrap: 対話型セットアップ
• doctor: 設定の妥当性診断
• init: config.json / .env テンプレート生成
• verify: Graph/Dropbox 疎通確認

詳細オプションは usage.md を参照してください。

設定のポイント

• 機密情報は環境変数のみで管理
  • MIGRATOR__GRAPH__CLIENTSECRET
  • MIGRATOR__DROPBOX__CLIENTSECRET
• destinationProvider の既定は sharepoint
• Dropbox 長時間運用では以下を推奨
  • MIGRATOR__DROPBOX__REFRESHTOKEN
  • MIGRATOR__DROPBOX__CLIENTID
  • MIGRATOR__DROPBOX__CLIENTSECRET

サンプルは sample.env を参照してください。config.json は setup init コマンドで %APPDATA%\CloudMigrator\configs\config.json に生成されます。

ビルド・テスト

dotnet build CloudMigrator.slnx
dotnet test tests/unit/CloudMigrator.Tests.Unit.csproj
dotnet test tests/integration/CloudMigrator.Tests.Integration.csproj

ドキュメント

• usage.md: コマンド詳細と運用フロー
• docs/architecture.md: モジュール構成と実行時アーキテクチャ
• docs/architecture/ai-implementation-guardrails.md: AI 実装時の MVVM / provider / route 境界ガードレール
• docs/dataflow.md: 設定、状態 DB、転送、可観測性のデータフロー
• docs/manual-test-runbook.md: 手動テスト手順
• docs/implementation-plan.md: 実装計画
• tasks.md: 現在の進捗
• CHANGELOG.md: 変更履歴

ライセンス

LICENSE を参照してください。