Explorar o fluxo do GitHub

Concluído

O fluxo do GitHub ilustra como o GitHub pode adicionar valor ao desenvolvimento de software colaborativo baseado em Git tradicional. Sua finalidade é simplificar as atualizações para projetos hospedados no GitHub fornecendo uma orientação prescritiva sobre o processo de aplicação de alterações ao repositório do projeto. A organização em nosso cenário de exemplo provavelmente se beneficiaria de incorporar o GitHub Flow em suas práticas de DevOps, especialmente considerando sua falta de experiência no uso de repositórios baseados em Git. Nesta unidade, examine a sequência de etapas que representam o caso de uso mais comum do fluxo do GitHub.

Seguindo o fluxo do GitHub

Diagrama mostrando um fluxo de trabalho de branch básico.

O fluxo do GitHub consiste nas seguintes etapas:

  1. Criando um repositório. Para seguir o fluxo do GitHub, você precisará de uma conta do GitHub e de um repositório. Por padrão, um novo repositório inclui o branch padrão, normalmente denominado principal.

  2. Criar um branch. A criação de outro branch permite que você desenvolva e salve suas alterações sem afetar o branch padrão. Além disso, ela permite que outras pessoas colaborem em suas alterações examinando-as antes de serem mescladas no branch principal. Você pode criar um branch diretamente no GitHub ou clonar o repositório no computador local e criar uma ramificação lá.

  3. Fazer alterações no branch. Aplique alterações ao branch recém-criado invocando as ações de commit e (se estiver funcionando localmente) de push. Você pode editar arquivos diretamente no repositório hospedado do GitHub usando a interface da Web do GitHub. Para cada confirmação, forneça uma breve mensagem descrevendo as alterações aplicadas. Repita essas etapas até que você considere as alterações concluídas e esteja pronto para pedir que outras pessoas as examinem.

  4. Criando uma solicitação de pull. Solicite comentários criando um pull request (geralmente abreviado como PR) após o último commit para o branch que você criou. Forneça um resumo das alterações incluídas no branch e explique o aprimoramento que elas pretendem trazer. Use a notação de menção @ se você quiser solicitar uma revisão de indivíduos ou equipes específicas.

    Diagrama mostrando branches principais e de recursos e um pull request.

  5. Examinando a solicitação de pull. É aí que outras pessoas entram, revisam seu pull request e enviam seus feedbacks, incluindo comentários, perguntas e sugestões.

  6. Abordando comentários de revisão. Depois que as revisões forem concluídas, você ajustará suas alterações para levá-las em conta e aguardar a aprovação da solicitação de pull.

  7. Mesclando a solicitação de pull. A aprovação da solicitação de pull permite mesclar o conteúdo do branch criado com o branch padrão (principal). Por padrão, o GitHub mantém os comentários e confirmações na solicitação de pull, o que permite que você e outras pessoas os revisitem a qualquer momento. Ao implementar a proteção de branch, suas restrições podem afetar a capacidade de mesclagem, portanto, certifique-se de isso esteja satisfeito primeiro.

  8. Excluir o branch. Depois que a mesclagem for concluída, você poderá excluir o branch criado. Isso ajuda a minimizar o tamanho do repositório e impede o uso acidental de ramificações desatualizadas.