Wiki 拡張機能からチーム プロジェクト Wiki にページを移行する
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Wiki Marketplace 拡張機能を使用して作成されたページをチーム プロジェクト Wiki に移行する方法について説明します。 組み込みの Wiki のリリースでは、Wiki Marketplace 拡張機能を使用して作成されたすべての Wiki ページをチーム プロジェクトの Git リポジトリに保存できます。
前提条件
Wiki ページをチーム プロジェクト Wiki に移行するには、チーム プロジェクトの共同作成者グループのメンバーである必要があります。
ページとその他の成果物を移行する
- vsts-wikiTools リポジトリを複製し、MigrateToVSTSWiki ツールをコンパイルします。
- Azure DevOps Wiki を作成し、複製します。
- すべての Markdown ページを Azure DevOps Wiki に移動してコミットします。
- wiki 移行ツール を実行MigrateToVSTSWiki.exe
- Wiki 移行ツールが完了したら、Azure DevOps Wiki リポジトリの既定の メイン ブランチ
wikiMain
に変更をプッシュします。
詳細な手順
vsts-wikiTools リポジトリを複製し、MigrateToVSTSWiki ツールをコンパイルします。
パス
Tools/MigrateToVSTSWiki
の下にあるプロジェクトをコンパイルして、移行ツール EXE を生成します。Web ブラウザーから Azure DevOps チーム プロジェクトを開き、 最初の Wiki ページを作成します。
Wiki を複製する URL を取得します。 「Wiki を複製して Wiki ページをオフラインで編集する」を参照してください。
この複製の場所にこの手順の名前をLocationA
付けます。IDE または git clone コマンドを使用して Wiki リポジトリを 複製 します。
Wiki 拡張機能リポジトリを複製します。 Wiki は、Wiki の作成時に指定されたフォルダーにマップされます。 次の例に示すように、既存の Wiki の [wiki の管理] オプションに移動して確認できます。 既存の Wiki ページは、ラベル付けされたフォルダーの下に保存されます
Root
。たとえば、以前にメンションされた場所を複製した
sampleWiki
とします。C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki
この手順に従って、この場所に
LocationB
名前を付けます。ローカル コンピューター上の任意のパスに空のフォルダーを作成し、この手順に名前を付
LocationC
けます。要約すると、次の場所は次のように表されます。
- 場所 A = Azure DevOps Wiki リポジトリ
- 場所 B = Wiki 拡張機能リポジトリ
- 場所 C = 移行ツールを実行する空のフォルダー
管理者としてコマンド プロンプトを開き、実行
MigrateToVSTSWiki.exe
します。 このツールは、既存の Wiki から指定した宛先ディレクトリにファイルをコピーします。 コピー中に、ツールはページを Azure DevOps Wiki に準拠するように変換します。MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC
次に例を示します。
E:\wiki\sampleWiki\_extensionWiki
は、既存の Wiki ファイルが存在するフォルダーですE:\Temp\Wiki\New
は、移行されたファイルのコピー先となる空のフォルダーです。
Git 関連のファイル (
LocationA
存在する場合) からすべてのファイルを削除します (例.gitignore
: など)。すべてのファイル
LocationC
をコピーして貼り付けますLocationA
。コミット用に新しく追加されたすべてのファイル
LocationA
をステージングするために実行git add .
します。ローカルにステージングされたファイルをコミットするために実行
git commit -m <commit message>
します。Azure DevOps Wiki の既定のブランチに変更をプッシュするために実行
git push origin wikiMain -f
します。
Wiki 拡張機能ファイルを Azure DevOps Wiki に移行したら、Wiki 拡張機能をアンインストールする準備ができました。
関連記事
貢献
このプロジェクトでは、 Microsoft オープン ソースの行動規範が採用されました。 詳細については、行動規範に関する FAQ を参照するか、質問やコメントに問い合わせてください opencode@microsoft.com 。