Introdução: O Desafio da Automação em Projetos Pequenos

Gerenciar projetos de software, mesmo os de pequena escala, pode se tornar um desafio quando se trata de manter a consistência, a qualidade e a velocidade nas entregas. A tentação de pular etapas de automação em prol da rapidez inicial é grande, mas a longo prazo, isso pode levar a inconsistências, erros manuais e um ciclo de desenvolvimento mais lento. A boa notícia é que não é preciso ter uma infraestrutura complexa para começar a automatizar processos cruciais como validação de código e deploy. Os Git Hooks surgem como uma ferramenta poderosa e acessível para introduzir práticas de integração contínua (CI) e deploy contínuo (CD) em projetos de qualquer tamanho.

O Que São Git Hooks e Por Que Usá-los?

Git Hooks são scripts que o Git executa automaticamente em determinados momentos do seu ciclo de vida, como antes de um commit, após um push, ou antes de um merge. Eles funcionam como gatilhos que permitem executar tarefas customizadas sem a necessidade de ferramentas externas complexas. Para pequenos projetos, os Git Hooks são ideais porque:

São Locais: Não exigem um servidor de CI/CD dedicado. Os hooks residem no repositório Git local de cada desenvolvedor.
São Flexíveis: Podem ser escritos em qualquer linguagem de script (bash, Python, Ruby, etc.).
Automatizam Tarefas Repetitivas: Garantem que certas verificações sejam feitas antes de enviar código para o repositório remoto, prevenindo erros comuns.
Promovem Boas Práticas: Incentivam a escrita de código limpo, testes adequados e a conformidade com padrões definidos.

Tipos de Git Hooks Úteis para Automação

Existem dois tipos principais de hooks: os client-side (lado do cliente) e os server-side (lado do servidor). Para automação em pequenos projetos, focaremos nos hooks client-side, que podem ser configurados localmente por cada desenvolvedor.

Hooks Client-Side Mais Relevantes:

pre-commit: Executado antes do Git solicitar uma mensagem de commit. Ideal para rodar linters, formatadores de código e testes unitários básicos. Se o script falhar (retornar um código de saída diferente de zero), o commit é abortado.
prepare-commit-msg: Executado antes do editor de mensagens de commit ser aberto. Útil para pré-preencher ou modificar a mensagem de commit automaticamente.
commit-msg: Executado após o usuário digitar a mensagem de commit, mas antes do commit ser finalizado. Permite validar o formato da mensagem de commit (ex: seguir um padrão como Conventional Commits).
post-commit: Executado após um commit ser finalizado com sucesso. Pode ser usado para notificar sobre o commit ou realizar outras ações.
pre-push: Executado antes de um git push ser realizado. Essencial para rodar testes mais abrangentes (integração, e2e) ou verificações de segurança antes de enviar o código para o repositório remoto.

Configurando Seu Primeiro Git Hook: O `pre-commit`

Vamos configurar um hook pre-commit para garantir que nosso código esteja formatado corretamente e passe em verificações básicas antes de cada commit.

Passo 1: Navegue até a pasta de hooks

Os Git Hooks ficam em um subdiretório chamado .git/hooks/ dentro do seu repositório. Você encontrará exemplos de hooks com a extensão .sample. Para ativar um hook, basta remover a extensão .sample e torná-lo executável.

cd meu-projeto
cd .git/hooks/

Passo 2: Crie o script `pre-commit`

Crie um novo arquivo chamado pre-commit (sem a extensão .sample) na pasta .git/hooks/.

touch pre-commit

Passo 3: Adicione o conteúdo ao script

Abra o arquivo pre-commit em seu editor e adicione o seguinte conteúdo (exemplo usando bash e assumindo que você tem eslint e prettier instalados e configurados em seu projeto Node.js):

#!/bin/bash

# Verificar se o código está formatado com Prettier
echo "Executando Prettier para formatar o código..."
prettier --write "**/*.{js,jsx,ts,tsx,json,css,scss,md}" || exit 1

# Verificar se o código está lintado com ESLint
echo "Executando ESLint para verificar a qualidade do código..."
eslint . --ext .js,.jsx,.ts,.tsx || exit 1

# Executar testes unitários (exemplo)
echo "Executando testes unitários..."
npm test || exit 1

echo "Verificações de pre-commit concluídas com sucesso!"
exit 0

Aviso de Segurança: Este script modifica arquivos (prettier --write). Certifique-se de que você entende o que ele faz antes de executá-lo. Se você não quiser que o hook formate automaticamente, remova a linha prettier --write ... e use apenas prettier --check ... para verificar a formatação sem modificar os arquivos.

Passo 4: Torne o script executável

No terminal, execute o seguinte comando:

chmod +x pre-commit

Passo 5: Teste o hook

