Bifurcar un repositorio
Una bifurcación es una copia de un repositorio. Bifurcar un repositorio te permite experimentar libremente con cambios sin afectar el proyecto original.
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
Un gran ejemplo del uso de bifurcaciones para proponer cambios se da con el propósito de solucionar errores. 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.
Si el propietario del proyecto está de acuerdo con tu trabajo, puede extraer tu solución en el repositorio original.
Usar el proyecto de otra persona como inicio de tu propia idea
En el concepto del código abierto reside la idea de que al compartir código, podemos diseñar un software mejor y más confiable.
Cuando crees tu repositorio público a partir de una bifurcación del proyecto de otra persona, asegúrate de incluir un archivo de licencia que determine cómo deseas que tu proyecto se comparta con otros.
Para obtener más información acerca del código abierto, específicamente cómo crear e incrementar un proyecto de código abierto, hemos creado Guías de código abierto que te ayudarán a desarrollar una comunidad de código abierto con la recomendación de las mejores prácticas para crear y mantener repositorios para tu proyecto de código abierto. También puedes hacer un curso gratis de Laboratorio de aprendizaje de GitHub para conocer más sobre el mantenimiento de 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 lo uses para practicar.
- En tu instancia de servidor de GitHub Enterprise, dirígete al repositorio octocat/Spoon-Knife.
- En el ángulo superior derecho de la página, haz clic en Bifurcar.
¡Listo! Ahora tienes una bifurcación del repositorio original octocat/Spoon-Knife.
Mantener tu bifurcación sincronizada
Puedes bifurcar un proyecto para proponer cambios al repositorio ascendente u original. 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 establecer el repositorio ascendente usando el mismo repositorio octocat/Spoon-Knife que acabas de bifurcar.
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.
-
En GitHub Enterprise, dirígete a tu bifurcación del repositorio 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 .
-
Abre el terminal TerminalTerminalGit Bash.
-
Escribe
git clone
, y luego pega la URL que copiaste antes. Se verá así, con tu nombre de usuario de GitHub Enterprise en lugar deYOUR-USERNAME
:$ git clone https://nombre de host/YOUR-USERNAME/Spoon-Knife
-
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 tu bifurcación del 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.
-
En GitHub Enterprise, dirígete al repositorio 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 .
-
Abre el terminal TerminalTerminalGit Bash.
-
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 ..
.
- Para ir a tu directorio de inicio, escribe solo
-
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)
-
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
-
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 comoorigin
y la URL para el repositorio original comoupstream
.$ 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
No hay límites para los cambios que puedes hacer en un bifurcación, entre otros:
- Creating branches: Branches allow you to build new features or test out ideas without putting your main project at risk.
- 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 para tu cuenta de usuario o cualquier organización en la que tengas permisos de creación de repositorios. Para obtener más información, consulta "Niveles de permisos para una organización".
Puedes bifurcar cualquier repositorio privado al que tengas acceso para tu cuenta de usuario o cualquier organización en el Equipo de GitHub o en la GitHub Enterprise sobre la que tengas permisos de creación de repositorios.
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"
- Bifurcar un repositorio
- "Socializar"
- Ponte en contacto con personas de todo el mundo en [Foro de la comunidad de GitHub] (https://github.community)