Saltar al contenido

Lección 7 de 12 · Lectura y práctica

Push, pull y cloning

📤 Push, Pull y Cloning en GitHub Bienvenido a esta lección fundamental donde aprenderás los tres comandos esenciales para sincronizar tu trabajo local con GitHub: push, pull y clone. Dominar estos comandos es absolutamente.

Del concepto a la práctica

Taller de esta lección

clone crea una copia de un repositorio existente con su historia; push envía commits que tu copia contiene y el remoto acepta; pull trae cambios y los integra. La comprobación de cada operación evita trabajar sobre una carpeta equivocada.

Ejemplo resuelto

Una persona clona un repositorio de avisos en avisos-local, añade una línea a README.md, confirma agrega horario de consulta y publica la rama. En otra carpeta se ejecuta pull y se verifica que aparece exactamente esa línea.

En la segunda copia usa git status --short, después git pull --ff-only y revisa el archivo final. git diff sin argumentos compara cambios sin preparar: tras una actualización limpia no mostrará el cambio que acabas de integrar. Guarda la referencia anterior y compara el rango de commits, o consulta git show HEAD -- README.md.

Pruébalo

  1. Clona el repositorio de práctica en una carpeta nueva.

  2. Comprueba git remote -v y el historial recibido.

  3. Añade una modificación pequeña, crea un commit y usa push.

  4. En otra copia autorizada, ejecuta pull y revisa el diff.

Error frecuente: editar la carpeta padre pensando que es la copia clonada. Corrígelo ejecutando pwd o inspeccionando la ruta antes de editar y confirmando el nombre del repositorio.

Comprueba tu resultado

Ejercicio: compara git log --oneline -1 y el contenido de README.md en ambas copias. El resultado esperado es el mismo commit más reciente y la misma línea añadida, sin cambios pendientes.

Rama de trabajo con commits, pruebas y revisión antes de integrarla en la rama principal.
CursaloMapa de práctica
Cambios pequeños, revisión clara

Los cambios se preparan en una rama y se registran en commits pequeños. Las pruebas y la revisión del pull request comprueban el cambio antes de integrarlo. El historial permite entender qué se modificó y recuperar una versión anterior.

Ver la infografía en tamaño completo ↗
Fuentes para profundizar

📤 Push, Pull y Cloning en GitHub

Bienvenido a esta lección fundamental donde aprenderás los tres comandos esenciales para sincronizar tu trabajo local con GitHub: push, pull y clone. Dominar estos comandos es absolutamente crítico para trabajar eficientemente en equipo.

CONCEPTO CLAVE
Git funciona con un modelo de repositorio local (tu computadora) y repositorio remoto (GitHub). Los comandos push, pull y clone son los puentes que conectan ambos mundos, permitiendo collaboration sin problemas.

🔽 ¿Qué es Clonar un Repositorio?

Cuando quieres trabajar en un proyecto que ya existe en GitHub, necesitas clonarlo a tu máquina local. El comando git clone descarga todo el repositorio completo, incluyendo su historial de commits, ramas y archivos.

git clone https://github.com/usuario/nombre-repositorio.git

Este comando crea automáticamente:

  • Una carpeta con el nombre del repositorio
  • Una conexión remota llamada origin apuntando al repositorio de GitHub
  • Una copia completa de todo el código y su historial
💡 Tip: Puedes clonar en una carpeta específica usando git clone https://github.com/usuario/repo.git nombre-carpeta. Esto crea una carpeta con el nombre que elijas en lugar del nombre del repositorio.

📤 Empujando Cambios con Push

Una vez que has hecho cambios localmente y los has confirmado con git commit, necesitas subirlos a GitHub para que otros miembros del equipo puedan verlos. Esto se hace con git push.

  1. Haz cambios en tus archivos usando tu editor de código favorito.
  2. Prepara los cambios: git add archivo-modificado.js o git add . para todos los archivos.
  3. Crea un commit: git commit -m "Mensaje descriptivo del cambio"
  4. Envía los cambios: git push origin nombre-rama
# Ejemplo completo de push
git add .
git commit -m "Agregar validación de formulario de registro"
git push origin develop
📌 Recuerda: El comando push solo funciona si tienes permiso de escritura en el repositorio remoto. Si clonaste un repositorio público, necesitarás hacer un fork primero o que te añadan como colaborador.

