Eseguire la migrazione di pagine dall'estensione wiki a un wiki del progetto team

  • Articolo

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

  1. Clonare il repository vsts-wikiTools e compilare lo strumento MigrateToVSTSWiki .
  2. Creare e quindi clonare il wiki di Azure DevOps.
  3. Spostare ed eseguire il commit di tutte le pagine Markdown nel wiki di Azure DevOps.
  4. Eseguire lo strumento di migrazione wiki MigrateToVSTSWiki.exe
  5. 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

  1. Clonare il repository vsts-wikiTools e compilare lo strumento MigrateToVSTSWiki .

  2. Compilare il progetto nel percorso Tools/MigrateToVSTSWiki per generare l'EXE dello strumento di migrazione.

  3. Da un Web browser aprire il progetto team di Azure DevOps e creare la prima pagina wiki.

  4. Ottenere l'URL per clonare il wiki. Vedi Clonare il wiki e modificare le pagine wiki offline.
    Denominare questo percorso di clonazione come LocationA per questa procedura.

  5. Clonare il repository wiki usando l'IDE o il comando git clone .

  6. 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 posizione C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

    Denominare questo percorso come LocationB per questa procedura.

  7. 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

  8. 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 esistenti
    • E:\Temp\Wiki\New è la cartella vuota in cui devono essere copiati i file migrati.

  9. Rimuovere tutti i file da LocationA (se presenti) a parte i file correlati a Git, ad esempio .gitignoree così via.

  10. Copiare tutti i file da LocationC e incollarli in LocationA.

  11. Eseguire git add . per preparare tutti i file appena aggiunti in LocationA per il commit.

  12. Eseguire git commit -m <commit message> per eseguire il commit dei file di gestione temporanea in locale.

  13. 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.

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.