Agora, quando você tentar fazer um commit, o script pre-commit será executado automaticamente. Se alguma das verificações falhar, o commit será abortado.

git add .
git commit -m "Mensagem do commit"

Se o pre-commit falhar, você verá mensagens de erro indicando qual verificação não passou. Corrija os problemas e tente o commit novamente.

Automatizando o Deploy com `pre-push`

O hook pre-push é onde podemos adicionar verificações mais robustas antes de enviar nosso código para o repositório remoto (como GitHub, GitLab, Bitbucket). Isso é crucial para evitar que código com problemas chegue à sua base de código principal.

Exemplo de Script `pre-push`:

Crie um arquivo .git/hooks/pre-push e torne-o executável (chmod +x .git/hooks/pre-push), semelhante ao pre-commit. Adicione o seguinte conteúdo:

#!/bin/bash

# Verificar se há atualizações pendentes no branch remoto
echo "Verificando se o branch local está atualizado com o remoto..."
git fetch origin
LOCAL=$(git rev-parse HEAD)
REMOTE=$(git rev-parse @{u})
BASE=$(git merge-base HEAD @{u})

if [ $LOCAL = $REMOTE ]; then
    echo "Seu branch está atualizado."
elif [ $LOCAL = $BASE ]; then
    echo "ERRO: Seu branch está desatualizado. Faça o pull antes de enviar (push)."
    exit 1
else
    echo "Seu branch está à frente do remoto."
fi

# Executar testes de integração (exemplo)
echo "Executando testes de integração..."
# Substitua pelo comando que executa seus testes de integração
# npm run test:integration || exit 1

# Executar análise estática de segurança (SAST) (exemplo)
echo "Executando análise estática de segurança..."
# Substitua pelo comando da sua ferramenta SAST
# semgrep --config=patterntest.yaml . || exit 1

echo "Verificações de pre-push concluídas com sucesso!"
exit 0

Aviso de Segurança: Scripts pre-push podem executar comandos que acessam a rede ou realizam verificações complexas. Certifique-se de que as ferramentas que você está usando são confiáveis e que você entende o que elas verificam.

Gerenciando Git Hooks em Equipe

Embora os Git Hooks sejam armazenados no diretório .git/, que não é versionado, existem maneiras de compartilhá-los com a equipe:

Repositório Centralizado de Hooks: Crie um repositório separado para seus hooks e instrua os membros da equipe a cloná-lo e configurá-lo usando git config --global core.hooksPath /caminho/para/seu/repositorio/de/hooks.
Ferramentas de Gerenciamento de Hooks: Ferramentas como husky (para Node.js) ou pre-commit (Python) facilitam a instalação, o gerenciamento e o compartilhamento de hooks. Elas geralmente definem os hooks em um arquivo de configuração (package.json, .pre-commit-config.yaml) e gerenciam a instalação no diretório .git/hooks/ para você.

Para pequenos projetos, começar com a configuração manual ou um repositório centralizado pode ser suficiente. À medida que o projeto cresce, ferramentas como o husky oferecem uma experiência mais polida e integrada.

Além dos Hooks: Próximos Passos para CI/CD

Os Git Hooks são um excelente ponto de partida para automação, mas não substituem completamente uma pipeline de CI/CD robusta. Para um deploy mais automatizado e confiável, considere:

Serviços de CI/CD: Plataformas como GitHub Actions, GitLab CI/CD, CircleCI ou Jenkins podem executar testes, builds e deploys automaticamente em resposta a eventos no seu repositório.
Testes Automatizados Abrangentes: Invista em testes unitários, de integração e end-to-end (E2E) para garantir a qualidade do código.
Gerenciamento de Ambientes: Use ferramentas como Docker para garantir que seus ambientes de desenvolvimento, staging e produção sejam consistentes.
Estratégias de Deploy: Explore Blue/Green deployments, Canary releases ou Rolling updates para minimizar o tempo de inatividade durante os deploys.

Mesmo em projetos pequenos, a adoção gradual dessas práticas pode economizar tempo e evitar dores de cabeça significativas no futuro. Comece com o que é mais fácil de implementar e vá adicionando complexidade conforme a necessidade.

Conclusão: Automação Acessível para Todos

A automação de processos de desenvolvimento não é um luxo reservado a grandes empresas. Com ferramentas como os Git Hooks, mesmo desenvolvedores individuais ou pequenas equipes podem implementar práticas de DevOps que melhoram a qualidade do código, agilizam o ciclo de desenvolvimento e aumentam a confiança nas entregas. Ao investir um pouco de tempo na configuração desses scripts, você estará construindo uma base mais sólida para o sucesso do seu projeto, garantindo que ele cresça de forma sustentável e eficiente.

Foto de Godfrey Atima no Pexels.