Wiki 拡張機能からチーム プロジェクト Wiki にページを移行する

  • [アーティクル]

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Wiki Marketplace 拡張機能を使用して作成されたページをチーム プロジェクト Wiki に移行する方法について説明します。 組み込みの Wiki のリリースでは、Wiki Marketplace 拡張機能を使用して作成されたすべての Wiki ページをチーム プロジェクトの Git リポジトリに保存できます。

前提条件

Wiki ページをチーム プロジェクト Wiki に移行するには、チーム プロジェクトの共同作成者グループのメンバーである必要があります。

ページとその他の成果物を移行する

  1. vsts-wikiTools リポジトリを複製し、MigrateToVSTSWiki ツールをコンパイルします。
  2. Azure DevOps Wiki を作成し、複製します。
  3. すべての Markdown ページを Azure DevOps Wiki に移動してコミットします。
  4. wiki 移行ツール を実行MigrateToVSTSWiki.exe
  5. Wiki 移行ツールが完了したら、Azure DevOps Wiki リポジトリの既定の メイン ブランチwikiMainに変更をプッシュします。

詳細な手順

  1. vsts-wikiTools リポジトリを複製し、MigrateToVSTSWiki ツールをコンパイルします。

  2. パス Tools/MigrateToVSTSWiki の下にあるプロジェクトをコンパイルして、移行ツール EXE を生成します。

  3. Web ブラウザーから Azure DevOps チーム プロジェクトを開き、 最初の Wiki ページを作成します。

  4. Wiki を複製する URL を取得します。 「Wiki を複製して Wiki ページをオフラインで編集する」を参照してください。
    この複製の場所にこの手順の名前を LocationA 付けます。

  5. IDE または git clone コマンドを使用して Wiki リポジトリを 複製 します。

  6. Wiki 拡張機能リポジトリを複製します。 Wiki は、Wiki の作成時に指定されたフォルダーにマップされます。 次の例に示すように、既存の Wiki の [wiki の管理] オプションに移動して確認できます。 既存の Wiki ページは、ラベル付けされたフォルダーの下に保存されます Root。

    たとえば、以前にメンションされた場所を複製したsampleWikiとします。C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

    この手順に従って、この場所に LocationB 名前を付けます。

  7. ローカル コンピューター上の任意のパスに空のフォルダーを作成し、この手順に名前を付 LocationC けます。

    要約すると、次の場所は次のように表されます。

    • 場所 A = Azure DevOps Wiki リポジトリ
    • 場所 B = Wiki 拡張機能リポジトリ
    • 場所 C = 移行ツールを実行する空のフォルダー

  8. 管理者としてコマンド プロンプトを開き、実行 MigrateToVSTSWiki.exeします。 このツールは、既存の Wiki から指定した宛先ディレクトリにファイルをコピーします。 コピー中に、ツールはページを Azure DevOps Wiki に準拠するように変換します。

    MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

    次に例を示します。

    • E:\wiki\sampleWiki\_extensionWiki は、既存の Wiki ファイルが存在するフォルダーです
    • E:\Temp\Wiki\New は、移行されたファイルのコピー先となる空のフォルダーです。

  9. Git 関連のファイル ( LocationA 存在する場合) からすべてのファイルを削除します (例 .gitignore: など)。

  10. すべてのファイル LocationC をコピーして貼り付けます LocationA。

  11. コミット用に新しく追加されたすべてのファイルLocationAをステージングするために実行git add .します。

  12. ローカルにステージングされたファイルをコミットするために実行 git commit -m <commit message> します。

  13. Azure DevOps Wiki の既定のブランチに変更をプッシュするために実行git push origin wikiMain -fします。

Wiki 拡張機能ファイルを Azure DevOps Wiki に移行したら、Wiki 拡張機能をアンインストールする準備ができました。

貢献

このプロジェクトでは、 Microsoft オープン ソースの行動規範が採用されました。 詳細については、行動規範に関する FAQ を参照するか、質問やコメントに問い合わせてください opencode@microsoft.com 。