|
|
|
[GitFlow](GitFlow)
|
|
|
|
|---|
|
|
|
|
|
|
|
|
#Introdução
|
|
|
|
|
|
|
|
Modelo de organização de branches desenvolvido especialmente para o git. Por ser primariamente um modelo de organização de branches, isso significa que o Git Flow estabelece algumas regras de nomenclaturas para tipos de branches enquanto, ao mesmo tempo, define o que cada tipo de branch faz.
|
|
|
|
|
|
|
|
Recomendações para melhor uso do modelo
|
|
|
|
• Projetos em que muitas pessoas vão contribuir.
|
|
|
|
• Existe um plano consistente de análise de linha de código.
|
|
|
|
• Menor privilégio da velocidade de entrega e mais foco na qualidade.
|
|
|
|
• Times pouco experientes ou com grande rotatividade
|
|
|
|
• Produtos com o core bem definido e estabelecido
|
|
|
|
|
|
|
|
Situações de risco para o modelo
|
|
|
|
• Versões iniciais de produtos
|
|
|
|
• Produtos com alto número de mudanças (POC, MVPs)
|
|
|
|
• Times bem Srs e experientes pode sentir o gitflow como um gargalo
|
|
|
|
|
|
|
|
##Branches
|
|
|
|
**BRANCHES PERMANENTES**
|
|
|
|
Branches que vão ser mantidas durante todo o período de desenvolvimento do projeto. Elas devem ser protegidas para manter um histórico de alterações claro e conciso.
|
|
|
|
**Master **
|
|
|
|
Branch em produção a ser distribuido para as demais branches.
|
|
|
|
Características:
|
|
|
|
• Código estável em produção.
|
|
|
|
• Tag para cada uma suas versões.
|
|
|
|
Características:
|
|
|
|
• código já testado, versionado que será entregue ao cliente
|
|
|
|
|
|
|
|
**Develop **
|
|
|
|
A branch de develop é criada a partir da master assim que o projeto é iniciado. Sua funcionalidade é fazer a integração das alterações de desenvolvimento que já foram finalizadas. A partir daqui vai ser gerado o ambiente de desenvolvimento e features finalizadas devem enviar suas alterações para a develop.
|
|
|
|
Caracteristicas:
|
|
|
|
• É onde todo fluxo de trabalho irá ocorrer.
|
|
|
|
• Deve sempre conter o código mais atual.
|
|
|
|
• É usada para testar as feature.
|
|
|
|
• Features finalizadas e prontas.
|
|
|
|
|
|
|
|
**BRANCHES TEMPORÁRIAS **
|
|
|
|
Branches temporarias devem ser criadas para cumprir um proposito e assim que esse proposito for concluído a branch deve ser apagada.
|
|
|
|
**Feature**
|
|
|
|
São utilizadas para desenvolver novos recursos para o projeto. Esse tipo de branch é criado a partir da master e tem como padrão de nomenclatura feature/descricao_da_tarefa, quando o novo recurso terminar de ser desenvolvido deve ser enviado para a develop.
|
|
|
|
• Demandas, estórias
|
|
|
|
• Nomenclatura feature/descricao_da_tarefa
|
|
|
|
• Desenvolvimento de recursos
|
|
|
|
**Bugfix**
|
|
|
|
Branch para correção de erros encontrados em produção. Esse tipo de branch tem por objetivo resolver o problema o mais rapidamente possível. Para isso a branch bugfix é criada a partir da master e deve ser utilizada para resolver o problema, assim que o problema for resolvido ela deve sofrer um merge para a master.
|
|
|
|
Características:
|
|
|
|
• Código sempre proveniente da master.
|
|
|
|
• Nomenclatura bugfix/descricao_da_tarefa
|
|
|
|
|
|
|
|
*Obs:***** a descrição da tarefa deve incluir o número da US (airtable).
|
|
|
|
- A cada commit realizado deve ser descrito brevemente, em português, o que foi desenvolvido.
|
|
|
|
- Anexar imagens da tela caso seja um bugfix
|
|
|
|
|
|
|
|
##Ciclo de vida das Branches
|
|
|
|
###Feature
|
|
|
|
1. Criar uma nova branch a partir da master seguindo a nomenclatura feature/*, onde o asterisco representa qualquer cadeia de caracteres.
|
|
|
|
2. Realizar commits na branch afim de desenvolver a funcionalidade.
|
|
|
|
3. Quando a Funcionalidade estiver completa realizar merge com a branch develop
|
|
|
|
|
|
|
|
###Bugfix
|
|
|
|
1. Criar uma branch a partir da branch master seguindo a nomenclatura bugfix/*, onde o asterisco representa qualquer cadeia de caracteres.
|
|
|
|
2. Realizar commits nessa branch com o objetivo de resolver o bug.
|
|
|
|
3. Realizar o merge da bugfix com a branch develop
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#Gerenciamento de branches no GitLab
|
|
|
|
|
|
|
|
##Criar Pull request
|
|
|
|
Quando finalizamos o desenvolvimento de uma branch e queremos enviar suas alterações para outra branch precisamos criar um pull request. O pull request é uma solicitação de merge que os Ages III e Ages IV vão avaliar para aprovar ou não esse merge. Sendo aprovado e não tendo conflito de commits o merge é feito automaticamente.
|
|
|
|
|
|
|
|
##Aprovação de Pull Request
|
|
|
|
Pessoas pertencentes ao grupo de Ages III e Ages IV devem fazer a revisão do código e aprovar os pull request.
|
|
|
|
|
|
|
|
#Ciclo de Vida Gitflow - do PR à Publicação
|
|
|
|
Branchs fixas atuais:
|
|
|
|
• master
|
|
|
|
• develop
|
|
|
|
PR serão aprovados para as branchs respeitando a nomenclatura definida na imagem abaixo:
|
|
|
|
• bugfix/[número da feature] para develop
|
|
|
|
• feature/[número da feature] para develop
|
|
|
|
|
|
|
|
`<img src="C:\Users\denis\Pictures\gitflow.png" tittle="gitflow">` |
