Skip to main content

Bifurcar um repositório

Um fork é uma cópia de um repositório. Bifurcar um repositório permite que você faça experiências à vontade sem comprometer o projeto original.

Sobre bifurcações

O uso mais comum das bifurcações é propor alterações no projeto de outra pessoa no qual você não tem acesso de gravação ou usar o projeto de outra pessoa como ponto de partida para uma ideia própria. Você pode bifurcar um repositório para criar uma cópia do repositório e fazer alterações sem afetar o repositório upstream. Para obter mais informações, confira "Como trabalhar com forks".

Proponha mudanças no projeto de outra pessoa

Por exemplo, você pode usar bifurcações para propor alterações relacionadas à correção de um bug. Em vez de registrar um erro encontrado, você pode:

  • Crie fork do repositório.
  • Fazer a correção.
  • Enviar um pull request ao proprietário do projeto.

Use o projeto de outra pessoa como ponto de partida para sua própria ideia.

O software de código aberto baseia-se na ideia de que ao compartilhar códigos, podemos criar softwares melhores e mais confiáveis. Para obter mais informações, confira "Sobre a Open Source Initiative" na Open Source Initiative.

Para obter mais informações sobre como aplicar os princípios de código aberto ao trabalho de desenvolvimento da sua organização no GitHub.com, confira o white paper "Uma introdução ao InnerSource" do GitHub".

Ao criar um repositório público a partir de uma bifurcação do projeto de outra pessoa, confirme que incluiu um arquivo de licença que estabelece como você quer que seu projeto seja compartilhado com outros. Para obter mais informações, confira "Escolher uma licença de código aberto" em choosealicense.com.

Para obter mais informações sobre código aberto, especificamente como criar e expandir um projeto de código aberto, criamos os Guias de Código Aberto, que ajudarão você a promover uma comunidade de código aberto benéfica, recomendando melhores práticas para criar e manter repositórios no seu projeto de código aberto. Você também pode fazer um curso gratuito de GitHub Skills sobre como manter comunidades de código aberto.

Pré-requisitos

Caso ainda não tenha feito isso, primeiro, configure o Git. Não se esqueça de configurar também a autenticação no GitHub.com por meio do Git.

Bifurcar um repositório

Você pode bifurcar um projeto para propor alterações no repositório upstream ou original. Nesse caso, uma boa prática é sincronizar regularmente sua bifurcação com o repositório upstream. Para isso, é necessário usar Git na linha de comando. Você pode praticar a configuração do repositório upstream usando o mesmo repositório octocat/Spoon-Knife do qual acabou de criar um fork.

  1. No GitHub.com, navegue até o repositório octocat/Spoon-Knife.
  2. No canto superior direito da página, clique em Criar Fork. Botão Criar Fork
  3. Selecione um proprietário para o repositório bifurcado. Criar uma página de bifurcação com a lista suspensa do proprietário enfatizada
  4. Por padrão, as bifurcações são nomeadas da mesma forma que os respectivos repositórios pai. Você pode alterar o nome da bifurcação para distingui-la ainda mais. Criar uma página de bifurcação com o campo do nome do repositório enfatizado
  5. Como opção, adicione uma descrição da bifurcação. Criar uma página de bifurcação com o campo de descrição enfatizado
  6. Escolha se deseja copiar apenas o branch padrão ou todos os branches para a nova bifurcação. Para muitos cenários de bifurcação, como contribuir para projetos de código aberto, você só precisa copiar o branch padrão. Por padrão, somente o branch padrão é copiado. Opção para copiar apenas o branch padrão
  7. Clique em Criar bifurcação. Botão Criar bifurcação enfatizado

Observação: se você quiser copiar branches adicionais do repositório pai, poderá fazê-lo na página Branches. Para obter mais informações, confira "Criar e excluir branches no seu repositório".

Para saber mais sobre a GitHub CLI, confira "Sobre a GitHub CLI".

Para criar um fork de um repositório, use o subcomando gh repo fork.

gh repo fork repository

Para criar o fork em uma organização, use o sinalizador --org.

gh repo fork repository --org "octo-org"

Clonando o seu repositório bifurcado

Agora, você tem uma bifurcação do repositório Spoon-Knife, mas você não tem os arquivos desse repositório localmente no seu computador.

  1. No GitHub.com, navegue até o seu fork do repositório Spoon-Knife.

  2. Acima da lista de arquivos, clique em Código. Botão "Código"

  3. Copie a URL do repositório.

    • Para clonar o repositório usando HTTPS, em "HTTPS", clique em .
    • Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade de certificação SSH da sua organização, clique em SSH e em .
    • Para clonar um repositório usando GitHub CLI, clique em GitHub CLI e selecione . O ícone da área de transferência para copiar a URL para clonar um repositório com o CLI do GitHub 1. Abra TerminalTerminalGit Bash. 4. Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.
  4. Digite git clone e cole a URL já copiada. Ela terá esta aparência, com seu nome de usuário do GitHub em vez de YOUR-USERNAME:

    $ git clone https://github.com/YOUR-USERNAME/Spoon-Knife
  5. Pressione Enter. Seu clone local estará criado.

    $ git clone https://github.com/YOUR-USERNAME/Spoon-Knife
    > Cloning into `Spoon-Knife`...
    > remote: Counting objects: 10, done.
    > remote: Compressing objects: 100% (8/8), done.
    > remote: Total 10 (delta 1), reused 10 (delta 1)
    > Unpacking objects: 100% (10/10), done.

