Migración de páginas de la extensión wiki a una wiki de proyecto de equipo

  • Artículo

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

Aprenda a migrar páginas creadas mediante la extensión wiki de Marketplace a la wiki del proyecto de equipo. Con el lanzamiento de la wiki integrada, las páginas wiki creadas mediante la extensión de Wiki Marketplace se pueden guardar en un repositorio de Git en el proyecto de equipo.

Requisitos previos

Debe ser miembro del grupo Colaboradores del proyecto de equipo para migrar páginas wiki al wiki del proyecto de equipo.

Migración de páginas y otros artefactos

  1. Clone el repositorio vsts-wikiTools y compile la herramienta MigrateToVSTSWiki .
  2. Cree y clone la wiki de Azure DevOps.
  3. Mueva y confirme todas las páginas de Markdown a la wiki de Azure DevOps.
  4. Ejecución de la herramienta de migración wiki, MigrateToVSTSWiki.exe
  5. Una vez completada la herramienta de migración wiki, inserte los cambios en la rama principal predeterminada, wikiMain, del repositorio wiki de Azure DevOps.

Pasos detallados

  1. Clone el repositorio vsts-wikiTools y compile la herramienta MigrateToVSTSWiki .

  2. Compile el proyecto en la ruta de acceso Tools/MigrateToVSTSWiki para generar la herramienta de migración EXE.

  3. En un explorador web, abra el proyecto de equipo de Azure DevOps y cree la primera página wiki.

  4. Obtenga la dirección URL para clonar la wiki. Consulta Clonar la wiki y editar páginas wiki sin conexión.
    Asigne a este procedimiento el nombre de esta ubicación LocationA de clonación.

  5. Clone el repositorio wiki mediante el IDE o el comando git clone .

  6. Clone el repositorio de extensión wiki. La wiki se asigna a una carpeta que se le asigna durante la creación de la wiki. Puede confirmar si va a la opción administrar wiki en la wiki existente, como se muestra en el ejemplo siguiente. Las páginas wiki existentes se guardan en la carpeta etiquetada Root.

    Por ejemplo, ha clonado el elemento mencionado anteriormente sampleWiki en la ubicación. C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

    Asigne a este procedimiento el nombre de esta ubicación LocationB .

  7. Cree una carpeta vacía en cualquier ruta de acceso del equipo local y asígnela LocationC el nombre para este procedimiento.

    En resumen, las siguientes ubicaciones se representan de la siguiente manera:

    • Ubicación A = Repositorio wiki de Azure DevOps
    • Ubicación B = Repositorio de extensión wiki
    • Ubicación C = Carpeta vacía para ejecutar la herramienta de migración en

  8. Abra un símbolo del sistema como administrador y ejecute MigrateToVSTSWiki.exe. Esta herramienta copia los archivos de la wiki existente en el directorio de destino que proporcione. Durante la copia, la herramienta convierte las páginas para que sean compatibles con la wiki de Azure DevOps.

    MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

    Por ejemplo:

    • E:\wiki\sampleWiki\_extensionWiki es la carpeta en la que están presentes los archivos wiki existentes.
    • E:\Temp\Wiki\New es la carpeta vacía en la que se van a copiar los archivos migrados.

  9. Quite todos los archivos de (si los hubiera) aparte de LocationA los archivos relacionados con Git, como .gitignore, etc.

  10. Copie todos los archivos de LocationC y péguelos en LocationA.

  11. Ejecute git add . para almacenar provisionalmente todos los archivos recién agregados en LocationA para la confirmación.

  12. Ejecute git commit -m <commit message> para confirmar los archivos almacenados localmente provisionalmente.

  13. Ejecute git push origin wikiMain -f para insertar los cambios en la rama predeterminada de la wiki de Azure DevOps.

Después de migrar los archivos de extensión wiki a la wiki de Azure DevOps, está listo para desinstalar la extensión Wiki.

Contribuciones

Este proyecto adoptó el código de conducta de código abierto de Microsoft. Para obtener más información, consulte las preguntas más frecuentes sobre el código de conducta o póngase en contacto con opencode@microsoft.com cualquier pregunta o comentario.