Crear cuenta y sincronizar repositorios

Lectura
25 min~7 min lectura
CONCEPTO CLAVE: GitHub es una plataforma en la nube que permite almacenar, gestionar y compartir repositorios Git. Aprender a crear una cuenta y sincronizar repositorios es el primer paso para colaborar eficientemente en equipos de desarrollo.

¿Qué es GitHub y por qué lo necesitas?

GitHub es la plataforma de alojamiento de código más popular del mundo, utilizada por millones de desarrolladores y miles de empresas. Mientras que Git es el sistema de control de versiones local que instalas en tu computadora, GitHub actúa como un servidor remoto donde puedes almacenar una copia de tu proyecto y acceder a él desde cualquier lugar del mundo.

Cuando trabajas en equipo, cada miembro puede tener una copia local del repositorio en su computadora, pero todos sincronizan sus cambios a través de GitHub. Esto permite que múltiples personas trabajen en el mismo proyecto simultáneamente sin pisarse los unos a los otros.

Creando tu cuenta en GitHub

El proceso de creación de cuenta es gratuito y bastante sencillo. Sigue estos pasos:

  1. Dirígete a github.com en tu navegador web preferido.
  2. Haz clic en el botón verde "Sign up" ubicado en la esquina superior derecha.
  3. Ingresa tu dirección de correo electrónico y haz clic en "Continue".
  4. Crea una contraseña segura. GitHub te indicará si cumple con los requisitos mínimos de seguridad.
  5. Elige un nombre de usuario único. Este nombre aparecerá en tus repositorios y será tu identidad en la plataforma, así que elige algo profesional y fácil de recordar.
  6. GitHub puede pedirte que completes un pequeño puzzle para verificar que no eres un robot.
  7. Selecciona tus preferencias de plan. El plan gratuito es perfecto para comenzar y ofrece todas las funcionalidades básicas que necesitas.
  8. Verifica tu correo electrónico haciendo clic en el enlace que GitHub te enviará.
💡 Consejo profesional: Elige un nombre de usuario que puedas usar de forma profesional. Una vez creado, no es fácil cambiarlo ya que todos tus enlaces y contribuciones están asociados a él. Evita usar números o guiones bajos excesivos.

Configurando Git para trabajar con GitHub

Antes de sincronizar repositorios, necesitas configurar Git en tu computadora para que sepa quién eres y pueda asociar tus cambios con tu cuenta de GitHub.

Configuración básica

Abre tu terminal o línea de comandos y ejecuta los siguientes comandos, reemplazando con tu información real:

git config --global user.name "Tu Nombre"
git config --global user.email "[email protected]"

Es fundamental que uses el mismo correo electrónico que registraste en GitHub. GitHub utiliza esta dirección de email para asociar tus commits con tu cuenta.

⚠️ Importante: Si usas un correo diferente al de tu cuenta de GitHub, tus contribuciones no aparecerán correctamente en tu perfil. Verifica esto antes de hacer tu primer commit.

Verificando tu configuración

Puedes verificar que la configuración se guardó correctamente ejecutando:

git config --list

Esto mostrará todas las configuraciones actuales de Git, incluyendo tu nombre de usuario y correo electrónico.

Creando tu primer repositorio en GitHub

Un repositorio es como una carpeta que contiene todos los archivos de tu proyecto junto con el historial de cambios. Para crear uno:

  1. Inicia sesión en tu cuenta de GitHub.
  2. Haz clic en el botón "+" ubicado en la esquina superior derecha y selecciona "New repository".
  3. Completa los siguientes campos:
    • Repository name: Elige un nombre descriptivo para tu proyecto.
    • Description: Una breve explicación de qué trata tu proyecto (opcional pero recomendado).
    • Public/Private: Público permite que cualquiera vea tu código; Privado limita el acceso solo a quienes tú invites.
    • Add a README file: Marca esta opción para crear automáticamente un archivo README en tu repositorio.
    • Add .gitignore: Selecciona una plantilla según el lenguaje de programación que uses.
  4. Finalmente, haz clic en "Create repository".
📌 Recuerda: El archivo README.md es la primera impresión de tu proyecto. Debería incluir una descripción clara, cómo instalar el proyecto, cómo usarlo y quién contribuye al mismo.

Métodos para sincronizar repositorios

Existen principalmente tres formas de conectar tu repositorio local con GitHub:

1. Crear un repositorio desde cero y subirlo

Si ya tienes un proyecto local que deseas subir a GitHub:

cd ruta/de/tu/proyecto
git init
git add .
git commit -m "Primer commit"
git remote add origin https://github.com/tu-usuario/nombre-repositorio.git
git branch -M main
git push -u origin main

Veamos qué hace cada comando:

