El nacimiento de Git

Antes de hablar de GitHub, es fundamental entender Git, el sistema de control de versiones distribuido en el que se basa. Git fue creado por Linus Torvalds en 2005, el mismo creador del kernel de Linux. Torvalds necesitaba un sistema de control de versiones que pudiera manejar el desarrollo distribuido del kernel de Linux después de que la relación con BitKeeper, el sistema que estaban utilizando anteriormente, se deteriorara. Los objetivos principales de Git eran:

Velocidad Diseño simple Fuerte soporte para desarrollo no lineal (miles de ramas paralelas) Totalmente distribuido Capacidad para manejar proyectos grandes como el kernel de Linux de manera eficiente

A diferencia de sistemas anteriores como CVS o Subversion, Git está diseñado como un sistema distribuido, lo que significa que cada desarrollador tiene una copia completa del repositorio, incluyendo todo el historial. Esto permite trabajar sin conexión y facilita enormemente la ramificación y fusión de código.

La fundación de GitHub

GitHub fue fundado en febrero de 2008 por Tom Preston-Werner, Chris Wanstrath y PJ Hyett. La idea surgió cuando estos desarrolladores buscaban una manera más sencilla de compartir código y colaborar. Antes de GitHub, compartir código podía ser complicado:

Los desarrolladores enviaban parches por correo electrónico Utilizaban sistemas FTP para compartir archivos Empleaban herramientas complejas como SourceForge que tenían una curva de aprendizaje pronunciada

GitHub transformó este paradigma al crear una interfaz web amigable para Git, añadiendo características sociales que facilitaban la colaboración. Su eslogan inicial, "Social Coding", reflejaba perfectamente su misión. La plataforma se lanzó oficialmente en abril de 2008 y rápidamente ganó popularidad entre los desarrolladores de código abierto.

De startup a gigante tecnológico

Características revolucionarias

• Pull Requests
  

  Quizás la innovación más importante de GitHub. Los Pull Requests (PR) permiten a los desarrolladores proponer cambios a un repositorio, discutirlos y revisarlos antes de integrarlos al código principal. Este flujo de trabajo ha sido adoptado universalmente y ha establecido un estándar en la industria.

  

• Issues y Projects
  

  GitHub introdujo un sistema de seguimiento de problemas integrado directamente con el código. Los Issues permiten reportar errores, solicitar características o discutir ideas. Con Projects, GitHub añadió capacidades de gestión de proyectos tipo Kanban.

• GitHub Actions (2018)
  

  Esta característica permitió la automatización del flujo de trabajo de desarrollo directamente en GitHub, facilitando la integración continua y el despliegue continuo (CI/CD) sin necesidad de herramientas externas.

  

• Codespaces (2020)
  

  Entornos de desarrollo basados en la nube que permiten programar desde el navegador. Esto ha sido especialmente útil para equipos distribuidos y para simplificar la configuración de entornos de desarrollo.

• GitHub Copilot (2021)
  

  Basado en tecnología de OpenAI, Copilot es un asistente de programación impulsado por IA que sugiere código mientras escribes, representando uno de los primeros usos masivos de IA generativa en el desarrollo de software.

Impacto cultural en el desarrollo de software

• Democratización del código abierto
  

  GitHub ha hecho que contribuir a proyectos de código abierto sea más accesible que nunca. Con su interfaz web intuitiva, cualquier desarrollador puede proponer cambios a proyectos públicos sin necesidad de permisos especiales.

• El perfil de GitHub como currículum
  

  El perfil de GitHub se ha convertido en una forma de mostrar habilidades y experiencia. Para muchos desarrolladores y empleadores, la actividad en GitHub es tan importante como un currículum tradicional.

• Colaboración global
  

  GitHub ha derribado barreras geográficas en el desarrollo de software. Proyectos como Linux, React o TensorFlow tienen contribuyentes de todo el mundo que trabajan de forma asíncrona pero coordinada.

  

Integración continua y despliegue continuo (CI/CD)

Seguridad y calidad de código

Integración con servicios cloud

GitHub se integra fácilmente con todos los principales proveedores de nube (AWS, Azure, Google Cloud), facilitando el despliegue de aplicaciones directamente desde el repositorio.

Conceptos fundamentales de Git

• Repositorio
  

  Un repositorio (o repo) es donde Git almacena todo el historial de cambios de un proyecto. Consiste en archivos, directorios y un directorio especial .git que contiene toda la información de control de versiones.

