Apéndice A — Git desde cero

Objetivo del apéndice

Darte el mínimo de Git necesario para seguir el libro: clonar, branchear, commitear, pushear y abrir PR.

Instalación

# macOS
brew install git

# Ubuntu/Debian
sudo apt install git -y

# Windows (WSL)
wsl --install
# dentro de WSL: sudo apt install git -y

Configuración inicial

git config --global user.name "Tu nombre"
git config --global user.email "tu@email.com"
git config --global init.defaultBranch main
git config --global pull.rebase true

El flujo mínimo

# Clonar
git clone https://github.com/sazon-foods/backstage-sazon.git
cd backstage-sazon

# Crear rama
git checkout -b feat/sazon-status-plugin

# Editar archivos, luego:
git add .
git commit -m "feat(sazon-status): add /health endpoint"

# Sincronizar y pushear
git pull --rebase
git push origin feat/sazon-status-plugin

# Abrir PR desde la URL que imprime GitHub CLI:
gh pr create --fill

Conceptos clave

  • Working tree: tu carpeta de archivos.

  • Index / Staging: lo que va en el próximo commit (git add).

  • HEAD: el commit actual.

  • Branch: puntero a un commit (rama de trabajo).

  • Remote: el repo en el servidor (origin por convención).

Comandos de rescate

git status                # qué ha cambiado
git diff                  # diff sin stage
git diff --staged         # diff en stage
git log --oneline -10     # últimos 10 commits
git stash                 # guarda cambios sin commitear
git stash pop             # los restaura
git reset --hard HEAD~1   # descarta el último commit (cuidado)
git revert HEAD            # revierte el último commit (seguro)

Para más