Sobre bifurcações
Um fork é um novo repositório que compartilha configurações de código e visibilidade com o repositório "upstream" original. Os forks geralmente são usados para iterar ideias ou alterações antes de serem propostas de volta para o repositório upstream, como em projetos código aberto ou quando um usuário não tem acesso de gravação ao repositório upstream. Para saber mais, confira "Trabalhar com bifurcações".
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 uma 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 de como aplicar os princípios de código aberto ao trabalho de desenvolvimento da organização em sua instância do GitHub Enterprise Server, 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
Se ainda não tiver feito isso, primeiro configure o Git e a autenticação com sua instância do GitHub Enterprise Server do Git. Para obter mais informações, confira "Configurar o git".
Bifurcar um repositório
Você pode criar fork de um projeto para propor alterações no repositório upstream. 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.
-
No Em sua instância do GitHub Enterprise Server, navegue até o repositório octocat/Spoon-Knife.
-
No canto superior direito da página, clique em Criar Fork.
-
Em "Proprietário", selecione o menu suspenso e clique em um proprietário do repositório com fork.
-
Por padrão, os forks são nomeados da mesma forma que os respectivos repositórios pai. Opcionalmente, para distinguir ainda mais o fork, no campo "Nome do repositório", digite um nome.
-
Opcionalmente, no campo "Descrição", digite uma descrição do fork.
-
Opcionalmente, selecione Copiar somente o branch PADRÃO.
Para muitos cenários de bifurcação, como contribuir para projetos de código aberto, você só precisa copiar o branch padrão. Se você não selecionar essa opção, todos os branches serão copiados para o novo fork.
-
Clique em Criar bifurcação.
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 repositório".
Para saber mais sobre GitHub CLI, confira "Sobre o a CLI do GitHub".
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"
É possível criar fork do repositório noGitHub.com ou no GitHub Desktop. Para obter informações sobre a bifurcação no GitHub.com, confira a versão do navegador da Web deste artigo.
No GitHub Desktop, se você tentar clonar um repositório ao qual não tem acesso de gravação, um fork será criado automaticamente para você.
-
No menu Arquivo, clique em Clonar Repositório.
-
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.
-
Na lista de repositórios, clique no repositório que você deseja clonar.
-
Para selecionar o diretório local no qual você deseja clonar o repositório, ao lado do campo "Caminho Local", clique em Escolher... e navegue até o diretório.
-
Na parte inferior da janela "Clonar um Repositório", clique em Clonar.
-
Leia as informações em "Como você está planejando usar essa bifurcação?" .
- Se você pretende usar esse fork para contribuir com o repositório upstream original, clique em Para contribuir com o projeto pai.
- Se você pretende usar esse fork para um projeto não conectado ao upstream, clique em Para minhas próprias finalidades.
-
Clique em Continuar.
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.
-
Em sua instância do GitHub Enterprise Server, navegue até o fork do repositório Spoon-Knife.
-
Acima da lista de arquivos, clique em Código.
-
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 a GitHub CLI, clique em GitHub CLI e em .
-
-
Abra TerminalTerminalGit Bash.
-
Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.
-
Digite
git clone
e cole a URL já copiada. Ela terá esta aparência, com seu nome de usuário do GitHub Enterprise Server em vez deYOUR-USERNAME
:git clone https://HOSTNAME/YOUR-USERNAME/Spoon-Knife
-
Pressione Enter. Seu clone local estará criado.
$ git clone https://HOSTNAME/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 GitHub CLI, confira "Sobre o a CLI do GitHub".
Para criar um clone do fork, use o sinalizador --clone
.
gh repo fork REPOSITORY --clone=true
-
No menu Arquivo, clique em Clonar Repositório.
-
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.
-
Na lista de repositórios, clique no repositório que você deseja clonar.
-
Para selecionar o diretório local no qual você deseja clonar o repositório, ao lado do campo "Caminho Local", clique em Escolher... e navegue até o diretório.
-
Na parte inferior da janela "Clonar um Repositório", clique em Clonar.
Configurar o Git para sincronizar o fork com o repositório upstream
Ao criar fork em um projeto para propor mudanças no repositório original, é possível configurar o Git para fazer pull de alterações do repositório upstream no clone local do fork.
-
No Em sua instância do GitHub Enterprise Server, navegue até o repositório octocat/Spoon-Knife.
-
Acima da lista de arquivos, clique em Código.
-
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 a GitHub CLI, clique em GitHub CLI e em .
-
-
Abra TerminalTerminalGit Bash.
-
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 ..
.
- Para acessar o diretório base, digite apenas
-
Digite
git remote -v
e pressione Enter. Você verá o repositório remoto atual configurado para sua bifurcação.$ git remote -v > origin https://HOSTNAME/YOUR-USERNAME/YOUR-FORK.git (fetch) > origin https://HOSTNAME/YOUR-USERNAME/YOUR-FORK.git (push)
-
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://HOSTNAME/ORIGINAL-OWNER/Spoon-Knife.git
-
Para verificar o novo repositório upstream especificado para a bifurcação, digite
git remote -v
novamente. Você verá a URL do fork comoorigin
e a URL do repositório upstream comoupstream
.$ git remote -v > origin https://HOSTNAME/YOUR-USERNAME/YOUR-FORK.git (fetch) > origin https://HOSTNAME/YOUR-USERNAME/YOUR-FORK.git (push) > upstream https://HOSTNAME/ORIGINAL-OWNER/ORIGINAL-REPOSITORY.git (fetch) > upstream https://HOSTNAME/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 "Sincronizar uma bifurcação".
Para saber mais sobre GitHub CLI, confira "Sobre o a CLI do GitHub".
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ê deseja contribuir novamente para o repositório upstream, 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. Você poderá criar forks de um repositório privado ou interno para sua conta pessoal ou para uma organização em sua instância do GitHub Enterprise Server, em que você tem permissão para criar repositórios, contanto que as configurações do repositório e das políticas corporativas permitam a criação de forks. Em geral, você pode criar fork em qualquer repositório público para sua conta pessoal ou para uma organização em que tenha permissão para criar repositórios.
Para saber mais sobre quando você pode criar fork de um repositório, confira "Sobre permissões e visibilidade de bifurcações".
Próximas etapas
Você já bifurcou um repositório, treinou clonar sua bifurcação e configurou um repositório upstream.
-
Para saber mais sobre como clonar o fork e sincronizar as alterações em um repositório com fork 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 "Início rápido para repositórios".
-
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 Enterprise Server. Para obter mais informações, confira "Encontrando inspiração no GitHub".
-
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.