• Commit
  

  Un commit es una instantánea de los cambios realizados en un momento específico. Cada commit tiene un identificador único (hash SHA-1) y contiene metadatos como autor, fecha y mensaje descriptivo.

• Rama (Branch)
  

  Una rama representa una línea independiente de desarrollo. La rama principal por defecto tradicionalmente se llamaba master, aunque ahora GitHub utiliza main como estándar. Las ramas permiten trabajar en diferentes características o correcciones sin afectar al código principal.

• Merge
  

  El proceso de combinar los cambios de una rama con otra. Git intenta resolver automáticamente las diferencias, pero a veces requiere intervención manual cuando hay conflictos.

• Remoto (Remote)
  

  Un repositorio remoto es una versión del proyecto alojada en Internet o en una red. En GitHub, cada repositorio tiene al menos un remoto (llamado origin por defecto).

  

Diferencia entre Git y GitHub

Es importante distinguir entre Git y GitHub:

Git es un sistema de control de versiones distribuido que se ejecuta localmente en tu computadora. Fue creado por Linus Torvalds y es software libre. GitHub es una plataforma web que proporciona alojamiento para repositorios Git y añade características de colaboración como issues, pull requests, wikis, etc. Es propiedad de Microsoft desde 2018.

Podemos pensar en Git como el motor y GitHub como el servicio construido sobre ese motor. Existen alternativas a GitHub como GitLab, Bitbucket o Gitea, todas construidas sobre Git.

Configuración inicial

• Crear una cuenta en GitHub
  

  Visita GitHub.com Haz clic en "Sign up" y sigue las instrucciones Elige un plan (el plan gratuito es suficiente para comenzar) Verifica tu dirección de correo electrónico

• Instalar Git
  

  Antes de usar GitHub, necesitas instalar Git en tu computadora: En Linux (Debian/Ubuntu): bashsudo apt-get update sudo apt-get install git En macOS: bash# Opción 1: Instalar con Homebrew brew install git

  En Windows: bash# Descarga e instala Git desde:

• Configurar Git
  

  Una vez instalado Git, configúralo con tu información: bashgit config –global user.name "Tu Nombre" git config –global user.email "tu.email@ejemplo.com"

  git config –global core.editor "code –wait" # Para Visual Studio Code

• Autenticación en GitHub
  

  GitHub ya no acepta autenticación por contraseña para operaciones Git. En su lugar, debes usar:

  Token de acceso personal (PAT):

  Ve a Settings > Developer settings > Personal access tokens Genera un nuevo token con los permisos necesarios Úsalo en lugar de tu contraseña

  SSH: bash# Generar par de claves SSH ssh-keygen -t ed25519 -C "tu.email@ejemplo.com"

  cat ~/.ssh/id_ed25519.pub

  Copia la clave pública y agrégala en GitHub: Settings > SSH and GPG keys

Comandos básicos de Git

• Iniciar un repositorio
  

  bash# Crear un nuevo repositorio git init mi-proyecto

  cd mi-proyecto-existente git init

• Clonar un repositorio existente
  

  bash# Clonar desde GitHub git clone https://github.com/usuario/repositorio.git

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

• Gestionar cambios
  

  bash# Ver el estado de los archivos git status

  git add archivo.txt # Un archivo específico git add . # Todos los archivos modificados

  git commit -m "Mensaje descriptivo del cambio"

  git commit -am "Mensaje descriptivo"

• Trabajar con ramas
  

  bash# Ver ramas git branch

  git branch nueva-caracteristica

  git checkout nueva-caracteristica

  git checkout -b nueva-caracteristica

  git merge otra-rama

• Sincronizar con GitHub
  

  bash# Añadir un remoto git remote add origin https://github.com/usuario/repositorio.git

  git push -u origin main # La primera vez git push # Después de la primera vez

  git pull origin main

  git remote -v

  

Creación y gestión de repositorios en GitHub

• Crear un repositorio en GitHub
  

  Inicia sesión en GitHub Haz clic en el botón "+" en la esquina superior derecha Selecciona "New repository" Completa la información:

  Nombre del repositorio Descripción (opcional) Visibilidad (público o privado) Inicializar con README (recomendado) Añadir .gitignore y licencia (opcionales)

  Haz clic en "Create repository"

• Gestionar un repositorio existente
  

  Una vez creado el repositorio, puedes:

  Editar la descripción y temas Administrar colaboradores en Settings > Manage access Configurar ramas protegidas en Settings > Branches Crear y gestionar etiquetas para issues Configurar GitHub Pages para sitios web