📥 Trayendo Cambios con Pull

Cuando trabajas en equipo, otros desarrolladores estarán subiendo cambios constantemente. Para mantener tu código actualizado con lo último del repositorio remoto, usas git pull.

git pull origin main

El comando git pull hace dos cosas simultáneamente:

  1. Fetch: Descarga los cambios del remoto
  2. Merge: Integra esos cambios con tu rama actual
⚠️ Advertencia: Si tienes cambios locales sin commitear, git pull podría causar conflictos. Siempre haz commit de tus cambios antes de hacer pull, o aprende a usar git stash para guardarlos temporalmente.

⚙️ Fetch vs Pull: ¿Cuál Usar?

Existe una diferencia importante entre estos dos comandos:

Comando Qué hace Cuándo usarlo
git fetch Solo descarga cambios, no los integra Cuando quieres revisar cambios antes de aplicarlos
git pull Descarga Y fusiona cambios automáticamente Cuando estás seguro de que quieres integrar los cambios
💡 Buena práctica: Algunos desarrolladores prefieren usar git fetch primero, revisar los cambios con git log origin/main, y luego hacer merge manualmente. Esto te da más control sobre qué cambios acepta tu rama.

🔗 Entendiendo los Remotes

Un remote es una conexión a un repositorio en otro lugar (generalmente GitHub). Cuando clonas un repositorio, Git automáticamente crea un remote llamado origin que apunta al repositorio original.

Puedes ver tus remotes con:

git remote -v

La salida típica sería:

origin  https://github.com/usuario/repo.git (fetch)
origin  https://github.com/usuario/repo.git (push)
Ver más: Trabajando con múltiples remotes

En proyectos grandes, podrías necesitar añadir múltiples remotes. Por ejemplo:

# Añadir un remote adicional
git remote add upstream https://github.com/proyecto-original/repo.git

# Sincronizar desde el repositorio original
git fetch upstream
git merge upstream/main

Esto es común en proyectos de código abierto donde haces fork de un repositorio y quieres mantener tu copia sincronizada con el original.

🌿 Empujando Ramas Nuevas

Cuando creas una nueva rama local y quieres subirla a GitHub por primera vez, necesitas especificarla:

# Crear y cambiar a nueva rama
git checkout -b feature/nueva-funcionalidad

# Hacer cambios y commits...

# Empujar la nueva rama por primera vez
git push -u origin feature/nueva-funcionalidad

El flag -u (o --set-upstream) establece una relación de seguimiento entre tu rama local y la rama remota. Después de esto, simplemente puedes usar git push sin especificar origin ni el nombre de la rama.

"La primera vez que empujas una rama, usa -u. Es como presentar tu rama local al mundo—después podrán encontrarse fácilmente."

⚠️ Manejo de Conflictos

A veces, cuando haces git pull, Git no puede fusionar automáticamente los cambios porque tú y otro desarrollador editaron las mismas líneas. Esto se llama conflicto de fusión.

  1. Git te avisa sobre los archivos en conflicto con el mensaje: "Merge conflict in archivo.js"
  2. Abre el archivo y busca los marcadores de conflicto: <<<<<<< HEAD, =======, >>>>>>>
  3. Decide qué código mantener: el tuyo, el del remoto, o una combinación de ambos
  4. Elimina los marcadores de conflicto
  5. Guarda, añade y haz commit: git add . y git commit
⚠️ Importante: Nunca ignores los conflictos de fusión. Resuélvelos siempre antes de continuar. Si no estás seguro de cómo resolver un conflicto, comunica con el equipo—probablemente la persona que hizo los cambios puede ayudarte.

📊 Flujo de Trabajo Típico en Equipo

Este es el ciclo de trabajo diario que seguirás la mayoría de las veces:

# Al comenzar el día
git pull origin main           # Actualizar con últimos cambios

git checkout -b feature/tarea-123   # Crear rama para tu trabajo

# Durante el día
# ... hacer cambios en código ...
git add .
git commit -m "Implementar lógica de autenticación"

# Al terminar
git push -u origin feature/tarea-123   # Subir rama por primera vez
# Crear Pull Request en GitHub
📌 Flujo recomendado: Es buena práctica hacer pull al inicio de cada sesión de trabajo y antes de crear un Pull Request para asegurarte de que tu código se basa en la versión más reciente.

