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 your enterprise, navegue até o repositório octocat/Spoon-Knife.
2. No canto superior direito da página, clique em Criar Fork.
3. Selecione um proprietário para o repositório bifurcado.
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.
5. Como opção, adicione uma descrição da bifurcação.
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.
7. Clique em Criar bifurcação.

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

2. Acima da lista de arquivos, clique em 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 . 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 AE em vez de YOUR-USERNAME:

   $ git clone https://hostname/YOUR-USERNAME/Spoon-Knife

5. 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.

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

2. Acima da lista de arquivos, clique em 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 . 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://hostname/YOUR_USERNAME/YOUR_FORK.git (fetch)
   > origin  https://hostname/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://hostname/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://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 "Como sincronizar um fork".