Versão do artigo: Enterprise Server 2.17
Bifurcar um repo
A fork is a copy of a repository. Bifurcar um repositório permite que você faça experiências à vontade sem comprometer o projeto original.
O uso mais comum das bifurcações são propostas de mudanças no projeto de alguma outra pessoa ou o uso do projeto de outra pessoa como ponto de partida para sua própria ideia.
Proponha mudanças no projeto de outra pessoa
For example, you can use forks to propose changes related to fixing a bug. Em vez de registrar um erro encontrado, é possível:
- Bifurcar o 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.
Open source software is based on the idea that by sharing code, we can make better, more reliable software. For more information, see the “About the Open Source Initiative" on the Open Source Initiative.
When creating your public repository from a fork of someone's project, make sure to include a license file that determines how you want your project to be shared with others. For more information, see “Choose an open source license" at choosealicense.
For more information on open source, specifically how to create and grow an open source project, we've created Open Source Guides that will help you foster a healthy open source community by recommending best practices for creating and maintaining repositories for your open source project. You can also take a free GitHub Learning Lab course on maintaining open source communities.
Note: You can use GitHub Desktop to fork a repository. For more information, see “Cloning and forking repositories from GitHub Desktop."
Bifurque um exemplo de repositório
Bifurcar um repositório é um processo fácil, de duas etapas. Criamos um repositório para você usar para treinar.
- 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 Fork (Bifurcação).
Mantenha sua bifurcação sincronizada
You might fork a project to propose changes to the upstream, or original, repository. 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. Pratique configurando o repositório upstream com o mesmo repositório octocat/Spoon-Knife que você acabou de bifurcar.
Etapa 1: Configure o Git
Se ainda não o fez, primeiro configure o Git. Lembre-se também de configurar a autenticação para sua instância do GitHub Enterprise Server a partir do Git.
Etapa 2: Crie um clone local de sua bifurcação
Agora você tem uma bifurcação do repositório Spoon-Knife, mas não os arquivos daquele repositório em seu computador. Vamos criar um clone da bifurcação localmente em seu computador.
-
Em GitHub Enterprise, vá até your fork (sua bifurcação) no repositório Spoon-Knife.
-
Under the repository name, click Clone or download.
-
To clone the repository using HTTPS, under "Clone with HTTPS", click . To clone the repository using an SSH key click Use SSH, then click .
-
Open TerminalTerminalGit Bash.
-
Digite
git clone
(clonar git) e cole a URL que você copiou anteriormente. Ficará assim, com seu GitHub Enterprise nome de usuário no lugar 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: Contando objetos: 10, concluído. > remote: Compactando objetos: 100% (8/8), concluído. > remove: Total 10 (delta 1), reused 10 (delta 1) > Unpacking objects: 100% (10/10), done.
Agora você já tem uma cópia local de sua bifurcação do repositório Spoon-Knife.
Etapa 3: Configure o Git para sincronizar sua bifurcação com o repositório Spoon-Knife original
Ao bifurcar um projeto para propor mudanças no repositório original, é possível configurar o Git para fazer pull de mudanças do repositório original ou upstream no clone local de sua bifurcação.
-
Em GitHub Enterprise, vá até o repositório octocat/Spoon-Knife.
-
Under the repository name, click Clone or download.
-
To clone the repository using HTTPS, under "Clone with HTTPS", click . To clone the repository using an SSH key click Use SSH, then click .
-
Open TerminalTerminalGit Bash.
-
Mude os diretórios do local que você clonou a bifurcação na Etapa 2: Crie um clone local de sua bifurcação.
- Para acessar seu diretório pessoal, apenas digite
cd
sem nenhum outro texto. - Para listar os arquivos e pastas em seu diretório atual, digite
ls
. - Para acessar um dos diretórios listados, digite
cd your_listed_directory
. - Para acessar um diretório, digite
cd ..
.
- Para acessar seu diretório pessoal, apenas digite
-
Digite
git remote -v
e pressione Enter. Você verá o repositório remote 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 que você copiou na etapa 2 e pressione Enter. Ficará assim:$ git remote add upstream https://hostname/octocat/Spoon-Knife.git
-
Para verificar o novo repositório upstream que você especificou para sua bifurcação, digite novamente
git remote -v
. Você deverá visualizar a URL da sua bifurcação comoorigin
(origem) e a URL do repositório original 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, consulte "Sincronizar uma bifurcação".
Próximas etapas
You can make any changes to a fork, including:
- Criar branches: os branches permitem desenvolver novos recursos ou testar novas ideias sem colocar o projeto atual em risco.
- Abrir pull requests: caso queira fazer contribuições no repositório original, ao enviar uma pull request, você pode solicitar que o autor do repositório original faça pull de sua bifurcação no repositório dele.
Localize outro repositório para bifurcar
Bifurque um repositório para começar a contribuir com um projeto. You can fork any public repository to your user account or any organization where you have repository creation permissions. Para obter mais informações, consulte "Níveis de permissão para uma organização".
You can fork any private repository you can access to your user account and any organization on GitHub Team or GitHub Enterprise where you have repository creation permissions. You cannot fork a private repository to an organization using GitHub Free.
Comemore
Você já bifurcou um repositório, treinou clonar sua bifurcação e configurou um repositório upstream. O que quer fazer agora?
- "Configurar o Git"
- "Criar um repositório"
- "Socializar"
- Connect with people around the world in the GitHub Community Support