Forem: Danilo Silva

Git Flow - Releases [pt-BR]

Danilo Silva — Mon, 29 Aug 2022 22:18:06 +0000

Vamos aprender para que servem as branches chamadas de releases e como aplicar o uso delas ao lançamento de uma versão no ambiente de produção.

Definição

Releases são branches de preparação de um novo lançamento em produção e elas permitem pequenas correções de bugs e preparação de metadados para publicação (número da versão, datas de construção, entre outras definições).

Por convenção elas têm o prefixo release/.
Por exemplo:

release/0.1.0

Importante ressaltar que as releases (vamos nos acostumar a chamá-lás assim) são criadas sempre à partir da branch develop.

📌 O momento ideal para criar uma nova branch release é quando o desenvolvimento (quase) reflete o estado desejado do novo lançamento. Pelo menos todos os recursos que são direcionados para o lançamento a ser construído devem estar presentes na branch develop.

📝 Descrição da imagem:

Criação de uma feature a partir da develop (F - Nova feature) e no final do desenvolvimento da funcionalidade (C - Commit) é realizada a mesclagem com a develop (M - Merge).

Logo após é criada uma release (R - Nova release), onde pode haver alteração do número de versão e outras definições e por fim, a mesclagem com a branch master (M - Merge) e o código atualizado volta a ser integrado também, à develop.

Releases na prática 😎

Pré-requisitos

Ter o GIT instalado
Qualquer repositório com o fluxo do Git Flow inicializado e configurado.

1. Criação de releases

Para criar uma release é bem simples:

git flow releases start <número-versão-proposta>

Com um comando neste padrão, será criada uma nova branch através da develop com o prefixo release/, seguido do número de versão que você inserir.
Execute:

git flow release start 0.1.0

O retorno do comando é uma nova branch entitulado release/0.1.0 e já é realizado checkout nessa nova branch.

[saída do console]                                                       
Switched to a new branch 'release/0.1.0'

Summary of actions:
- A new branch 'release/0.1.0' was created, bases on 'develop'
- You are now on branch 'release/0.1.0'

Follow-up actions:
- Bump the version number now!
- Start commtting last-minute in preparing your release
- When done, run:

      git flow release finish '0.1.0'

2. Finalização de releases

Após terminar o preparação da aplicação para ser lançada em produção, a branch estará pronta para ser finalizada e mesclada à develop.

Então você verificou que está na release, não há nenhum commit a ser feito e nenhum arquivo pendente...

git checkout release/0.1.0
git status

[saída do console]                         
No ramo release/0.1.0              
nothing to commit, working tree clean

Para finalizar uma release, basta:

git flow release finish <número-versão-proposta>

O número da versão da release é opcional quando você já está presente(checkout) nela.

Execute:

git flow release finish

Após esta instruçao, aparecerá a possibilidade de escrever uma mensagem que descreverá a versão lançada (nota de versão).


#
# Write a message for tag:
#  0.1.0
# Lines starting with '#' will be ignored.

⚠️ A finalização de uma release marca a criação de uma tag correspondente ao número de versão entitulado na branch release.

Depois de escrever a mensagem, a release será meclada(merge) à master E à develop, em seguida deletada tanto localmente como remotamente.

Switched to branch 'master'
Your branch is up to date with 'origin/master'.
To <url-repositorito-remoto>
 -  [deleted]                          release/0.1.0
Deleted branch release/0.1.0 (was 713d5ac).

Summary of actions:
- Release branch 'release/0.1.0' has been merged into 'master'
- The release was tagged '0.1.0'
- Release branch 'release/0.1.0' has been locally deleted; it has been remotely deleted from 'origin'
- You are now on branch 'master'

Considerações finais

✅ Para garantir que o repositório remoto estará atualizado baseando no status da sua estação de trabalho local, execute os comandos abaixo:

EMPURRE (push) as atualizações de todos as branches

  git push --all

SUBA (push) a tag recentemente criada

  git push --tags

Pronto, para trabalhar com releases de forma simples e rápida, é isto!!

⚡ Nesta seção sobre Git Flow você encontrará explicações e usos práticos sobre features, hotfixes, tags e muito mais.

Obrigado por chegar até aqui! 😄

Git Flow - Hotfixes [pt-BR]

Danilo Silva — Mon, 29 Aug 2022 22:10:01 +0000

Continuando nossa jornada sobre GitFlow vamos aprender para que servem as branches chamadas de hotfixes e como aplicar o uso deles em correções urgentes em produção. 😯

Definição