• Conectar un repositorio local con GitHub
  

  Si ya tienes un repositorio local y quieres subirlo a GitHub: bash# Dentro de tu repositorio local git remote add origin https://github.com/usuario/repositorio.git git branch -M main # Renombrar rama master a main (si es necesario) git push -u origin main

GitHcub Flow

• Pasos del GitHub Flow:
  

  Crear una rama: Crea una rama desde main para trabajar en una nueva característica o corrección Hacer commits: Realiza cambios y haz commits frecuentes Abrir un Pull Request: Solicita la revisión de tus cambios Discutir y revisar: Recibe comentarios y haz ajustes si es necesario Merge y despliegue: Una vez aprobado, fusiona a main y despliega

  

• Ejemplo práctico de GitHub Flow:
  

  bash# 1. Crear una rama para una nueva característica git checkout main git pull origin main # Asegúrate de tener la última versión git checkout -b feature-login-system

  git add . git commit -m "Implementar formulario de login"

  git add . git commit -m "Añadir validación al formulario de login"

  git push -u origin feature-login-system

  git checkout main git pull origin main

  git branch -d feature-login-system git push origin –delete feature-login-system # Borrar en remoto

Git Flow

• Ramas principales en Git Flow:
  

  main/master: Solo contiene código de producción estable develop: Rama de integración para características feature/*: Ramas para desarrollar nuevas características release/*: Preparación para un nuevo lanzamiento hotfix/*: Correcciones urgentes en producción

• Ciclo de vida en Git Flow:
  

  Las características se desarrollan en ramas feature/* Se integran en develop Cuando se prepara un lanzamiento, se crea una rama release/* La rama de release se fusiona tanto en develop como en main Las correcciones críticas se hacen en ramas hotfix/* y se fusionan en ambas ramas principales

  

Trunk-Based Development

• Características del Trunk-Based Development:
  

  Commits pequeños y frecuentes Ramas de corta duración (menos de un día) Uso intensivo de feature flags para controlar funcionalidades Pruebas automatizadas extensivas Integración continua

  

Anatomía de un Pull Request

Creando un Pull Request efectivo

• Plantilla de descripción para Pull Requests
  

  markdown## Descripción [Explicación clara de los cambios realizados]

  ## Motivación y Contexto [¿Por qué es necesario este cambio? ¿Qué problema resuelve?]

  ## Tipo de Cambio

  • [ ] Corrección de bug
  • [ ] Nueva característica
  • [ ] Mejora de rendimiento
  • [ ] Refactorización de código

  ## Cómo Probar [Pasos para probar los cambios]

  ## Screenshots (si aplica) [Imágenes que ayuden a entender el cambio]

  ## Issues Relacionados Closes #[número de issue] GitHub permite crear plantillas de PR para tu repositorio añadiendo un archivo .github/pull_{requesttemplate.md}.

Realizando Code Reviews efectivas

• Para revisores:
  

  Sé respetuoso y constructivo:

  Comenta sobre el código, no sobre la persona Explica el "por qué" junto con el "qué" Sugiere alternativas cuando sea posible

  Busca problemas específicos:

  Errores lógicos o de seguridad Rendimiento y escalabilidad Legibilidad y mantenibilidad Cumplimiento de estándares del proyecto

  Utiliza las herramientas de GitHub:

  Comentarios en líneas específicas Sugerencias de código (propuestas de cambio) Revisiones con estados (Approve, Request changes, Comment)

• Para autores:
  

  Facilita la revisión:

  PRs pequeños y enfocados Descripción clara y completa Responde a los comentarios puntualmente

  Mantén una actitud abierta:

  Considera las sugerencias sin tomártelo personalmente Explica tus decisiones cuando no estés de acuerdo Agradece el feedback

  

Conceptos básicos de GitHub Actions

• Componentes principales:
  

  Workflows: Procesos automatizados configurados en archivos YAML Events: Disparadores que inician un workflow (push, pull request, etc.) Jobs: Conjuntos de pasos que se ejecutan en un mismo runner Steps: Tareas individuales que pueden ejecutar comandos o acciones Actions: Unidades reutilizables de código (como funciones) Runners: Servidores que ejecutan los workflows

• Estructura de un workflow:
  

  yamlname: CI/CD Pipeline

  on: push: branches: [ main ] pull_request: branches: [ main ]

  jobs: build: runs-on: ubuntu-latest

  steps:

  • uses: actions/checkout@v3
  • name: Set up Node.js uses: actions/setup-node@v3 with: node-version: '16'
  • name: Install dependencies run: npm ci
  • name: Run tests run: npm test

Casos de uso comunes

• Integración Continua (CI)
  

  yamlname: Continuous Integration

  on: push: branches: [ main, develop ] pull_request: branches: [ main, develop ]

  jobs: test: runs-on: ubuntu-latest

  steps:

  • uses: actions/checkout@v3
  • name: Set up Python uses: actions/setup-python@v4 with: python-version: '3.10'
  • name: Install dependencies run: | python -m pip install –upgrade pip pip install flake8 pytest if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
  • name: Lint with flake8 run: flake8 . –count –select=E9,F63,F7,F82 –show-source –statistics
  • name: Test with pytest run: pytest
• Despliegue Continuo (CD)
  

  yamlname: Deploy to Production

  on: push: branches: [ main ]

  jobs: deploy: runs-on: ubuntu-latest

  steps:

  • uses: actions/checkout@v3
  • name: Set up Node.js uses: actions/setup-node@v3 with: node-version: '16'
  • name: Install dependencies run: npm ci
  • name: Build run: npm run build
  • name: Deploy to AWS S3 uses: jakejarvis/s3-sync-action@master with: args: –acl public-read –follow-symlinks –delete env: AWS_S3BUCKET: ${{ secrets.AWS_S3BUCKET }} AWS_ACCESSKEYID: ${{ secrets.AWS_ACCESSKEYID }} AWS_{SECRETACCESSKEY}: ${{ secrets.AWS_{SECRETACCESSKEY} }} AWS_REGION: 'us-west-1' SOURCE_DIR: 'build'
• Automatización de tareas
  

  yamlname: Auto Assign Issues

  on: issues: types: [opened]

  jobs: assign: runs-on: ubuntu-latest steps:

  • name: Assign to Project Board uses: alex-page/github-project-automation-plus@v0.8.3 with: project: "Backlog" column: "To Do" repo-token: ${{ secrets.GITHUB_TOKEN }}
  • name: Add labels uses: andymckay/labeler@master with: add-labels: "needs-triage, bug"

  

Secretos y variables de entorno

• Configuración de secretos:
  

  En tu repositorio, ve a Settings > Secrets and variables > Actions Haz clic en "New repository secret" Introduce el nombre y valor del secreto

• Uso en workflows:
  

  yamljobs: deploy: runs-on: ubuntu-latest steps:

  • name: Deploy with secret env: API_TOKEN: ${{ secrets.API_TOKEN }} run: | echo "Using token to authenticate" ./deploy.sh

GitHub Issues y Projects

• Issues
  

  Los issues son el sistema de seguimiento de problemas de GitHub. Puedes usarlos para:

  Reportar bugs Solicitar nuevas características Planificar tareas Hacer preguntas o iniciar discusiones

• Anatomía de un issue:
  

  Título descriptivo Descripción detallada Asignados (responsables) Etiquetas (clasificación) Hitos (agrupación temporal) Estado (abierto/cerrado) Comentarios (discusión)

• Plantillas de issues:
  

  Puedes crear plantillas para diferentes tipos de issues añadiendo archivos en .github/ISSUE_TEMPLATE/. Ejemplo de plantilla para reportar bugs: markdown— name: Bug report about: Create a report to help us improve title: '[BUG] ' labels: bug assignees: '' —

  Describe el bug Una descripción clara y concisa del problema.

  Pasos para reproducir

  1. Ir a '…'
  2. Click en '….'
  3. Desplazarse hasta '….'
  4. Ver error

  Comportamiento esperado Una descripción de lo que esperabas que ocurriera.

  Screenshots Si aplica, añade capturas de pantalla.

  Entorno:

  • OS: [ej. iOS]
  • Navegador [ej. chrome, safari]
  • Versión [ej. 22]

  Contexto adicional Cualquier otra información relevante.

• GitHub Projects
  

  Projects es la herramienta de gestión de proyectos integrada en GitHub, con tableros estilo Kanban:

  Vistas: Tablero, tabla, calendario, etc. Elementos: Issues, Pull Requests y notas Campos personalizados: Estado, prioridad, etc. Automatización: Mover issues entre columnas automáticamente

  

GitHub Pages

• Configuración básica:
  

  Crea un repositorio llamado username.github.io (donde username es tu nombre de usuario) Añade archivos HTML, CSS y JavaScript Activa GitHub Pages en Settings > Pages

• Opciones de publicación:
  

  Rama: Puedes publicar desde la rama main, gh-pages u otra Carpeta: Puedes elegir la carpeta raíz o /docs Generadores: Jekyll integrado o cualquier generador de sitios estáticos

• Dominios personalizados:
  

  Añade un archivo CNAME con tu dominio Configura los registros DNS Activa HTTPS en la configuración

• Ejemplo de flujo:
  

  bash# Crear sitio local mkdir mi-sitio cd mi-sitio echo "# Mi sitio personal" > index.md

  git init git add . git commit -m "Primer commit" git remote add origin https://github.com/username/username.github.io.git git push -u origin main

GitHub Wikis

• Características:
  

  Editor Markdown/HTML Historial de versiones Navegación jerárquica Puede clonarse como un repositorio Git

• Ejemplo de estructura:
  

  Home (página principal) Guía de instalación Manual del usuario API Reference Contribución FAQ

• Comandos para trabajar con wikis:
  

  bash# Clonar una wiki git clone https://github.com/username/repo.wiki.git

  cd repo.wiki

  git add . git commit -m "Actualizar documentación" git push

GitHub Codespaces

• Características principales:
  

  Entorno de desarrollo completo en el navegador VS Code integrado Terminal y depurador Personalización mediante devcontainer.json Prebuilds para iniciar más rápido

• Configuración básica:
  

  Crea un archivo .devcontainer/devcontainer.json:

  json{ "name": "My Project Dev Environment", "image": "mcr.microsoft.com/devcontainers/universal:2", "customizations": { "vscode": { "extensions": [ "esbenp.prettier-vscode", "dbaeumer.vscode-eslint" ] } }, "forwardPorts": [3000], "postCreateCommand": "npm install" }

  Inicia un codespace desde la interfaz de GitHub Desarrolla, ejecuta y prueba directamente en la nube

  

  

Convenciones de commits

• Conventional Commits:
  

  <tipo>[ámbito opcional]: <descripción>

  [cuerpo opcional]

  [notas de pie opcionales] Donde tipo puede ser:

  feat: Nueva característica fix: Corrección de error docs: Cambios en documentación style: Cambios de formato (espacios, indentación) refactor: Refactorización de código test: Añadir o corregir tests chore: Tareas de mantenimiento

  Ejemplos: feat(auth): implementar autenticación con Google

  fix(api): corregir error en endpoint de usuarios

  docs: actualizar instrucciones de instalación

Archivos esenciales para repositorios

• README.md
  

  Primer archivo que verán los visitantes. Debe incluir:

  Nombre y descripción del proyecto Instrucciones de instalación Uso básico Contribución Licencia

• .gitignore
  

  Especifica archivos que Git debe ignorar:

  /node_modules /vendor

  /dist /build

  .env .env.local

  *.log

  .DS_Store Thumbs.db

• LICENSE
  

  Define cómo se puede usar tu código. Opciones comunes:

  MIT: Muy permisiva Apache 2.0: Permisiva con protecciones de patentes GPL: Copyleft, requiere mantener la misma licencia AGPL: Como GPL pero también para software como servicio

• CONTRIBUTING.md
  

  Guía para contribuidores:

  Proceso para reportar bugs Proceso para sugerir características Estándares de código Proceso de pull request

• SECURITY.md
  

  Política de seguridad:

  Versiones soportadas Cómo reportar vulnerabilidades Proceso de divulgación

Gestión de dependencias y seguridad

• Dependabot
  

  GitHub incluye Dependabot para gestionar dependencias:

  Crea un archivo .github/dependabot.yml:

  yamlversion: 2 updates:

  • package-ecosystem: "npm" directory: "/" schedule: interval: "weekly" open-pull-requests-limit: 10
  • package-ecosystem: "docker" directory: "/" schedule: interval: "weekly"

  Dependabot creará PRs automáticamente cuando haya actualizaciones disponibles También alertará sobre vulnerabilidades de seguridad

• Security Scanning
  

  GitHub ofrece herramientas de análisis de seguridad:

  Code Scanning: Análisis estático de código con CodeQL Secret Scanning: Detección de credenciales expuestas Dependency Review: Análisis de seguridad en PRs

  Para activar Code Scanning: yaml# .github/workflows/codeql-analysis.yml name: "CodeQL"

  on: push: branches: [ main ] pull_request: branches: [ main ] schedule:

  • cron: '30 1 * * 0'

  jobs: analyze: name: Analyze runs-on: ubuntu-latest permissions: security-events: write

  steps:

  • name: Checkout repository uses: actions/checkout@v3
  • name: Initialize CodeQL uses: github/codeql-action/init@v2 with: languages: javascript, python
  • name: Perform CodeQL Analysis uses: github/codeql-action/analyze@v2