Bifurcar un repositorio

Casi siempre las bifurcaciones se usan para proponer cambios al proyecto de otra persona o para usar el proyecto de otra persona como inicio de tu propia idea.

Proponer cambios para el proyecto de otra persona

Por ejemplo, puedes utilizar ramificaciones para proponer cambios relacionados con arreglar un error. En lugar de registrar una propuesta para un error que has encontrado, puedes hacer lo siguiente:

• Bifurcar el repositorio.
• Solucionar el problema.
• Enviar una solicitud de extracción al propietario del proyecto.

Usar el proyecto de otra persona como inicio de tu propia idea

El software de código abierto se basa en la idea de que, si compartimos el código, podemos crear software más confiable y mejor. Para obtener más información, consulta la sección "Acerca de la Iniciativa de Código Abierto" en la iniciativa de Código Abierto.

Cuando creas tu repositorio público desde una ramificación del proyecto de alguien más, asegúrate de incluir el archivo de licencia que determine cómo quieres que se comparta tu proyecto con los demás. Para obtener más información, consulta "Escoger una licencia de código abierto" en choosealicense.

Para obtener más información acerca del código abierto, específicamente sobre cómo crear y hacer crecer un proyecto de código abierto, hemos creado las Guías de Código Abierto que te ayudarán fomentar una comunidad saludable mediante la recomendación de mejores prácticas para crear y mantener repositorios para tus proyectos de código abierto.También puedes tomar un curso gratuito de Laboratorio de aprendizaje de GitHub sobre cómo mantener comunidades de código abierto.

Bifurcar un repositorio a modo de ejemplo

Bifurcar un repositorio es un proceso muy simple que lleva dos pasos. Hemos creado un repositorio para que practiques.

1. En tu instancia de servidor de GitHub Enterprise, dirígete al repositorio octocat/Spoon-Knife.
2. En el ángulo superior derecho de la página, haz clic en Bifurcar.
   

Mantener tu bifurcación sincronizada

Puedes ramificar un proyecto para proponer cambios en los repositorios precedentes u originales. En este caso, es una buena práctica sincronizar tu bifurcación periódicamente con el repositorio ascendente. Para hacerlo, deberás usar Git en la línea de comando. Puedes practicar cómo configurar el repositorio precedente utilizando el mismo repositorio octocat/Spoon-Knife que acabas de ramificar.

Paso 1: Configurar Git

Si todavía no lo has hecho, primero debes configurar Git. No olvides configurar la autenticación a tu instancia de servidor de GitHub Enterprise desde Git.

Paso 2: Crear un clon local de tu bifurcación

Ahora tienes una bifurcación del repositorio Spoon-Knife, pero no tienes los archivos de ese repositorio en tu computadora. Creemos un clon de tu bifurcación en tu computadora.

1. En GitHub Enterprise, dirígete a tu bifurcación del repositorio Spoon-Knife.

2. Debajo del nombre del repositorio, da clic en Clonar o descargar.

   

3. Para clonar el repositorio utilizando HTTPS, debajo de "Clonar con HTTPS", da clic en . Para clonar el repositorio utilizando una llave SSH da clic en Utilizar SSH, y después en .

   

4. Abre la TerminalTerminalGit Bash.

5. Escribe git clone, y luego pega la URL que copiaste antes. Se verá así, con tu nombre de usuario de GitHub Enterprise en lugar de YOUR-USERNAME:

   $ git clone https://nombre de host/YOUR-USERNAME/Spoon-Knife

6. Presiona Enter (Intro). Se creará tu clon local.

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

Ahora tienes una copia local de tu ramificación en el repositorio Spoon-Knife.

Paso 3: Configurar Git para sincronizar tu bifurcación con el repositorio original Spoon-Knife

Cuando bifurcas un proyecto para proponer cambios en el repositorio original, puedes configurar Git para extraer cambios del original, o repositorio ascendente, en el clon local de tu bifurcación.

1. En GitHub Enterprise, dirígete al repositorio octocat/Spoon-Knife.

2. Debajo del nombre del repositorio, da clic en Clonar o descargar.

   

3. Para clonar el repositorio utilizando HTTPS, debajo de "Clonar con HTTPS", da clic en . Para clonar el repositorio utilizando una llave SSH da clic en Utilizar SSH, y después en .

   

4. Abre la TerminalTerminalGit Bash.

5. Cambia los directorios a la ubicación de la bifurcación que clonaste en el Paso 2: Crear un clon local de tu bifurcación.

   • Para ir a tu directorio de inicio, escribe solo cd sin ningún otro texto.
   • Para generar una lista de los archivos y carpetas en tu directorio actual, escribe ls.
   • Para ir a uno de los directorios de la lista, escribe cd your_listed_directory.
   • Para subir un directorio, escribe cd ...

6. Escribe git remote -v y presiona Intro. Verás el repositorio remoto configurado actualmente para tu bifurcación.

   $ git remote -v
   > origin  https://nombre de host/YOUR_USERNAME/YOUR_FORK.git (fetch)
   > origin  https://nombre de host/YOUR_USERNAME/YOUR_FORK.git (push)

7. Escribe git remote add upstream y luego pega la URL que copiaste en el Paso 2 y presiona Intro. Se verá así:

   $ git remote add upstream https://nombre de host/octocat/Spoon-Knife.git

8. Para verificar el nuevo repositorio ascendente que has especificado para tu bifurcación, escribe nuevamente git remote -v. Debes ver la URL para tu bifurcación como origin y la URL para el repositorio original como upstream.

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

Ahora, puedes mantener tu bifurcación sincronizada con el repositorio ascendente con unos pocos comandos Git. Para obtener más información, consulta "Sincronizar una bifurcación".

Pasos siguientes

Puedes hacer cualquier cambio a una ramificación, incluyendo:

• Crear ramas: Las ramas te permiten diseñar nuevas características o probar ideas sin poner en riesgo tu proyecto principal.
• Abrir solicitudes de extracción: Si deseas colaborar con el repositorio original, puedes enviar una solicitud al autor original para extraer tu bifurcación en su repositorio enviando una solicitud de extracción.

Encontrar otro repositorio para bifurcar

Bifurca un repositorio para comenzar a colaborar con un proyecto. Puedes bifurcar cualquier repositorio público en tu cuenta de usuario o en cualquier organización en donde tengas permiso para crear repositorios. Para obtener más información, consulta "Niveles de permisos para una organización".

Para bifurcar cualquier repositorio, puedes acceder a tu cuenta de usuario y a cualquier organización en GitHub Team o GitHub Enterprise donde tengas permisos de creación de repositorios. No puedes bifurcar repositorios privados en una organización utilizando GitHub Free.

A celebrar

Ahora ya has bifurcado un repositorio, has practicado la clonación de tu bifurcación y has configurado un repositorio ascendente. ¿Qué deseas hacer ahora?

• "Configurar Git"
• "Crear un repositorio"
• "Socializar"
• Conéctate con personas de todo el mundo en el Soporte de la Comunidad de GitHub