移行の前提条件を満たす

Azure DevOps データ移行ツールを使用して Azure DevOps Services に移行する 2 番目のフェーズに進むには、データをクラウドに転送するための前提条件を満たす必要があります。 組織が既にこれらの前提条件を満たしている場合は、このフェーズを完全にスキップできます。

順次ステージの前提条件ステージを強調表示した図。

Azure DevOps Server を更新する

Azure DevOps 用データ移行ツールでは、特定の時点での Azure DevOps Server の 2 つの最新リリースがサポートされています。 リリースには、更新プログラムとメジャー リリースが含まれます。

Azure DevOps Server の新しい RTW バージョンがリリースされてから、そのバージョンの移行サポートがオンラインになるまでに最大 2 ~ 3 週間かかることがあります。 新しい RTW Azure DevOps Server リリースの直後にアップグレードすることを選択する場合は、この可能性を考慮してください。

データ移行ツールでは、Azure DevOps Server リリース候補 (RC) からの移行はサポートされていません。 このサービスを使用してコレクション データベースを Azure DevOps Services に移行する予定の場合は、実稼働データベースを RC リリースにアップグレードしないようにすることが重要です。 アップグレードする場合は、リリースから Web (RTW) バージョンが利用可能になるまで待ってからアップグレードする必要があります。 または、以前のバージョンの Azure DevOps Server からデータベースのバックアップ コピーを復元して移行します。 以前のバージョンの Azure DevOps にダウングレードすることはできませんが、そのバージョンのデータベースのバックアップを使用して元に戻す必要があります。

新しい Azure DevOps Server バージョンの通常のリリース周期は、3 ~ 4 か月に 1 回です。 つまり、Azure DevOps Servicesへの移行に対する特定のバージョンのAzure DevOps Serverのサポートは、6 か月から 8 か月間続く必要があります。 移行に突然アップグレードする必要がないように、プランがこのサポート期間に対応していることを確認することが重要です。

Microsoft Entra ID を実装する

チームに、Azure DevOps Services 組織のメンバーを認証するための機能的な Microsoft Entra ID テナントがあることを確認します。 Azure DevOps Services では、ユーザー認証は、Azure DevOps Server ユーザー認証が Active Directory に依存するような Microsoft Entra ID テナントに依存します。 テスト実行フェーズ (リンク) では、オンプレミスの Active Directory組織と Microsoft Entra ID 組織と一致するように ID マップ ログ ファイルを確認します。 このファイルは、移行サービスでは使用されません。 このアクションにより、個々の履歴の可視性、セキュリティアクセス許可の保持、個人設定へのアクセスが保証されます。

ヒント

  • 他の Microsoft Cloud サービスと同じ Microsoft Entra ID テナントを使用することをお勧めします。 会社に既に Microsoft Entra ID がある場合は、この手順をスキップします。
  • Microsoft アカウント (MSA) は Azure DevOps Services 認証で機能しますが、Azure DevOps Server データベースの移行中にマップすることはできません。

ID とグループを Microsoft Entra ID Connect と同期する

チーム メンバーが同じ資格情報を使用して認証できるように、オンプレミスの Active Directoryを Microsoft Entra ID と同期します。 また、Azure DevOps Services 管理者は、Active Directory グループを使用して組織内のアクセス許可を設定できます。

同期を設定するには、次の手順を実行します。

  1. Microsoft Entra ID Connect テクノロジを利用します。
  2. オンプレミス環境で Microsoft Entra ID Connect を構成するには、IT 部門、DevOps パートナー、Microsoft Premier サポート、または Microsoft コンサルティング サービスと共同作業を行います。

Microsoft Entra ID Connect の設定の詳細については、「Microsoft Entra Connect Sync」を参照してください

また、このページにアクセスして、Microsoft Entra ID を使用するように Azure DevOps Services を構成する方法についても説明します。 この記事の手順は Team Foundation Server データベースの移行と正確には一致しませんが、重要な参照情報として機能します。 データ移行ツールは、移行プロセスの開始時に Azure DevOps Services 組織の作成時に Microsoft Entra ID テナントへのリンクを確立します。

Note

DirSync は、Microsoft Entra ID Connect の先行技術でした。 DirSync を使用している場合は、Microsoft Entra ID Connect にアップグレードします。

Azure DevOps データ移行ツールのダウンロード

Azure DevOps Services への移行全体の作業の大部分は、データ移行ツールによって処理されます。 ツールは、次の大まかな手順で使用されます。

  1. チーム プロジェクト コレクションを検証します。
  2. 移行のカスタマイズに使用するファイルを生成します。
  3. Azure DevOps Server データベースから Azure DevOps Services へのキュー移行。

次の項目が必要です。

  • SQL Server での TF Standard Edition XECROLE ロール。
  • Azure DevOps Server 構成データベースとコレクション データベースの両方に接続するためのアクセス許可。
  • Azure DevOps Services 組織と Microsoft Entra ID テナントの間に確立されたリンク。

ツールをダウンロードする

  1. 最新バージョンのデータ移行ツールを ダウンロードします。
  2. zip ファイルを Azure DevOps Server アプリケーション層のいずれかにコピーします。
  3. ファイルを解凍します。 Azure DevOps Server インスタンスの構成データベースに接続できる場合は、Azure DevOps Server がインストールされていない別のコンピューターからツールを実行することもできます。 1.サーバーでコマンド プロンプト ウィンドウを開き、データ移行ツールが格納されているディレクトリに移動します。
  4. ツールのヘルプ コンテンツを確認します。
    1. 最上位のヘルプとガイダンスを表示するには、次のコマンドを実行します。
      Migrator /help
    2. 検証コマンドのヘルプ テキストを表示します。Migrator validate /help コレクションを初めて検証する場合は、単純にしてください。 コマンドの構造は次のとおりです。 Migrator validate /collection:{collection URL} /tenantDomainName:{name} /region:{region}
  5. {name} を Microsoft Entra テナントの名前に置き換えます。 たとえば、DefaultCollection と fabrikam テナントに対して実行する場合、コマンドは次のようになります。Migrator validate /collection:[^1^][4] (http://localhost:8080/DefaultCollection) /tenantDomainName:fabrikam.OnMicrosoft.com /region:{region} Azure DevOps Server 以外のコンピューターからツールを実行する必要がある場合は、パラメーターを /connectionString 使用します。

次のステップ