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

  • Artigo

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

Saiba como migrar páginas criadas usando a extensão Wiki Marketplace para o wiki do seu projeto de equipe. Com o lançamento do wiki embutido, qualquer página wiki criada usando a extensão Wiki Marketplace pode ser salva em um repositório Git em seu projeto de equipe.

Pré-requisitos

Você deve ser membro do grupo Colaboradores do seu projeto de equipe para migrar páginas wiki para o wiki do projeto de equipe.

Migrar páginas e outros artefatos

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

Etapas detalhadas

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

  2. Compile o projeto sob o caminho Tools/MigrateToVSTSWiki para gerar a ferramenta de migração EXE.

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

  4. Obtenha o URL para clonar seu wiki. Consulte Clonar seu wiki e editar páginas wiki offline.
    Nomeie esse local de clone como LocationA para este procedimento.

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

  6. Clone o repositório de extensão wiki. O wiki é mapeado para uma pasta dada a você durante a criação do wiki. Você pode confirmar indo para 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 mencionado sampleWiki 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 em sua máquina local e nomeie-a LocationC para este procedimento.

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

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

  8. Abra um prompt de comando como administrador e execute MigrateToVSTSWiki.exeo . Essa 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 serem compatíveis 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 na 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 preparar todos os arquivos LocationA recém-adicionados para a confirmação.

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

  13. Execute git push origin wikiMain -f para enviar as alterações por push para a ramificação padrão do wiki de DevOps do Azure.

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

Contribuições

Este projeto adotou o Código de Conduta do Código de Conduta da Microsoft Open Source. Para obter mais informações, consulte as Perguntas frequentes sobre o Código de Conduta ou entre em contato opencode@microsoft.com com quaisquer perguntas ou comentários.