Hotfixes são branches usados para resolver rapidamente as mudanças necessárias na branch principal (master). São destinados para a realização de alguma(s) correção(ões) crítica(s) encontrada(s) em produção.

Por convenção elas têm o prefixo hotfix/.
Por exemplo:

hotfix/1.0.1

Importante ressaltar que as hotfixes (vamos nos acostumar a chamá-lás assim) são criadas sempre à partir da branch master.

📝 Descrição da imagem:

Após haver uma versão em produção (master), é criada uma hotfix (H - Nova hotfix) onde há correções imediatas do código a partir do branch principal e por fim, a mesclagem com a branch master (M - Merge) e o código atualizado volta a ser integrado também, à develop.

Hotfixes na prática 😎

Pré-requisitos

Ter o GIT instalado
Qualquer repositório com o fluxo do Git Flow inicializado e configurado.

1. Criação de hotfixes

Para criar uma hotfix é bem simples:

git flow hotfix start <número-versão-proposta-de-correção>

Com um comando neste padrão, será criada uma nova branch através da develop com o prefixo hotfix/, seguido do número de versão que você inserir.
Execute:

git flow hotfix start 1.0.1

O retorno do comando é uma nova branch entitulado hotfix/1.0.1 e já é realizado checkout nessa nova branch.

[saída do console]                                                       
Switched to a new branch 'hotfix/1.0.1'

Summary of actions:
- A new branch 'hotfix/1.0.1' was created, bases on 'master'
- You are now on branch 'hotfix/1.0.1'

Follow-up actions:
- Bump the version number now!
- Start commtting last-minute in preparing your hotfix
- When done, run:

      git flow hotfix finish '1.0.1'

2. Finalização de hotfixes

Após finalizar as correções urgentes no código que está em produção, a branch estará pronta para ser finalizada e mesclada tanto na master quanto na develop.

Então você verificou que está na hotfix, não há nenhum commit a ser feito e nenhum arquivo pendente...

git checkout hotfix/1.0.1
git status

[saída do console]                         
No ramo hotfix/1.0.1              
nothing to commit, working tree clean

Para finalizar uma hotfix, basta:

git flow hotfix finish <número-versão-proposta>

O número da versão da hotfix é opcional quando você já está presente(checkout) nela.

Execute:

git flow hotfix finish

Após esta instruçao, aparecerá a possibilidade de escrever uma mensagem que descreverá a versão lançada (nota de versão).


#
# Write a message for tag:
#  1.0.1
# Lines starting with '#' will be ignored.

⚠️ A finalização de uma hotfix marca a criação de uma tag correspondente ao número de versão entitulado na branch hotfix.

Depois de escrever a mensagem, a hotfix será meclada(merge) à master E à develop, em seguida deletada tanto localmente como remotamente.

Switched to branch 'master'
Your branch is up to date with 'origin/master'.
To <url-repositorito-remoto>
 -  [deleted]                          hotfix/1.0.1
Deleted branch hotfix/1.0.1 (was 713d5ac).

Summary of actions:
- Hotfix branch 'hotfix/1.0.1' has been merged into 'master'
- The hotfix was tagged '1.0.1'
- Hotfix branch 'hotfix/1.0.1' has been locally deleted
- You are now on branch 'develop'

Considerações finais

✅ Para garantir que o repositório remoto estará atualizado baseando no status da sua estação de trabalho local, execute os comandos abaixo:

EMPURRE (push) as atualizações de todas as branches

  git push --all

SUBA (push) a tag recentemente criada

  git push --tags

Pronto, para trabalhar com hotfixes de forma simples e rápida, é isto!!

⚡ Nesta seção sobre Git Flow você encontrará explicações e usos práticos sobre features, releases, tags e muito mais.

Obrigado por chegar até aqui! 😄

Git Flow - Features [pt-BR]

Danilo Silva — Mon, 29 Aug 2022 22:07:32 +0000

Vamos aprender para que servem as branches chamadas de features e como aplicar o uso delas ao desenvolvimento.

Definição

Features são branches para o desenvolvimento de uma funcionalidade específica, por convenção elas têm o prefixo feature/.

feature/cadastro-pessoa

Importante ressaltar que as features (vamos nos acostumar a chamá-lás assim) são criadas sempre à partir da branch develop.

📌 O conceito de feature é aplicado entendendo que em cada uma será realizado o desenvolvimento de uma tarefa/história/demanda, sendo assim ser possível organizar o fluxo de desenvolvimento por tarefas concluídas e terem suas criações e/ou alterações sempre presentes na develop (branch principal de desenvolvimento).

📝 Descrição da imagem:

Criação de uma feature a partir da develop (F - Nova feature) e no final do desenvolvimento da funcionalidade (C - Commit) é realizada a mesclagem com a develop (M - Merge).

Features na prática 😎

Pré-requisitos

Ter o GIT instalado
Qualquer repositório com o fluxo do Git Flow inicializado e configurado.

1. Criação de features

Para criar uma feature é bem simples:

git flow feature start <nome-funcionalidade-ou-tarefa>

Com um comando neste padrão, será criada uma nova branch através da develop com o prefixo feature/, seguido do nome que você inserir.
Execute:

git flow feature start cadastrar-pessoa

O retorno do comando é uma nova branch entitulado feature/cadastrar-pessoa e já é realizado checkout nessa nova branch.

[saída do console]                                                       
Switched to a new branch 'feature/cadastrar-pessoa'

Summary of actions:
- A new branch 'feature/cadastrar-pessoa' was created, bases on 'develop'
- You are now on branch 'feature/cadastrar-pessoa'

Now, start committing on your feature. When done, use:
    git flow feature finish cadastrar-pessoa

2. Finalização de features

Após terminar o desenvolvimento da funcionalidade, ser feito N commits, a branch estará pronta para ser finalizado e mesclado à develop.

Então você verificou que está na feature, não há nenhum commit a ser feito e nenhum arquivo pendente...

git checkout feature/cadastrar-pessoa
git status

[saída do console]                         
No ramo feature/cadastrar-pessoa                  
nothing to commit, working tree clean

Para finalizar uma feature, basta:

git flow feature finish <nome-funcionalidade-ou-tarefa>

O nome da feature é opcional quando você já está presente(checkout) nela.

Execute:

git flow feature finish

Após esta instruçao, a feature será meclada(merge) à develop e, deletada tanto localmente como remotamente.

Switched to branch 'develop'
Already up to date.
Deleted branch feature/cadastrar-pessoa (was 713d5ac).

Summary of actions:
- The feature branch 'feature/cadastrar-pessoa' was merged into 'develop'
- Feature branch 'feature/cadastrar-pessoa' has been locally deleted
- You are now on branch 'develop'

Pronto, para trabalhar com features de forma simples e rápida, é isto!!

Considerações finais

Resumo de comandos

Criar nova feature

  git flow feature start <nome-funcionalidade-ou-tarefa>

Finalizar feature

  git flow feature finish

⚡ Nesta seção sobre Git Flow você encontrará explicações e usos práticos sobre releases, hotfixes, tags e muito mais.

Obrigado por chegar até aqui! 😄

Git Flow - Configuração inicial [pt-BR]

Danilo Silva — Mon, 29 Aug 2022 22:03:49 +0000

De forma simples e fácil, vamos aprender a configurar qualquer repositório GIT para utilizar o fluxo do Git Flow na prática! Vamos lá?

Resumo

Iremos criar uma pasta em nosso computador (em qualquer diretório que preferir)
Inicializaremos um repositório GIT (partirei do pressuposto que você também já sabe como funciona um repositório)
Aplicaremos as configurações do fluxo Git Flow neste repositório.

Mão na massa 😄

Pré-requisitos

O Git Flow não é uma ferramenta padrão do Git, e por esse motivo precisamos antes de tudo realizar a instalação do plugin.

No Github tem o passo a passo de como instalar em todos os ambientes.

1. Criando pasta

No diretório desejado, execute os comandos:

mkdir app-gitflow        // criação de pasta
cd app-gitflow           // acessando pasta criada

2. Inicializando um repositório git

Dentro da pasta criada, execute o comando:

git init

3. Configurando o fluxo Git Flow

Por padrão, o Git Flow não vem configurado em um repositório GIT, logo vamos executar o comando principal e em seguida, você vai perceber o quão simples é configurar e ver este fluxo apto para uso.

git flow init

Ao executar este comando é iniciada um pequena série de definições feitas através do console.

Vamos entender cada item configurado, se liga

// Primeiro, a definição das branches principais
No branches exist yet. Base branches must be created now.

// 1. Defina qual o nome da branch que armazenará o código de produção
Branch name for production releases: [master] 
// Por padrão, o GIT sugere que seja: master
// Basta apertar ENTER

// 2. Defina qual o nome da branch de desenvolvimento principal
Branch name for "next release" development: [develop]
// Por padrão, o GIT sugere que seja: develop
// Basta apertar ENTER

// Agora, a definição das branches de apoio
How to name your supporting branch prefixes?

// 3. Defina o prefixo das branches features
Feature branches? [feature/]
// Por padrão, o GIT sugere que seja: feature/
// Basta apertar ENTER

