Title: Repositorios Remotos y GitHub
Course: 2025 - LISI/LI - Desarrollo de Software Avanzado > Section: Github

🎯 Objetivo

Aprender a conectar un repositorio local con GitHub, clonar repositorios remotos, sincronizar cambios (push / pull) y comprender el flujo básico de colaboración usando la terminal.

🧩 Temas de la Unidad 2

1️⃣ Qué es un repositorio remoto

Un repositorio remoto es una versión del proyecto almacenada en la nube, que permite compartir el código con otros usuarios y colaborar en equipo.

- El repositorio local vive en tu computadora.
- El repositorio remoto vive en una plataforma como GitHub.

💡 Git permite que trabajes de forma local, y luego sincronices tus avances con el remoto.

2️⃣ Clonar un repositorio existente

Cuando un proyecto ya existe en GitHub, puedes obtener una copia en tu computadora mediante el comando:

git clone <url>


Este comando descarga todo el historial del proyecto y crea una copia local lista para trabajar.

Ejemplo:

git clone https://github.com/usuario/proyecto.git


3️⃣ Conectar un repositorio local a GitHub

Si creas un proyecto desde cero en tu computadora, puedes vincularlo a un repositorio remoto para sincronizarlo con GitHub.

Comandos principales:

git remote add origin <url>


👉 Vincula tu repositorio local con el remoto (llamado “origin”).

git remote -v


👉 Muestra las conexiones actuales (lectura y escritura) con el repositorio remoto.

4️⃣ Sincronización básica entre local y remoto

Git permite enviar y recibir cambios para mantener ambos repositorios actualizados.

Comandos principales:

- git push origin main → Sube tus commits al repositorio remoto.
- git pull origin main → Trae los cambios del remoto al local y los combina.
- git fetch → Descarga los cambios del remoto sin fusionarlos todavía.

💡 Push = subir | Pull = bajar | Fetch = ver sin mezclar.

5️⃣ Manejo inicial de conflictos

Los conflictos ocurren cuando dos personas modifican la misma parte de un archivo en diferentes versiones del repositorio.
Git te avisa para que decidas qué versión conservar.

- Usa git status para ver los archivos en conflicto.
- Edita los archivos y elimina las marcas (<<<<, ====, >>>>).
- Guarda los cambios y ejecuta git add seguido de git commit para resolverlo.

💡 Los conflictos no son errores, son decisiones que debes tomar como desarrollador.

6️⃣ Buenas prácticas en repositorios remotos

1. Usa .gitignore para evitar subir archivos innecesarios (por ejemplo, configuraciones locales o dependencias).
2. Escribe mensajes de commit claros y descriptivos.
Ejemplo: git commit -m "Corrige error en validación de formulario"
3. Sincroniza frecuentemente (usa git pull antes de trabajar y git push después de tus cambios).
4. Documenta tu proyecto usando un archivo README.md con una descripción, instrucciones y autores.
5. Haz commits pequeños y frecuentes, para que sea más fácil identificar errores y retroceder si es necesario.

🎯 Objetivo

Aprender a conectar un repositorio local con GitHub, clonar repositorios remotos, sincronizar cambios (push / pull) y comprender el flujo básico de colaboración usando la terminal.

🧩 Temas de la Unidad 2

1️⃣ Qué es un repositorio remoto

Un repositorio remoto es una versión del proyecto almacenada en la nube, que permite compartir el código con otros usuarios y colaborar en equipo.

- El repositorio local vive en tu computadora.
- El repositorio remoto vive en una plataforma como GitHub.

💡 Git permite que trabajes de forma local, y luego sincronices tus avances con el remoto.

2️⃣ Clonar un repositorio existente

Cuando un proyecto ya existe en GitHub, puedes obtener una copia en tu computadora mediante el comando:

git clone <url>


Este comando descarga todo el historial del proyecto y crea una copia local lista para trabajar.

Ejemplo:

git clone https://github.com/usuario/proyecto.git


3️⃣ Conectar un repositorio local a GitHub

Si creas un proyecto desde cero en tu computadora, puedes vincularlo a un repositorio remoto para sincronizarlo con GitHub.

Comandos principales:

git remote add origin <url>


👉 Vincula tu repositorio local con el remoto (llamado “origin”).

git remote -v


👉 Muestra las conexiones actuales (lectura y escritura) con el repositorio remoto.

4️⃣ Sincronización básica entre local y remoto

Git permite enviar y recibir cambios para mantener ambos repositorios actualizados.

Comandos principales:

- git push origin main → Sube tus commits al repositorio remoto.
- git pull origin main → Trae los cambios del remoto al local y los combina.
- git fetch → Descarga los cambios del remoto sin fusionarlos todavía.

💡 Push = subir | Pull = bajar | Fetch = ver sin mezclar.

5️⃣ Manejo inicial de conflictos

Los conflictos ocurren cuando dos personas modifican la misma parte de un archivo en diferentes versiones del repositorio.
Git te avisa para que decidas qué versión conservar.

- Usa git status para ver los archivos en conflicto.
- Edita los archivos y elimina las marcas (<<<<, ====, >>>>).
- Guarda los cambios y ejecuta git add seguido de git commit para resolverlo.

💡 Los conflictos no son errores, son decisiones que debes tomar como desarrollador.

6️⃣ Buenas prácticas en repositorios remotos

1. Usa .gitignore para evitar subir archivos innecesarios (por ejemplo, configuraciones locales o dependencias).
2. Escribe mensajes de commit claros y descriptivos.
Ejemplo: git commit -m "Corrige error en validación de formulario"
3. Sincroniza frecuentemente (usa git pull antes de trabajar y git push después de tus cambios).
4. Documenta tu proyecto usando un archivo README.md con una descripción, instrucciones y autores.
5. Haz commits pequeños y frecuentes, para que sea más fácil identificar errores y retroceder si es necesario.