Freigeben über

Seiten von der Wiki-Erweiterung zu einer Team-Wikiseite migrieren

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Erfahren Sie, wie Sie mithilfe der Wiki Marketplace- Erweiterung erstellte Seiten zu Ihrem Teamprojektwiki migrieren. Mit der Veröffentlichung des integrierten Wikis können alle wiki-Seiten, die mit der Wiki Marketplace-Erweiterung erstellt wurden, in einem Git-Repository in Ihrem Teamprojekt gespeichert werden.

Voraussetzungen

Um Wiki-Seiten in Ihr Teamprojektwiki zu migrieren, müssen Sie Mitglied der Mitwirkenden-Gruppe Ihres Teamprojekts sein.

Migrieren von Seiten und anderen Artefakten

  1. Klonen Sie das Repository vsts-wikiTools und kompilieren Sie das Tool MigrateToVSTSWiki.
  2. Erstellen Sie ihr Azure DevOps-Wiki, und klonen Sie es dann.
  3. Verschieben und übertragen Sie alle Markdown-Seiten in Ihr Azure DevOps Wiki.
  4. Führen Sie das Wiki-Migrationstool MigrateToVSTSWiki.exe aus
  5. Wenn das Tool zur Migration des Wikis fertig ist, pushen Sie die Änderungen in den Standard-Hauptzweig wikiMain des Azure DevOps Wiki-Repositorys.

Detaillierte Schritte

  1. Klonen Sie das vsts-wikiTools Repository und kompilieren Sie das MigrateToVSTSWiki Tool.

  2. Kompilieren Sie das Projekt unter dem Pfad Tools/MigrateToVSTSWiki, um das Migrationstool EXE zu generieren.

  3. Öffnen Sie in einem Webbrowser Ihr Azure DevOps Team-Projekt und erstellen Sie Ihre erste Wiki-Seite.

  4. Rufen Sie die URL ab, um Ihr Wiki zu klonen. Siehe Klonen Sie Ihr Wiki und bearbeiten Sie Wiki-Seiten offline.
    Benennen Sie diesen Speicherort des Klons für dieses Verfahren mit LocationA.

  5. Klonen Sie Ihr Wiki-Repository mit Ihrer IDE oder dem Git Clone Befehl.

  6. Klonen Sie das Wiki-Erweiterungs-Repo. Das Wiki wird einem Ordner zugeordnet, der Ihnen während der Wiki-Erstellung zugewiesen wird. Sie können dies bestätigen, indem Sie die Option Wiki verwalten im bestehenden Wiki aufrufen, wie im folgenden Beispiel gezeigt. Ihre vorhandenen Wiki-Seiten werden unter dem Ordner mit der Bezeichnung Rootgespeichert.

    Sie haben zum Beispiel das zuvor erwähnte sampleWiki in den Speicherort C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki geklont

    Benennen Sie diesen Speicherort als LocationB für dieses Verfahren.

  7. Erstellen Sie einen leeren Ordner in einem beliebigen Pfad auf Ihrem lokalen Computer, und nennen Sie ihn LocationC für dieses Verfahren.

    Zusammenfassend werden die folgenden Orte wie folgt dargestellt:

    • Speicherort A = Azure DevOps Wiki-Repo
    • Speicherort B = Wiki-Erweiterungs-Repo
    • Speicherort C = Leerer Ordner zum Ausführen des Migrationstools in

  8. Öffnen Sie eine Eingabeaufforderung als Administrator und führen Sie MigrateToVSTSWiki.exe aus. Dieses Tool kopiert die Dateien aus Ihrem vorhandenen Wiki in das von Ihnen bereitgestellte Zielverzeichnis. Beim Kopieren konvertiert das Tool die Seiten so, dass sie mit dem Azure DevOps-Wiki kompatibel sind.

    MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

    Zum Beispiel:

    • E:\wiki\sampleWiki\_extensionWiki ist der Ordner, in dem die vorhandenen Wiki-Dateien vorhanden sind.
    • E:\Temp\Wiki\New ist der leere Ordner, in den die migrierten Dateien kopiert werden sollen.

  9. Entfernen Sie alle Dateien aus LocationA (falls vorhanden) abgesehen von den Git-bezogenen Dateien, z. B. .gitignoreusw.

  10. Kopieren Sie alle Dateien aus LocationC, und fügen Sie sie in LocationAein.

  11. Führen Sie git add . aus, um alle neu hinzugefügten Dateien in LocationA für die Übertragung bereitzustellen.

  12. Führen Sie git commit -m <commit message> aus, um die lokal bereitgestellten Dateien zu übertragen.

  13. Führen Sie git push origin wikiMain -f aus, um die Änderungen an den Standardzweig des Azure DevOps-Wikis zu übertragen.

Nachdem Sie Ihre Wiki-Erweiterungsdateien zum Azure DevOps-Wiki migriert haben, können Sie die Wiki-Erweiterung deinstallieren.

Beiträge

Dieses Projekt hat den Microsoft Open Source Code of Conductangenommen. Weitere Informationen finden Sie im Code of Conduct FAQ oder wenden Sie sich an opencode@microsoft.com mit Fragen oder Kommentaren.