ComandoFunción
git initInicializa un repositorio Git local
git add .Agrega todos los archivos al staging area
git commitGuarda los cambios con un mensaje descriptivo
git remote add originConecta tu repositorio local con el remoto
git push -u origin mainSube tus cambios al repositorio remoto

2. Clonar un repositorio existente

Si quieres trabajar en un proyecto que ya existe en GitHub:

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

Esto descargará todo el repositorio a tu computadora, incluyendo todo el historial de commits.

💡 Consejo: Puedes clonar usando HTTPS (como se muestra arriba) o SSH. SSH es más seguro pero requiere configuración adicional de claves. Para comenzar, HTTPS es más sencillo.

3. Vincular un repositorio local existente a GitHub

Si ya tienes un repositorio Git local y quieres subirlo a GitHub:

git remote add origin https://github.com/tu-usuario/nombre-repositorio.git
git branch -M main
git push -u origin main

Sincronizando cambios: fetch, pull y push

Para trabajar eficientemente con repositorios remotos, necesitas entender tres comandos fundamentales:

ComandoFunciónAnalogía
git fetchDescarga cambios del remoto sin aplicarlosVer el índice de una biblioteca sin sacar libros
git pullDescarga y aplica cambios del remotoSacar y leer los libros que otros dejaron
git pushSube tus cambios locales al remotoDevolver tus libros a la biblioteca

El flujo de trabajo típico es:

  1. Haces cambios en tu código local.
  2. Ejecutas git add y git commit para guardarlos.
  3. Ejecutas git pull para asegurarte de tener los últimos cambios del equipo.
  4. Resuelves cualquier conflicto si es necesario.
  5. Ejecutas git push para subir tus cambios a GitHub.
⚠️ Advertencia: Siempre haz git pull antes de hacer git push. Si subes cambios sin tener en cuenta lo que otros han modificado, puedes crear conflictos que son tediosos de resolver.

Trabajando con tokens de acceso personal

Desde 2021, GitHub ya no permite autenticarse solo con contraseña desde la terminal. Necesitas usar un Personal Access Token (PAT).

Ver más: Cómo crear un token de acceso personal
  1. En GitHub, ve a Settings (Configuración).
  2. En el menú lateral, selecciona Developer settings.
  3. Haz clic en Personal access tokens y luego en Generate new token.
  4. Asigna un nombre descriptivo al token.
  5. Selecciona los permisos que necesitas. Para uso básico, marca repo (acceso total a repositorios).
  6. Establece una fecha de expiración.
  7. Haz clic en Generate token.
  8. Importante: Copia el token inmediatamente y guárdalo en un lugar seguro. Solo se mostrará una vez.

Cuando Git te pida tu contraseña en la terminal, usa el token en lugar de tu contraseña de GitHub.

📌 Buena práctica: Los tokens de acceso personal son como llaves digitales. Nunca los compartas públicamente ni los guardes en tu código. Si un token se compromete, revócalo inmediatamente desde la configuración de GitHub.

Estructura de un repositorio bien organizado

Un repositorio profesional en GitHub debe tener:

  • README.md: Documentación del proyecto con descripción, instalación y uso.
  • LICENSE: Archivo que define bajo qué licencia se distribuye tu código.
  • .gitignore: Archivo que indica qué archivos o carpetas no deben subirse (como node_modules, carpetas de compilación, archivos con contraseñas).
  • CONTRIBUTING.md: Guía para otros desarrolladores que quieran contribuir al proyecto.
Un proyecto bien documentado no solo ayuda a otros a entender tu código, sino que también demuestra profesionalismo y facilita la colaboración en equipo.

Resumen de comandos esenciales

ComandoDescripción
git initInicializa un repositorio Git
git clone urlClona un repositorio remoto
git remote -vMuestra los repositorios remotos vinculados
git add archivoAgrega archivos al staging area
git commit -m "mensaje"Guarda los cambios localmente
git pushSube cambios al servidor remoto
git pullDescarga y fusiona cambios del remoto
git statusMuestra el estado actual del repositorio
🧠 Quiz

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

  • A) fetch descarga cambios y los aplica automáticamente, pull solo los descarga
  • B) fetch descarga cambios del remoto sin aplicarlos, pull descarga y aplica los cambios
  • C) Son exactamente iguales, solo tienen nombres diferentes
  • D) pull es para subir cambios, fetch es para bajarlos
✅ Respuesta correcta: B) fetch descarga los cambios del repositorio remoto pero no los aplica a tu rama local, simplemente actualiza las referencias. En cambio, pull hace lo mismo que fetch pero además fusiona esos cambios con tu rama actual automáticamente.

Ahora que conoces los fundamentos para crear una cuenta en GitHub y sincronizar repositorios, estás listo para comenzar a colaborar en proyectos de equipo. En las siguientes lecciones aprenderás sobre ramas, pull requests y resolución de conflictos.