Processo de Desenvolvimento

Sumário

• Processos
  • Descrição
  • Diagrama GitFlow
    • Branchs
    • Instalação do git
    • Comandos
    • Git Hands On

Descrição

Esta seção é dedicada para os processos de desenvolvimento, onde será apresentado o Workflow do proejto

Diagrama GitFlow

Branchs

Criação das branchs US: "US<Numeração> - <Descrição da US>" Criação das branchs Feature: "Feature/US/<Descrição da Feature>"

Main: Branch com a versão completa e aprovada para entrega final.

Dev: Branch utilizada para desenvolvimento, onde será enviado o código após a conclusão das US.

USxx: Branch utilizada para criação e divisão das features referentes a US.

Feature: Branch utilizada somente para conclusão das features definidas pelo time, sendo mantida até sua finalização.

Instalação do Git

Download

Faça o download e instale o Git a partir deste link, selecionando seu sistema operacional.

Ao final da instalação, abra o Git Bash (caso esteja usando Windows) ou um terminal, e digite git –version. Ao retornar a versão do Git, significa que a instalação foi bem sucedida.

Nota: Usuários de Linux e Mac já possuem o Git nativamente. Para verificar, abra um terminal e digite git –version. Caso retorne a versão do Git, significa que o mesmo está devidamente instalado em sua máquina.

Comandos

Para baixar a versão mais atualizada antes de criar uma nova branch, é necessário garantir que o código esteja na versão mais atualizada, para isso, utilize o comando:

git pull origin dev

Após garantir que a versão está atualizada, a branch pode ser criada utilizando o comando:

git checkout -b <nomeDaBranch>

Para salvar algum arquivo específico localmente, utilize:

git add <nomeDoArquivo>

Porém, caso queira salvar localmente todos os arquivos modificados, utilize: git add .

Após os arquivos serem salvos, é necessário executar o comando de commit com uma mensagem referente ao desenvolvimento da tarefa, para subir o código remotamente:

git commit -m “descrição da tarefa”

Após todos os passos anteriores, salve o código remotamente utilizando o comando:

git push

Git Hands On

Esta seção é dedicada ao teste da configuração do seu ambiente, bem como a prática do Gitflow do projeto. O hands on consiste em atualizar o README do repositório da Wiki com o seu nome e seu nível AGES, além de, ao final, submeter seu primeiro Pull Request.

Passo 1: Clonar o repositório da Wiki

Efetue o clone do repositorio da Wiki via HTTPS e abra o projeto com um editor de texto. Link: https://tools.ages.pucrs.br/projeto-focus/wiki

Passo 2: Criando uma branch nova

A partir da branch main, crie uma nova branch seguindo o comando abaixo:

git checkout -b seuPrimeiroNome-handson

Passo 3: Editando o README.md

Abra o arquivo README.md e atualize a tabela de membros com seu nome e seu nível AGES.

Passo 4: Commit em suas mudanças

Efetue o commit das suas mudanças rodando os comandos abaixo

git add .
git commit -m “Add my name to the table”

Passo 5: Submetendo um pull request

Após efetuar o commit, rode o comando abaixo para enviar suas modificações para o repositório remoto:

git push origin seuPrimeiroNome-handson

Nota: Provavelmente, ao efetuar o push, o GitLab irá requisitar suas credenciais.

Após efetuar, vá no painel do GitLab, procure pelo repositório Projeto Focus/Wiki e, no menu lateral procure por Merge Request. Na opção “Select source branch” selecione a branch que você criou e clique em “Compare branches and continue”.

Dentro do merge request, mantenha as informações padrão, porém, na opção Reviewer, marque um dos AGES III ou IV para fazer a revisão. Após isso, clique em “Create merge request” e aguarde a aprovação.

Com este fluxo completo e bem sucedido, significa que seu ambiente está devidamente configurado para utilizar os repositórios do Projeto Focus.