Para saber mais sobre a GitHub CLI, confira "Sobre a GitHub CLI".

Para criar um clone do fork, use o sinalizador --clone.

gh repo fork repository --clone=true
  1. No menu Arquivo, clique em Clonar Repositório.

    Opção de menu Clone (Clonar) no app Mac

    Opção de menu Clone (Clonar) no app Windows

    1. Clique na aba que corresponde à localização do repositório que você deseja clonar. Clique também na **URL** para inserir o local do repositório manualmente.

    Guias Location (Local) no menu Clone a repository (Clonar um repositório)

    Guias Location (Local) no menu Clone a repository (Clonar um repositório)

    1. Escolha o repositório que você quer clonar na lista.

    Clonar uma lista de repositórios

    Clonar uma lista de repositórios

    1. Clique em **Escolher…** e procure um caminho local em que deseja clonar o repositório.

    Botão Choose (Escolher)

    Botão Choose (Escolher)

    1. Clique em **Clonar**.

    Botão Clone (Clonar)

    Botão Clone (Clonar)

Configurar o Git para sincronizar a bifurcação com o repositório original

Ao bifurcar um projeto para propor mudanças no repositório original, é possível configurar o Git para fazer pull de alterações do repositório original ou upstream no clone local de sua bifurcação.

  1. No GitHub.com, navegue até o repositório octocat/Spoon-Knife.

  2. Acima da lista de arquivos, clique em Código. Botão "Código"

  3. Copie a URL do repositório.

    • Para clonar o repositório usando HTTPS, em "HTTPS", clique em .
    • Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade de certificação SSH da sua organização, clique em SSH e em .
    • Para clonar um repositório usando GitHub CLI, clique em GitHub CLI e selecione . O ícone da área de transferência para copiar a URL para clonar um repositório com o CLI do GitHub 1. Abra TerminalTerminalGit Bash.
  4. Mude os diretórios para a localidade da bifurcação que você clonou.

    • Para acessar o diretório base, digite apenas cd sem nenhum outro texto.
    • Para listar os arquivos e as pastas do diretório atual, digite ls.
    • Para entrar em um dos diretórios listados, digite cd your_listed_directory.
    • Para subir um diretório, digite cd ...
  5. Digite git remote -v e pressione Enter. Você verá o repositório remoto atual configurado para sua bifurcação.

    $ git remote -v
    > origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
    > origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)
  6. Digite git remote add upstream, cole a URL copiada na Etapa 3 e pressione Enter. Ele terá a seguinte aparência:

    $ git remote add upstream https://github.com/ORIGINAL_OWNER/Spoon-Knife.git
  7. Para verificar o novo repositório upstream especificado para a bifurcação, digite git remote -v novamente. Você verá a URL do fork como origin e a URL do repositório original como upstream.

    $ git remote -v
    > origin    https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
    > origin    https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)
    > upstream  https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (fetch)
    > upstream  https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Agora é possível manter a bifurcação sincronizada com o repositório upstream usando apenas alguns comandos Git. Para obter mais informações, confira "Como sincronizar um fork".

Para saber mais sobre a GitHub CLI, confira "Sobre a GitHub CLI".

Para configurar um repositório remoto para o repositório com fork, use o sinalizador --remote.

gh repo fork repository --remote=true

Para especificar o nome do repositório remoto, use o sinalizador --remote-name.

gh repo fork repository --remote-name "main-remote-repo"

Editando uma bifurcação

Você pode fazer alterações em uma bifurcação, incluindo:

  • Como criar branches: os branches permitem que você crie recursos ou teste ideias sem colocar seu projeto principal em risco.
  • Como abrir solicitações de pull: se você espera contribuir novamente para o repositório original, envie uma solicitação ao autor original para efetuar pull do fork no repositório enviando uma solicitação de pull.

Localize outro repositório para bifurcar

Bifurque um repositório para começar a contribuir com um projeto. Se você tiver acesso a um repositório privado e o proprietário permitir a criação de fork, poderá criar fork do repositório para sua conta pessoal ou uma organização no GitHub Team em que terá permissões de criação de repositório. Não é possível criar forks de um repositório privado em uma organização que usa o GitHub Free. Para obter mais informações, confira "Produtos do GitHub".

Procure Explorar para encontrar projetos e começar a contribuir nos repositórios de código aberto. Para obter mais informações, confira "Como encontrar maneiras de contribuir com o código aberto no GitHub".

Próximas etapas

Você já bifurcou um repositório, treinou clonar sua bifurcação e configurou um repositório upstream.

  • Para obter mais informações sobre como clonar a bifurcação e sincronizar as alterações em um repositório bifurcado usando o seu computador, confira "Configurar o Git".

  • Você também pode criar um novo repositório onde você pode colocar todos os seus projetos e compartilhar o código em GitHub. A criação de um repositório para seu projeto permite que você armazene código no GitHub. Isso fornece um backup do seu trabalho que você pode optar por compartilhar com outros desenvolvedores. Para obter mais informações, confira "Criar um repositório"."

  • Cada repositório em GitHub pertence a uma pessoa ou organização. Você pode interagir com as pessoas, repositórios e organizações, conectando-se e seguindo-as em GitHub. Para obter mais informações, confira "Seja social".

  • O GitHub tem uma ótima comunidade de suporte na qual você pode pedir ajuda e conversar com pessoas de todo o mundo. Participe da conversa na GitHub Community.