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.

1. No Em sua empresa, navegue até o repositório octocat/Spoon-Knife.

2. No canto superior direito da página, clique em Criar Fork.

   

3. Em "Proprietário", selecione o menu suspenso e clique em um proprietário do repositório com fork.

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

5. Opcionalmente, no campo "Descrição", digite uma descrição do fork.

6. Clique em Criar bifurcação.

1. Em sua empresa, navegue até o 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 a GitHub CLI, clique em GitHub CLI e em .

     

4. Abra TerminalTerminalGit Bash.

5. Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.

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

7. 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 Em sua empresa, 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 a GitHub CLI, clique em GitHub CLI e em .

     

4. Abra TerminalTerminalGit Bash.

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

6. 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)
   

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

8. 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 upstream 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 "Sincronizar uma bifurcação".