Partager via

Migrer des pages de l’extension wiki vers un wiki de projet d’équipe

  • Article

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

Découvrez comment migrer des pages créées à l’aide de l’extension De la Place de marché Wiki vers le wiki de votre projet d’équipe. Avec la publication du wiki intégré, toutes les pages wiki créées à l’aide de l’extension Wiki Marketplace peuvent être enregistrées dans un dépôt Git dans votre projet d’équipe.

Prérequis

Vous devez être membre du groupe Contributeurs de votre projet d’équipe pour migrer des pages wiki vers le wiki de votre projet d’équipe.

Migrer des pages et d’autres artefacts

  1. Clonez le référentiel vsts-wikiTools et compilez l’outil MigrateToVSTSWiki .
  2. Créez, puis clonez votre wiki Azure DevOps.
  3. Déplacez et validez toutes les pages Markdown dans votre wiki Azure DevOps.
  4. Exécuter l’outil de migration wiki, MigrateToVSTSWiki.exe
  5. Une fois l’outil de migration wiki terminé, envoyez les modifications à la branche principale par défaut, wikiMaindu référentiel wiki Azure DevOps.

Procédure détaillée

  1. Clonez le référentiel vsts-wikiTools et compilez l’outil MigrateToVSTSWiki .

  2. Compilez le projet sous le chemin d’accès Tools/MigrateToVSTSWiki pour générer l’outil de migration EXE.

  3. À partir d’un navigateur web, ouvrez votre projet d’équipe Azure DevOps et créez votre première page wiki.

  4. Obtenez l’URL pour cloner votre wiki. Consultez Cloner votre wiki et modifier les pages wiki hors connexion.
    Nommez cet emplacement clone comme LocationA pour cette procédure.

  5. Clonez votre dépôt wiki à l’aide de votre IDE ou de la commande git clone .

  6. Clonez le dépôt d’extension wiki. Le wiki est mappé à un dossier donné à vous lors de la création du wiki. Vous pouvez confirmer en accédant à l’option gérer le wiki dans le wiki existant, comme illustré dans l’exemple suivant. Vos pages wiki existantes sont enregistrées sous le dossier étiqueté Root.

    Par exemple, vous avez cloné le précédemment mentionné sampleWiki à l’emplacement C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

    Nommez cet emplacement comme LocationB pour cette procédure.

  7. Créez un dossier vide dans n’importe quel chemin d’accès sur votre ordinateur local et nommez-le LocationC pour cette procédure.

    En résumé, les emplacements suivants sont représentés comme suit :

    • Emplacement A = Dépôt Wiki Azure DevOps
    • Emplacement B = Dépôt d’extension Wiki
    • Emplacement C = Dossier vide dans lequel exécuter l’outil de migration

  8. Ouvrez une invite de commandes en tant qu’administrateur et exécutez MigrateToVSTSWiki.exe. Cet outil copie les fichiers de votre wiki existant vers le répertoire de destination que vous fournissez. Lors de la copie, l’outil convertit les pages en conformité avec le wiki Azure DevOps.

    MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

    Par exemple :

    • E:\wiki\sampleWiki\_extensionWiki est le dossier dans lequel les fichiers wiki existants sont présents
    • E:\Temp\Wiki\New est le dossier vide dans lequel les fichiers migrés doivent être copiés.

  9. Supprimez tous les fichiers de LocationA (le cas échéant) en dehors des fichiers liés à Git, tels que .gitignore, etc.

  10. Copiez tous les fichiers à partir de LocationC et collez-les dans LocationA.

  11. Exécutez git add . pour mettre en LocationA scène tous les fichiers nouvellement ajoutés pour la validation.

  12. Exécutez pour git commit -m <commit message> valider les fichiers intermédiaires localement.

  13. Exécutez git push origin wikiMain -f pour envoyer (push) les modifications au branche par défaut du wiki Azure DevOps.

Après avoir migré vos fichiers d’extension wiki vers le Wiki Azure DevOps, vous êtes prêt à désinstaller l’extension Wiki.

Contributions

Ce projet a adopté le Code de conduite Open Source Microsoft. Pour plus d’informations, consultez le FORUM aux questions ou commentaires opencode@microsoft.com du Code de conduite.