Configuración — Día 2

Objetivo: dejar Git y GitHub operativos, y VS Code listo para programar.
Tiempo máximo: 2–3 horas. Si algo falla, se documenta y se resuelve en el Sprint 1.

Estado detectado en el equipo

• Git 2.56.0 ya instalado, con identidad configurada.
• VS Code 1.139.1 instalado por Flatpak: flatpak run com.visualstudio.code.
• GitHub Desktop 3.4.13 instalado por Flatpak: flatpak run io.github.shiftey.Desktop.
• Todavía no existe ~/.ssh, así que la conexión con GitHub está pendiente.

1. Git en terminal (30 min)

• Verificar instalación: git --version → 2.56.0
• Identidad configurada. Verificar que sea la correcta:
  • git config --global user.name
  • git config --global user.email
• Configurar rama principal: git config --global init.defaultBranch main
• Configurar finales de línea: git config --global core.autocrlf input
• Revisar: git config --list --show-origin

Entendido: qué es un repositorio, el área de preparación (staging), un commit y una rama. Si no puedo explicarlo, no avanzo.

2. GitHub y SSH (30–45 min)

• Crear o verificar la cuenta de GitHub.
• Generar clave SSH:
  • ssh-keygen -t ed25519 -C "tu-correo@ejemplo.com"
• Iniciar el agente y añadir la clave:
  • eval "$(ssh-agent -s)"
  • ssh-add ~/.ssh/id_ed25519
• Copiar la clave pública (~/.ssh/id_ed25519.pub) en GitHub → Settings → SSH and GPG keys.
• Probar: ssh -T git@github.com (debe saludar con mi usuario).
• Vincular GitHub Desktop con la cuenta.

Seguridad

La clave privada nunca se copia, comparte ni se sube. Solo se comparte el archivo .pub.

3. Extensiones de VS Code (30 min)

Ya instaladas automáticamente. Verificar en VS Code → Extensiones:

• Python

• Pylance

• Python Debugger

• GitLens

• Error Lens

• Markdown All in One

• Code Spell Checker

• Code Spell Checker Spanish

• Seleccionar el intérprete de Python.

• Activar autoguardado y formato al guardar (si el formateador está disponible).

• Abrir la carpeta del vault y verificar que los enlaces funcionan.

VS Code es Flatpak

El comando code no está en el PATH. Abrir con flatpak run com.visualstudio.code, desde el menú de aplicaciones o con el alias code (disponible al abrir una terminal nueva).

4. Configurar Obsidian (15 min)

Ya configurado en .obsidian/. Verificar en Ajustes:

• Plantillas → Carpeta de plantillas: 09_Plantillas.
• Notas diarias → Carpeta: 02_Bitacora; formato: YYYY-MM-DD; plantilla: 09_Plantillas/Bitácora diaria.
• Abrir 000 Índice y comprobar que todos los enlaces resuelven.
• Mover a 00_Inbox cualquier nota suelta que no tenga clasificación.

La fecha en la bitácora

El plan y la configuración no llevan fechas. La bitácora diaria sí, porque es un registro cronológico.

5. Práctica de terminal (30 min)

• Crear una carpeta de laboratorio: mkdir -p ~/lab/terminal
• Practicar: pwd, ls -la, cd, mkdir, touch, cp, mv, rm, cat, less
• Practicar búsqueda y tuberías: grep, find, |, >, >>
• Opcional: OverTheWire Bandit niveles 0–5.

6. Primer repositorio desde terminal (30 min)

• Crear la carpeta del proyecto:
  • mkdir -p ~/lab/entorno-test && cd ~/lab/entorno-test
• git init
• Crear README.md con una línea.
• git add README.md
• git commit -m "Primer commit del entorno"
• Crear el repositorio vacío en GitHub (sin README).
• Conectar y subir:
  • git remote add origin git@github.com:USUARIO/entorno-test.git
  • git push -u origin main
• Verificar el commit en GitHub.
• Repetir el flujo desde GitHub Desktop para comparar.

Criterio de cierre

Puedo crear un repositorio, hacer un commit y subirlo desde la terminal, sin depender de la interfaz gráfica, y GitHub Desktop refleja el mismo estado.

Bloqueos

Siguiente paso

Continuar con Configuración - Día 3.