Eseguire la migrazione di pagine dall'estensione wiki a un wiki del progetto team
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Informazioni su come eseguire la migrazione delle pagine create usando l'estensione Wiki Marketplace al wiki del progetto team. Con il rilascio del wiki predefinito, tutte le pagine wiki create usando l'estensione Wiki Marketplace possono essere salvate in un repository Git nel progetto team.
Prerequisiti
È necessario essere membri del gruppo Collaboratori del progetto team per eseguire la migrazione delle pagine wiki al wiki del progetto team.
Eseguire la migrazione di pagine e altri artefatti
- Clonare il repository vsts-wikiTools e compilare lo strumento MigrateToVSTSWiki .
- Creare e quindi clonare il wiki di Azure DevOps.
- Spostare ed eseguire il commit di tutte le pagine Markdown nel wiki di Azure DevOps.
- Eseguire lo strumento di migrazione wiki MigrateToVSTSWiki.exe
- Al termine dello strumento di migrazione wiki, eseguire il push delle modifiche nel ramo principale predefinito,
wikiMain
, del repository wiki di Azure DevOps.
Procedura dettagliata
Clonare il repository vsts-wikiTools e compilare lo strumento MigrateToVSTSWiki .
Compilare il progetto nel percorso
Tools/MigrateToVSTSWiki
per generare l'EXE dello strumento di migrazione.Da un Web browser aprire il progetto team di Azure DevOps e creare la prima pagina wiki.
Ottenere l'URL per clonare il wiki. Vedi Clonare il wiki e modificare le pagine wiki offline.
Denominare questo percorso di clonazione comeLocationA
per questa procedura.Clonare il repository wiki usando l'IDE o il comando git clone .
Clonare il repository dell'estensione wiki. Il wiki viene mappato a una cartella specificata durante la creazione del wiki. Per confermare, passare all'opzione gestisci wiki nel wiki esistente, come illustrato nell'esempio seguente. Le pagine wiki esistenti vengono salvate nella cartella con etichetta
Root
.Ad esempio, è stato clonato l'oggetto indicato
sampleWiki
in precedenza nella posizioneC:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki
Denominare questo percorso come
LocationB
per questa procedura.Creare una cartella vuota in qualsiasi percorso nel computer locale e denominarla
LocationC
per questa procedura.In sintesi, le posizioni seguenti sono rappresentate nel modo seguente:
- Posizione A = Repository wiki di Azure DevOps
- Location B = Repository dell'estensione Wiki
- Percorso C = Cartella vuota in cui eseguire lo strumento di migrazione
Aprire un prompt dei comandi come amministratore ed eseguire
MigrateToVSTSWiki.exe
. Questo strumento copia i file dal wiki esistente alla directory di destinazione specificata. Durante la copia, lo strumento converte le pagine in modo che siano conformi al wiki di Azure DevOps.MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC
Ad esempio:
E:\wiki\sampleWiki\_extensionWiki
è la cartella in cui sono presenti i file wiki esistentiE:\Temp\Wiki\New
è la cartella vuota in cui devono essere copiati i file migrati.
Rimuovere tutti i file da
LocationA
(se presenti) a parte i file correlati a Git, ad esempio.gitignore
e così via.Copiare tutti i file da
LocationC
e incollarli inLocationA
.Eseguire
git add .
per preparare tutti i file appena aggiunti inLocationA
per il commit.Eseguire
git commit -m <commit message>
per eseguire il commit dei file di gestione temporanea in locale.Eseguire
git push origin wikiMain -f
per eseguire il push delle modifiche nel ramo predefinito del wiki di Azure DevOps.
Dopo aver migrato i file di estensione wiki nel wiki di Azure DevOps, è possibile disinstallare l'estensione Wiki.
Articoli correlati
- Convenzioni di denominazione del titolo della pagina wiki
- Clonare e aggiornare le pagine wiki offline
- Codice sorgente per gli strumenti wiki
- Guida introduttiva a Git
Contributi
Questo progetto ha adottato il codice di comportamento microsoft open source. Per altre informazioni, vedere domande frequenti sul codice di condotta o contattare opencode@microsoft.com eventuali domande o commenti.
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per