Migrieren von Seiten aus der Wiki-Erweiterung zu einem Teamprojektwiki

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Migrieren Sie Seiten, die mit der Wiki Marketplace-Erweiterung erstellt wurden, zu Ihrem Teamprojektwiki. Sie können alle wiki-Seiten speichern, die mit der Wiki Marketplace-Erweiterung erstellt wurden, in einem Git-Repository in Ihrem Teamprojekt.

Hinweis

Die Wiki Marketplace-Erweiterung ist veraltet. Deinstallieren Sie sie , nachdem Sie Ihre Seiten migriert haben.

Voraussetzungen

Kategorie Anforderungen
Projektzugriff Mitglied des Projekts, in dem sich das Wiki befindet. Wenn Sie keinen Zugriff haben, fordern Sie ihn von Ihrem Projektadministrator an.
Erlaubnisse Mitglied der Gruppe Mitwirkende.
Zugriffsebenen Mindestens Grundlegender Zugriff.

Übersicht über das Migrieren von Seiten und anderen Artefakten

  1. Klonen Sie das vsts-wikiTools-Repository , und kompilieren Sie das MigrateToVSTSWiki-Tool .
  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.exeaus.
  5. Wenn das Tool zur Migration des Wikis fertig ist, pushen Sie die Änderungen in den Standard-Hauptzweig wikiMain des Azure DevOps Wiki-Repositorys.

Migrieren von Seiten aus der Wiki-Erweiterung

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

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

  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. Weitere Informationen finden Sie unter Klonen Ihres Wikis und Offlinebearbeitung von Wiki-Seiten. 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.

Nächster Schritt

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.