🎯 Buenas Prácticas

  • Commits frecuentes y pequeños: Haz commit de tus cambios regularmente, no esperes a terminar todo el proyecto.
  • Mensajes descriptivos: Escribe mensajes que expliquen el por qué, no solo el qué.
  • Pull antes de push: Siempre intenta hacer pull antes de push para minimizar conflictos.
  • Ramas para todo: Evita hacer push directamente a main. Usa ramas feature.
Ver más: Atajos útiles

Existen formas simplificadas de usar estos comandos:

# Push a la rama actual sin especificar origen
# (funciona si ya hiciste push con -u antes)
git push

# Pull de la rama que seguimiento establecida
git pull

# Push todas las ramas
git push --all origin

También puedes configurar Git para que siempre haga pull con rebase en lugar de merge:

git config --global pull.rebase true

🔒 Permisos y Autenticación

Para hacer push a repositorios en GitHub, necesitas autenticarte. GitHub recomienda usar:

  • GitHub CLI: gh auth login
  • Token de acceso personal (PAT): Generado desde GitHub → Settings → Developer settings
  • SSH: Usando claves SSH en lugar de HTTPS
💡 Configuración SSH recomendada: Si usas frecuentemente GitHub, configura SSH. Es más seguro y no necesitas escribir tu contraseña cada vez:
ssh-keygen -t ed25519 -C "tu-email@ejemplo.com"
gh ssh-key add ~/.ssh/id_ed25519.pub

📝 Resumen de Comandos

Comando Función Ejemplo
git clone Clona un repositorio completo git clone url-del-repo
git push Envía commits al remoto git push origin main
git pull Descarga e integra cambios del remoto git pull origin main
git fetch Descarga cambios sin fusionar git fetch origin
git remote -v Muestra remotes configurados git remote -v
🧠 Quiz

¿Qué comando usarías para descargar una copia completa de un repositorio existente en GitHub a tu computadora local?

  • A) git download
  • B) git clone
  • C) git copy
  • D) git fetch
✅ Respuesta correcta: B) git clone. Este comando descarga todo el repositorio incluyendo historial, ramas y archivos. git fetch solo descarga información sobre cambios pero no integra nada.
🧠 Quiz

¿Cuál es la diferencia principal entre git pull y git fetch?

  • A) No hay diferencia, son sinónimos
  • B) pull descarga y fusiona, fetch solo descarga
  • C) fetch es más rápido que pull
  • D) pull es solo para ramas, fetch para todo
✅ Respuesta correcta: B) git pull hace fetch + merge automáticamente, mientras que git fetch solo descarga los cambios del remoto sin integrarlos en tu código.
🧠 Quiz

¿Qué significa el flag -u cuando haces git push -u origin mi-rama?

  • A) Actualiza el repositorio remoto
  • B) Establece relación de seguimiento entre ramas
  • C) Fuerza el push sin importar qué
  • D) Deshace el último commit
✅ Respuesta correcta: B) El flag -u (--set-upstream) establece una relación de seguimiento para que en el futuro puedas usar simplemente git push sin especificar origin y la rama.

🎓 Conclusión

Ahora tienes las herramientas fundamentales para sincronizar tu trabajo entre tu computadora y GitHub. Recuerda:

  • Clone para comenzar—obtén el proyecto a tu máquina
  • Pull para mantenerte actualizado—trae los cambios del equipo
  • Push para compartir—envía tu trabajo al mundo
📌 Próximos pasos: Practica estos comandos creando un repositorio de prueba. Haz cambios, súbelo con push, y desde otra carpeta clónalo y verifica que ves tus cambios. La práctica es la mejor manera de dominar Git.

En la siguiente lección aprenderás sobre Pull Requests, el mecanismo principal para proponer y revisar cambios en equipos que usan GitHub. ¡Sigue adelante!

Sigue con Git y GitHub para Equipos

Esta lección forma parte de un curso de Cursalo. Revisa su programa y elige entre la compra individual o el acceso a toda la escuela.

Si ya tenías acceso a este curso, entra con tu cuenta: tus derechos y tu progreso se conservan. No necesitas comprarlo de nuevo.

01 / ELEGIR UNA RUTA

El próximo paso

Aprende IA mientras construyes algo que sí necesitas.

Empieza por el curso inicial o explora el catálogo para encontrar una práctica alineada con tu trabajo.