GitHub desde Cero

GitHub es la plataforma más popular para alojar repositorios Git, colaborar en proyectos y gestionar el ciclo de vida del desarrollo de software.

Historia:

GitHub fue fundado en 2008 y adquirido por Microsoft en 2018 por $7.5 mil millones. Alberga más de 100 millones de repositorios y desarrolladores.

Características Principales:

• Repositorios: Aloja tu código con control de versiones
• Pull Requests: Revisión y discusión de cambios
• Issues: Seguimiento de tareas y bugs
• Actions: CI/CD nativo integrado

Instalar Git:

# Windows: Descargar desde git-scm.com
# macOS
brew install git
# Linux
sudo apt-get install git

Configurar Usuario:

git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"

Autenticación SSH:

# Generar clave SSH
ssh-keygen -t ed25519 -C "tu@email.com"

# Agregar al agente SSH
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# Copiar clave pública
cat ~/.ssh/id_ed25519.pub

GitHub CLI:

# Instalar
brew install gh  # macOS
sudo apt install gh  # Linux

# Autenticar
gh auth login

Crear Repositorio:

# Desde GitHub.com: Click en "New repository"
# O desde CLI
gh repo create mi-proyecto
cd mi-proyecto

Comandos Esenciales:

# Clonar repositorio
git clone https://github.com/usuario/repo.git

# Ver estado
git status

# Agregar y commitear
git add .
git commit -m "Mensaje descriptivo"

# Push a remoto
git push origin main

Trabajar con Branches:

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

# Push de la rama
git push -u origin feature/nueva

Crear Pull Request:

# Desde CLI
gh pr create --title "Add nueva feature" --body "Descripción de los cambios"

# O desde github.com: Click en "New Pull Request"

Proceso de Code Review:

• Revisar los cambios archivo por archivo
• Dejar comentarios específicos
• Solicitar cambios si es necesario
• Aprobar cuando esté listo

Issues y Projects:

Usa Issues para reportar bugs y Features. Projects para gestión ágil tipo Kanban.

README Profesional:

# Nombre del Proyecto

Descripción clara y concisa.

## Instalación
\`\`\`bash
npm install
\`\`\`

## Uso
\`\`\`bash
npm start
\`\`\`

## Licencia
MIT

.gitignore:

Excluye node_modules, .env, dist, archivos del sistema.

Licencias:

• MIT: Permisiva, uso libre
• Apache 2.0: Con patente
• GPL: Copyleft, derivados deben ser open source

Workflow Básico:

name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'
      - name: Install
        run: npm install
      - name: Test
        run: npm test

GitHub Pages:

Deploy automático de sitios estáticos desde una rama gh-pages.

Desarrolla un proyecto completo en GitHub:

1. Crear repositorio con README profesional
2. Configurar .gitignore y licencia
3. Crear branches para features
4. Implementar CI/CD con Actions
5. Usar Issues para tracking
6. Deploy con GitHub Pages

Trabajar con Forks:

# Forkear desde github.com
# Clonar tu fork
git clone https://github.com/tu-user/repo.git

# Agregar upstream
git remote add upstream https://github.com/original/repo.git

# Sincronizar
git fetch upstream
git merge upstream/main

Pull Requests Detallados:

# Título descriptivo
feat: agregar autenticación con JWT

# Body del PR
## Descripción
- Login con JWT
- Refresh tokens
- Logout

## Tipo de cambio
- [ ] Bug fix
- [x] New feature
- [ ] Breaking change

Mantener PR Actualizado:

git fetch upstream
git rebase upstream/main
git push --force-with-lease

Crear Issues:

## Formato de Issue
### Descripción
Bug encontrado en el login

### Pasos para reproducir
1. Ir a /login
2. Ingresar credenciales
3. Error en consola

### Comportamiento esperado
Redirigir al dashboard

### Labels
bug, priority: high, good first issue

GitHub Projects:

• Tableros Kanban automáticos
• Campos personalizados
• Automation rules
• Integración con Issues y PRs

Milestones:

# Cerrar issues automáticamente
closes #123
fixes #456
resolves #789

Tokens y SSH:

# Token de acceso personal (PAT)
gh auth token

# Generar nuevo token
gh auth login --with-token < token.txt

Organizations y Teams:

# Ver equipos
gh team list

# Miembros del equipo
gh team members list --team nombre

Dependabot:

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: "npm"
    directory: "/"
    schedule:
      interval: "weekly"

Code Scanning:

GitHub Advanced Security incluye scanning de vulnerabilidades automáticamente.

Releases:

# Crear release desde CLI
gh release create v1.0.0 \
  --title "Versión 1.0.0" \
  --notes "Primera versión estable"

# Release con archivos
gh release create v1.0.0 \
  --generate-notes \
  assets/mi-app.zip

GitHub Packages:

# Publicar package
npm publish

# Configurar Registry
npm config set registry https://npm.pkg.github.com

Descargar Releases:

gh release download v1.0.0 --pattern "*.exe"

GitHub Actions Avanzado:

name: Deploy
on:
  push:
    branches: [main]
  workflow_dispatch:

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Deploy
        run: |
          echo "Deploying..."
          # comandos de deploy

      - name: Notify
        if: failure()
        uses: slack-send@1

Reusable Workflows:

# .github/workflows/reusable.yml
on:
  workflow_call:
    inputs:
      environment:
        required: true
        type: string

GitHub API:

gh api repos/{owner}/{repo}/issues

GitHub Codespaces:

IDE en la nube con VS Code, preconfigurado para tu proyecto.