Migrar páginas da extensão wiki para um wiki de projeto de equipe

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

Migre páginas criadas com a extensão do Wiki Marketplace para o wiki do projeto de equipe. Você pode salvar todas as páginas wiki criadas com a extensão do Wiki Marketplace em um repositório Git em seu projeto de equipe.

Pré-requisitos

Visão geral da migração de páginas e outros artefatos

1. Clone o repositório vsts-wikiTools e compile a ferramenta MigrateToVSTSWiki.
2. Crie o wiki do Azure DevOps e, em seguida, clone-o.
3. Mova e confirme todas as páginas do Markdown no wiki do Azure DevOps.
4. Execute a ferramenta de migração wiki, MigrateToVSTSWiki.exe.
5. Quando a ferramenta de migração wiki for concluída, envie por push as alterações para a ramificação padrão principal, wikiMain, do repositório wiki do Azure DevOps.

Migrar páginas da extensão wiki

1. Clone o repositório vsts-wikiTools e compile a ferramenta MigrateToVSTSWiki.

2. Para gerar o EXE da ferramenta de migração, compile o projeto no caminho Tools/MigrateToVSTSWiki.

3. Em um navegador da Web, abra seu projeto de equipe do Azure DevOps e crie sua primeira página wiki.

4. Para clonar seu wiki, obtenha o URL. Para obter mais informações, consulte Clonar seu wiki e editar páginas wiki offline. Nomeie esta localização do clone como LocationA neste procedimento.

5. Clone seu repositório wiki usando seu IDE ou o comando git clone.

6. Clonar o repositório da extensão do wiki. O wiki é mapeado para uma pasta fornecida a você durante a criação do wiki. Você pode confirmar acessando a opção gerenciar wiki no wiki existente, como mostrado no exemplo a seguir. Suas páginas wiki existentes são salvas na pasta rotulada Root.

   Por exemplo, você clonou o sampleWiki mencionado anteriormente no local C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

   Nomeie esse local como LocationB para este procedimento.

7. Crie uma pasta vazia em qualquer caminho da sua máquina local e nomeie-a como LocationC para este procedimento.

   Em resumo, os seguintes locais são representados da seguinte forma:

   • Local A = Repositório do Wiki do Azure DevOps
   • Local B = Repositório de extensão do Wiki
   • Localização C = Pasta vazia para executar a ferramenta de migração em

8. Abra uma prompt de comando como administrador e execute MigrateToVSTSWiki.exe. Esta ferramenta copia os arquivos do seu wiki existente para o diretório de destino fornecido. Durante a cópia, a ferramenta converte as páginas para que fiquem em conformidade com o wiki do Azure DevOps.

   MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

   Por exemplo:

   • E:\wiki\sampleWiki\_extensionWiki é a pasta na qual os arquivos wiki existentes estão presentes
   • E:\Temp\Wiki\New é a pasta vazia para a qual os arquivos migrados devem ser copiados.

9. Remova todos os arquivos de LocationA (se houver) além dos arquivos relacionados ao Git, como .gitignore e assim por diante.

10. Copie todos os arquivos de LocationC e cole-os em LocationA.

11. Execute git add . para organizar todos os arquivos recém-adicionados em LocationA para a confirmação.

12. Executar git commit -m <commit message> para confirmar os arquivos preparados localmente.

13. Executar git push origin wikiMain -f para fazer push das alterações para a ramificação padrão do wiki do Azure DevOps.

Depois de migrar seus arquivos de extensão wiki para o Azure DevOps Wiki, você estará pronto para desinstalar a extensão Wiki.

Próxima etapa

Conteúdo relacionado

• Convenções de nomenclatura de títulos de páginas do Wiki
• Clonar e atualizar páginas wiki offline
• Código-fonte das ferramentas wiki
• Início rápido do Git

Contribuições

Este projeto adotou o Código de Conduta de Software Livre da Microsoft. Para saber mais, confira as Perguntas frequentes sobre o Código de Conduta ou entre em contato com opencode@microsoft.com para enviar perguntas ou comentários.