Pular para o conteúdo principal

Receber atualizações

As atualizações são essenciais para garantir a segurança e o bom funcionamento do seu portal. Por isso, a NDL mantém um repositório modelo, onde realizamos as atualizações.

Como funciona?

  • Quando houver uma atualização, nós publicaremos um novo release aqui
  • Você adiciona o repositório remoto apenas a primeira vez
  • Recebe as atualizações do repositório remoto

Adicionar o repositório remoto

Vamos configurar o repositório modelo como a fonte oficial para receber novas funcionalidades, correções e melhorias.

observação

Esta configuração deve ser realizada apenas na primeira vez que for receber alguma atualização.

  1. Com o seu projeto aberto no VS Code
  2. Abra o terminal ctrl|cmd + '
  3. Digite o comando
git remote add upstream https://tfs.ndd.tech/Engenharia%20de%20Software/EngSoft/_git/ndl-docs-base
dica

Você pode verificar se o repositório foi adicionado usando o comando git remote -v. O resultado deve ser algo como:

origin  https://tfs.ndd.tech/Engenharia%20de%20Software/EngSoft/_git/ndl (fetch)
origin https://tfs.ndd.tech/Engenharia%20de%20Software/EngSoft/_git/ndl (push)
upstream https://tfs.ndd.tech/Engenharia%20de%20Software/EngSoft/_git/ndl-docs-base (fetch)
upstream https://tfs.ndd.tech/Engenharia%20de%20Software/EngSoft/_git/ndl-docs-base (push)

Buscar atualizações

  1. No terminal do VS Code
  2. Execute o comando para buscar as atualizações
git fetch upstream
  1. Crie uma nova branch temporária para receber as atualizações
git branch feature/atualizacao-upstream
  1. Agora mude para a branch temporária
git checkout feature/atualizacao-upstream
  1. Faça o merge das atualizações executando
git merge upstream/main
Atenção

Se houver conflitos durante o merge, resolva-os manualmente antes de prosseguir com o envio para o repositório remoto.

Enviar atualizações

Após você receber e tratar os arquivos atualizados, vamos enviar para o repositório remoto.

  1. Adicione todos os arquivos para realizar o commit
git add .
  1. Realize o commit das alterações
git commit -m "Atualizações recebidas do UPSTREAM"
  1. Faça o envio das alterações para o Azure TFS
git push origin feature/atualizacao-upstream

Criar a Pull request

  1. Acesse o repositório
  2. Você deve estar vendo uma mensagem semelhante a feature/atualizacao-upstream 1m ago
  3. Clique em Create a pull request
cuidado

Informações que devem estar selecionadas:

  1. O repositório do seu portal
  2. A branch feature/atualizacao-upstream
  3. Novamente o repositório do seu portal
  4. A Branch main

Exemplo Pull Request

  1. Termine de preencher a Pull request e clique em Create
  2. Clique em Aprove e depois em Complete
    1. Selecione Complete associated work items after merging para finalizar quaisquer work itens linkados
    2. Selecione Delete feature/atualizacao-upstream after merging para deletar a branch que está sendo unificada
  3. Clique em Complete merge

Quando o PR for aprovado e mesclado, sua main estará atualizada com as mudanças do repositório modelo (upstream/main).

observação

Atualmente apenas o usuário paulo.henrique está autorizado a realizar as aprovações. Para adicionar outros aprovadores entre em contato conosco (paulo.henrique@ndd.tech)


Para saber mais sobre as atualizações, acesse a página O que há de novo?.


Suporte

Qualquer necessidade você pode contar conosco, entre em contato pelo teams ou e-mail: paulo.henrique@ndd.tech.