Neste artigo, nos concentramos em como melhorar o fluxo de trabalho com revisões de código por meio de solicitações de mesclagem do GitLab. Também falamos sobre as melhores práticas de revisão de código que seguimos na Codificar.
Antes de começarmos a fazer uma revisão de código, vamos descobrir o que pode acontecer se você ignorar essa etapa importante.
Os projetos nos quais nossa empresa trabalha geralmente exigem de um a três desenvolvedores por plataforma. E quase qualquer equipe de desenvolvimento inclui pessoas com diferentes níveis de especialização (os desenvolvedores geralmente são classificados como júnior, médio e sênior).
No entanto, independentemente do seu nível, todos os programadores escrevem software de forma diferente. Especialmente desenvolvedores de aplicativos móveis, que tendem a ser criativos.
Portanto, às vezes pode ser difícil para os desenvolvedores descobrir o código escrito por seus colegas. Esse problema também pode ser decorrente de falta de conhecimento, sono, café ou excesso de criatividade.
Então, como podemos ter certeza de que os desenvolvedores podem ler o código uns dos outros? A revisão do código-fonte é um bom ponto de partida!
Muitos desenvolvedores escrevem código como se fossem os únicos que precisariam entendê-lo. Isso não é um problema se um desenvolvedor estiver construindo um produto por conta própria.
Mas esse mundo de solidão pacífica não existe. A realidade é que os desenvolvedores precisam pensar em quem vai assumir seu trabalho. Eles também precisam pensar nos clientes, que terão de gastar dinheiro e tempo desvendando os mistérios ocultos em linhas de código pouco claras. Aqui estão alguns motivos para fazer uma revisão de código:
Como você pode ver, as perspectivas não são as mais agradáveis se você deixar de fazer uma revisão do código. Mas uma revisão de código sozinha não pode garantir a qualidade do código. Em primeiro lugar, o código deve passar pela fase de teste.
A revisão de código não pode substituir a cobertura de teste completa e melhorar completamente a qualidade do código. Antes de fazer uma revisão de código, o novo código deve ter cobertura de teste suficiente. A cada push, os pipelines do GitLab realizam testes e verificações de qualidade do código para que um desenvolvedor possa corrigir os problemas.
Embora as revisões de código possam, às vezes, ajudar na localização de bugs, elas não são a ferramenta principal para esse propósito. Uma coleção robusta de testes de unidade, funcionais e de integração, bem como ferramentas de qualidade de código, atenderá efetivamente a esse propósito.
Mas sempre há a possibilidade de um bug não ser detectado por nenhum teste, e é aí que as revisões de código são críticas. Testes insuficientes também podem produzir incerteza sobre a lógica de negócios do código (se ele atende aos requisitos iniciais). E é aqui que entrará um bom revisor de código.
À medida que o código está sendo escrito, a prioridade é garantir que todos os testes sejam automatizados e executados explicitamente quando o novo código for enviado. Um revisor de código vê quando o GitLab concluiu o teste de uma nova parte do código e quando o código está compilando.
Os resultados dos testes automatizados são claramente visíveis para os desenvolvedores. Passar no pipeline de teste é uma etapa obrigatória antes da mesclagem.
Agora estamos chegando às ferramentas que o GitLab oferece para revisão de código.
Uma solicitação de mesclagem serve para mesclar código de uma ramificação para outra. Os principais parâmetros de solicitação de mesclagem (especificados ao criar uma solicitação de mesclagem) são:
O GitLab pode retornar o erro 500 quando um desenvolvedor tenta criar uma solicitação de mesclagem. Isso significa que o servidor GitLab não está configurado corretamente. Para resolver esse problema, você precisará da ajuda do administrador do sistema ou de alguém que desempenhe a função de administrador do sistema em sua equipe de desenvolvimento.
Pode haver muitos motivos diferentes para o erro 500, e não há uma solução universal para esse problema. No entanto, na maioria dos casos, você pode resolver esse problema de uma das duas maneiras (ou tentando as duas):
1) Defina um valor maior do que o padrão para parâmetros como max_size e tempo limite. O parâmetro max_size define o tamanho máximo de um repositório GitLab. O tempo limite é o tempo de resposta. Se durante esse intervalo os dados não forem retornados, você obterá o Erro 500. O tempo limite também é o tempo máximo para concluir uma solicitação de mesclagem.
Como resolvemos esse problema:
grep cryptspirit config/* -r
config/gitlab.yml: max_size: 104857600 # 100.megabytes cryptspirit
config/gitlab.yml: timeout: 20 # cryptspirit
2) Exclua o repositório de satélites GitLab e inicie-os novamente.
Limpar ->
rm -rf /home/git/gitlab-satellites/{repo}
Gerar novamente ->
O último comando deve ser executado no diretório GitLab com o gemset configurado. Espero que isto ajude!
A atribuição de solicitações de mesclagem depende de vários fatores. Pode haver diferentes opções dependendo do número de pessoas no projeto e seu nível de especialização. Se você for o único desenvolvedor da equipe, atribua uma solicitação de mesclagem a si mesmo. Afinal, você pode encontrar bugs em seu próprio código se tentar. Quem busca sempre encontrará!
Caso contrário, converse com outro desenvolvedor que também esteja sozinho e ofereça-se para revisar o código um do outro. A revisão da documentação também é freqüentemente necessária para garantir que outros desenvolvedores possam trabalhar com o seu código.
Se houver dois desenvolvedores no projeto, atribua solicitações de mesclagem um ao outro. Se houver três ou mais desenvolvedores, você é livre para escolher:
Você pode fazer uma revisão do código no início e no final do dia de trabalho ou a qualquer momento mediante solicitação. A equipe pode decidir quando é um bom momento para fazer uma revisão do código. O mais importante é garantir uma colaboração contínua dentro da equipe. Como você faz uma revisão de código depende diretamente das práticas que sua empresa segue.
Algumas empresas usam um aplicativo de revisão de código e ferramentas de revisão, mas observe que os aplicativos de revisão de código têm suas limitações.
Para mais conteúdos sobre programação e desenvolvimento de aplicativos, continue acompanhando o blog da Codificar.
Preencha o formulário e vamos falar sobre o seu projeto de aplicativo.
Com o avanço constante da tecnologia móvel, os aplicativos se tornaram uma parte essencial do…
Não é uma novidade dizer que o prestador de serviço e o seu cliente devem…
Atualmente, em que a tecnologia permeia praticamente todos os aspectos de nossas vidas, a experiência…
Quando falamos de projetos na área da tecnologia, onde inovações surgem a cada dia e…
Você sabe como analisar as principais métricas do aplicativo? Sabemos que, atualmente, o mercado de…
Aplicativos móveis têm se tornado parte integrante de nossas vidas diárias. E quando falamos sobre…
This website uses cookies.