Udostępnij za pośrednictwem

Migrowanie stron z rozszerzenia wiki do witryny typu wiki projektu zespołowego

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Dowiedz się, jak migrować strony utworzone przy użyciu rozszerzenia witryny Wiki Marketplace do witryny typu wiki projektu zespołowego. Wraz z wydaniem wbudowanej witryny typu wiki wszystkie strony typu wiki utworzone przy użyciu rozszerzenia witryny Wiki Marketplace można zapisać w repozytorium Git w projekcie zespołowym.

Wymagania wstępne

Musisz być członkiem grupy Współautorzy projektu zespołowego, aby migrować strony typu wiki do witryny typu wiki projektu zespołowego.

Migrowanie stron i innych artefaktów

  1. Sklonuj repozytorium vsts-wikiTools i skompiluj narzędzie MigrateToVSTSWiki .
  2. Utwórz witrynę typu wiki usługi Azure DevOps, a następnie sklonuj witrynę typu wiki usługi Azure DevOps.
  3. Przenieś i zatwierdź wszystkie strony markdown do witryny typu wiki usługi Azure DevOps.
  4. Uruchom narzędzie do migracji typu wiki, MigrateToVSTSWiki.exe
  5. Po zakończeniu narzędzia do migracji typu wiki wypchnij zmiany do domyślnej gałęzi głównej , wikiMainrepozytorium wiki usługi Azure DevOps.

Szczegółowe procedury

  1. Sklonuj repozytorium vsts-wikiTools i skompiluj narzędzie MigrateToVSTSWiki .

  2. Skompiluj projekt pod ścieżką Tools/MigrateToVSTSWiki , aby wygenerować plik EXE narzędzia do migracji.

  3. W przeglądarce internetowej otwórz projekt zespołu usługi Azure DevOps i utwórz pierwszą stronę typu wiki.

  4. Pobierz adres URL, aby sklonować witrynę typu wiki. Zobacz Klonowanie strony typu wiki i edytowanie stron typu wiki w trybie offline.
    Nadaj tej lokalizacji klonowania LocationA nazwę dla tej procedury.

  5. Sklonuj repozytorium wiki przy użyciu środowiska IDE lub polecenia git clone .

  6. Sklonuj repozytorium rozszerzenia wiki. Witryna typu wiki jest mapowana na folder podany podczas tworzenia witryny typu wiki. Możesz potwierdzić, przechodząc do opcji zarządzania witryną typu wiki w istniejącej witrynie typu wiki, jak pokazano w poniższym przykładzie. Istniejące strony typu wiki są zapisywane w folderze oznaczonym etykietą Root.

    Na przykład sklonowane wcześniej wymienione sampleWiki w lokalizacji C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

    Nadaj tej lokalizacji nazwę w LocationB tej procedurze.

  7. Utwórz pusty folder w dowolnej ścieżce na komputerze lokalnym i nadaj mu LocationC nazwę dla tej procedury.

    Podsumowując, następujące lokalizacje są reprezentowane w następujący sposób:

    • Lokalizacja A = repozytorium wiki usługi Azure DevOps
    • Lokalizacja B = repozytorium rozszerzenia wiki
    • Lokalizacja C = Pusty folder do uruchamiania narzędzia migracji w programie

  8. Otwórz wiersz polecenia jako administrator i uruchom polecenie MigrateToVSTSWiki.exe. To narzędzie kopiuje pliki z istniejącej witryny typu wiki do podanego katalogu docelowego. Podczas kopiowania narzędzie konwertuje strony na zgodne ze witryną typu wiki usługi Azure DevOps.

    MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

    Na przykład:

    • E:\wiki\sampleWiki\_extensionWiki to folder, w którym znajdują się istniejące pliki typu wiki
    • E:\Temp\Wiki\New to pusty folder, do którego mają zostać skopiowane zmigrowane pliki.

  9. Usuń wszystkie pliki z LocationA (jeśli istnieją) poza plikami powiązanymi z usługą Git, takimi jak .gitignore, itd.

  10. Skopiuj wszystkie pliki z LocationC pliku i wklej je do pliku LocationA.

  11. Uruchom polecenie , git add . aby przygotować wszystkie nowo dodane pliki LocationA do zatwierdzenia.

  12. Uruchom polecenie git commit -m <commit message> , aby zatwierdzić pliki przygotowane lokalnie.

  13. Uruchom polecenie git push origin wikiMain -f , aby wypchnąć zmiany do domyślnej gałęzi wiki usługi Azure DevOps.

Po przeprowadzeniu migracji plików rozszerzeń typu wiki do witryny typu wiki usługi Azure DevOps możesz odinstalować rozszerzenie wiki.

Udziały

W tym projekcie przyjęto kodeks postępowania firmy Microsoft typu open source. Aby uzyskać więcej informacji, zobacz Często zadawane pytania dotyczące kodeksu postępowania lub skontaktuj się z opencode@microsoft.com wszelkimi pytaniami lub komentarzami.