// 4. Defina o prefixo das branches bugfixs
Bugfix branches? [bugfix/]
// Por padrão, o GIT sugere que seja: bugfix/
// Basta apertar ENTER

// 5. Defina o prefixo das branches releases
Release branches? [release/]
// Por padrão, o GIT sugere que seja: release/
// Basta apertar ENTER

// 6. Defina o prefixo das branches hotfixs
Hotfix branches? [hotfix/]
// Por padrão, o GIT sugere que seja: hotfix/
// Basta apertar ENTER

// 6. Defina o prefixo das branches supports
Support branches? [support/]
// Por padrão, o GIT sugere que seja: support/
// Basta apertar ENTER

// 7. Defina o prefixo para cada versão gerada através de tags
Version tag prefix? []
// Basta apertar ENTER

// 7. Indique a pasta onde ficará os scripts(ganchos) personalizados do repositório
Hooks and filters directory? [<diretorio>/app-gitflow/.git/hooks]
// Por padrão, o GIT sugere a configuração padrão, alocada dentro da própria pasta
// Basta apertar ENTER

✅ Pronto, simples e rápido, já temos um modelo para aplicarmos em qualquer repositório durante o desenvolvimento de qualquer projeto ou aplicação!

⚡️ Dica rápida

Você deve ter percebido que não precisamos configurar nenhum prefixo ao executar o comando principal, bastou ENTER a cada linha.
Para pular essas configurações e configurar o fluxo de forma padrão, execute o comando principal com a flag -d:

git flow init -d

Considerações finais

Ainda nesta série sobre Git Flow você encontrará explicações e usos práticos de cada conjuntos de branches.

Recomendo que você explore cada uma delas pois, logo, você vai sentir que está dominado o ciclo de desenvolvimento de uma aplicação, de ponta-a-ponta, e ter total capacidade de ajudar sua equipe de desenvolvimento!

Obrigado por chegar até aqui! 😄

Git Flow - "Era uma vez..." [pt-BR]

Danilo Silva — Mon, 29 Aug 2022 21:58:48 +0000

Vamos aprender sobre este fluxo que tem gerado sucesso em muitos times de desenvolvimento de software!

Teoria

É muito comum vermos desenvolvedores utilizando somente uma branch para fazer commits em projetos pessoais. Isto não é errado, é muito tranquilo de se controlar tudo em uma branch quando se está desenvolvendo sozinho, mas o cenário muda bastante quando temos que interagir com mais desenvolvedores, seja em um projeto de código aberto(opensource) ou privado.

Nessas horas é importante que se tenha total controle do que está sendo produzido por sua equipe, onde, ao mesmo tempo são corrigidas falhas, implementadas novas funcionalidades e o ideal é ter o seu código de produção com total funcionamento entregue ao cliente.

É aí que o Fluxo Git Flow nos ajuda, olhe a imagem abaixo para entender melhor:

O Git Flow é um modelo de conjunto de instruções que você e/ou equipes de desenvolvimento podem seguir para organizar as branches.

É importante ressaltar que o Git Flow são orientações e não regras, ou seja, você não precisa seguir 100% ao pé da letra, acho bacana e até saudável que pensemos em adaptações de acordo com a equipe de desenvolvimento e o modelo de trabalho.

As branches principais

A master deve ser a principal branch onde o código-fonte sempre reflete um estado pronto que, quando versionado, será publicado em produção.

A develop sempre deve conter o código mais atual, ou seja, o que está sendo desenvolvido no momento. Isto é possível fazendo com que as branches de features sejam criados através dela e no fim de seu ciclo, todo o código produzido seja mesclado (merge) na develop.

Quando o código-fonte na develop atinge um ponto estável e está pronto para ser liberado, todas as alterações devem ser mescladas (merge) na master de alguma forma e marcadas com um número de release (tag).

💡 Iremos nos aprofundar mais detalhadamente sobre os conceitos de branches e tags nos próximos posts.

As branches de apoio

Junto as principais branches, master e develop, há diversas branches de apoio para auxiliar o desenvolvimento paralelo entre os membros da equipe, facilitar o rastreamento de recursos, preparar releases de produção e ajudar a corrigir instantaneamente problemas de produção (hotfix).

Ou seja:

feature: para novas implementações
release: para finalizar releases e tags
hotfix: para resolver problemas críticos em produção que não podem esperar uma nova release

⚡ Para saber como configurar o fluxo do Git Flow em um repositório e como criar as branches de apoio de forma dinâmica, navegue pelas publicações com a tag gitflow.

Obrigado por chegar até aqui! 😄