Migraciones de base de datos con pruebas en Claude Code

Contenido del curso

No sé dónde empezar

Módulo 1: Discovery-Análisis-Planning

Módulo 2: Implementación Backend

Módulo 3: Gestión de Contexto y Comandos

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0013:37

Migraciones de base de datos con pruebas en Claude Code

Curso de Claude Code

Clase 10 de 18

Clase 10 / 18

Recursos

Migrar una base de datos sin romper el servicio exige método, contexto y pruebas. Con Claude Code puedes orquestar migraciones en Docker, validar con unit tests y avanzar fase por fase de un plan de implementación bien definido, todo desde la terminal y con control humano sobre cada paso.

¿Cómo preparar el entorno local antes de migrar?

Antes de tocar la base de datos, el servicio tiene que estar corriendo. El archivo Makefile dentro de backend concentra los comandos clave para levantar el proyecto.

make build construye la imagen y descarga los paquetes necesarios.
make start inicia el servicio de API.
make logs confirma que el contenedor encendió correctamente.

Una vez arriba, abres el navegador en localhost:8000 y verificas que el API responde. Ese ping inicial te ahorra horas de depuración más adelante.

¿Qué hace el comando make build? Construye la imagen de Docker del backend descargando todas las dependencias declaradas en el proyecto, dejando el contenedor listo para iniciarse con make start.

¿Cómo agregar un comando para ejecutar pruebas?

El Makefile original no traía un comando para correr pruebas dentro del contenedor. En lugar de escribirlo a mano, le pasas el archivo como contexto a Claude Code y le pides que cree un comando nuevo llamado test que ejecute Pytest dentro del contenedor de API [04:18].

Claude propone la edición, tú la apruebas y queda lista. Desde una nueva terminal, dentro de backend, corres make test y validas que el set de pruebas funcione.

¿Cómo resolver errores de dependencias en los tests?

La primera ejecución suele fallar. En esta base de código, los unit tests requerían dos paquetes que no estaban instalados: HTTPX y pytest-asyncio.

La solución fue añadirlos a las dependencias opcionales del proyecto y reconstruir con UV, el gestor de paquetes que usa este backend. Después de eso, los tests corrieron al 100%.

¿Qué es pytest-asyncio? Es un plugin de Pytest que permite ejecutar pruebas sobre funciones asíncronas de Python, indispensable cuando tu API usa async/await.

Este tipo de retos son perfectos para resolver con Claude Code: le das el error como contexto y te sugiere dónde ajustar el archivo de dependencias.

¿Cómo ejecutar la fase de migración con Claude Code?

El plan de implementación define fases con checklists claros. La fase uno es base de datos, y el flujo correcto es activar el plan mode antes de ejecutar nada [09:42].

¿Qué modos de ejecución ofrece Claude Code?

Claude Code tiene tres modos que cambias con Shift+Tab, cada uno con un nivel distinto de autonomía.

Auto accept: acepta cualquier edición sin preguntar.
Plan mode: planifica todo el flujo antes de tocar archivos, ideal para tareas críticas.
Modo por defecto: pide confirmación antes de cada acción.

En una migración, el plan mode te deja revisar la estrategia completa antes de que Claude escriba una sola línea. Verás el contenedor que va a usar, la última migración aplicada y el patrón identificado.

¿Cómo darle el contexto correcto al agente?

Claude Code necesita ubicación y archivos específicos. Si mencionas un archivo que no encuentra, el problema casi siempre es el directorio actual.

Puedes activar el bash mode con el signo de exclamación para ejecutar comandos como pwd y orientarte. Cuando Claude no logra cambiar de carpeta por restricciones, lo más rápido es salir, navegar manualmente y reiniciar la sesión.

Una vez ubicado, le pasas el plan con @01-backend.md y le indicas que use los comandos del Makefile para reconstruir la imagen si hace falta. El agente entonces revisa contenedores activos, consulta el estado de Alembic, identifica la última migración y propone el plan completo.

¿Cómo validar que la migración no rompió el servicio?

Claude Code crea el archivo de migración, ejecuta los constraints, los índices y aplica todo en Postgres. El cierre de la fase llega cuando vuelves a correr los unit tests y todo sigue verde.

El agente además propone una verificación adicional con el endpoint de health y llamadas vía cURL a los endpoints principales. Esto convierte la validación en una mini prueba de integración:

Tests unitarios pasando dentro del contenedor.
Estado del contenedor activo.
Endpoints respondiendo con la estructura esperada.

Para mantener el plan de implementación sincronizado, conectas Claude Code con el editor, seleccionas el bloque del checklist y con Command+Option+K lo mencionas como contexto. Le pides marcar como finalizadas las tareas completadas y el agente actualiza los checks automáticamente.

¿Por qué importa cerrar cada fase con tests?

Una migración silenciosa puede romper consultas, modelos o relaciones sin previo aviso. Volver a ejecutar los unit tests después de cada cambio te garantiza que el contrato del API sigue intacto antes de pasar a la siguiente fase, como la creación de los modelos de SQLAlchemy.

¿Qué retos enfrentaste al implementar la fase dos con Claude Code? Déjalo en los comentarios.

Daniel Alfredo García Serna

Hace 6 meses

📚 Nombre de la clase

Migración de base de datos con Docker al sistema local

🎯 Idea principal

Migrar una base de datos desde Docker a un entorno local implica extraer, adaptar y validar los datos correctamente, asegurando que todo funcione fuera del contenedor. No es solo copiar datos, es garantizar compatibilidad, integridad y funcionamiento en un nuevo entorno.

⚡ Síntesis en 10 segundos

Migrar ≠ copiar → adaptar + validar
Docker y local son entornos distintos
Exporta, importa y verifica
Cuida integridad de datos
Prueba antes de usar

🔑 Puntos clave

La migración implica:
- extraer datos desde Docker
- importarlos en entorno local
- ajustar configuración
Diferencias entre entornos:
- rutas
- puertos
- credenciales
- versiones de DB
Proceso general:
- exportar (dump)
- importar en local
- validar funcionamiento
Riesgos:
- pérdida de datos
- incompatibilidades
- errores de conexión
Buenas prácticas:
- hacer backup antes
- validar datos después
- probar queries clave

🧠 Conceptos importantes

Docker → Contenedor que encapsula servicios (ej: base de datos)
Dump → Exportación de la base de datos a un archivo
Migración → Movimiento de datos entre entornos
Integridad de datos → Que los datos se mantengan correctos tras el cambio

🧩 Modelo mental de la clase

Base en Docker → exportación → adaptación → importación local → validación → uso

Extraer → mover → ajustar → verificar

🚀 Acciones inmediatas

Haz backup de la base en Docker
Exporta la base (dump)
Configura tu DB local
Importa los datos
Ejecuta pruebas básicas (consultas clave)

💼 Aplicación profesional

Desarrollo local:
- trabajar sin depender de contenedores
Debugging:
- analizar datos directamente
Equipos:
- compartir bases de datos fácilmente
Migraciones:
- mover sistemas entre entornos

🔥 Hacks para la comunidad

Siempre backup antes de migrar
Verifica encoding y versiones
Prueba conexiones antes de importar
Usa datos de prueba si es posible
Automatiza el proceso si lo haces seguido

📝 Reflexión estratégica

Mover datos es una tarea crítica: un error puede costar mucho tiempo o información.

Un desarrollador profesional no solo construye features, también sabe mover y proteger datos correctamente.

👉 La clave no es solo migrar… es hacerlo de forma segura, reproducible y verificable.

Comentarios (22)22 comentarios

Miguel Bastidas

Hace 5 meses

Adrian Daniel Sanchez Manrique

Hace un mes

Yennifer Paola Herrera Ariza

Hace un año

Japheth Calzada López

Hace 9 meses

Miguel Angel Reyes Moreno

Hace 7 meses

Jonathan Narváez Urresta

Carlos Esteban León Pinilla

Andres Trujillo

Yehoshua Goldman Saravia

Hace 10 meses•editado

César David Ramírez Dimaté

Cesar Augusto Morales Godoy

Hace 4 meses

Andrés Orlando Orduz Grimaldo

Ricardo Madrid

Diego Mauricio Zuluaga Rodríguez

Hace 3 meses

José Gregorio Hernández Ortiz

Sebastián Plazas

Álvaro Morales

Anthony Pernia

Leonel Moyano

Brian Ramirez Salazar

Josué Merino

Hace 10 días

Josef Rodriguez

Juan Esteban Díaz Montejo

Roberto Carlos Moreira España

Hace 8 meses

Módulo 1: Discovery-Análisis-Planning

Qué hace único a Claude Code

Cómo entender un codebase nuevo con Claude Code

Instala y configura Claude Code en minutos

Cinco conceptos clave para usar Claude Code

Analiza y configura un proyecto con Claude Code

Análisis de impacto del feature de ratings con Claude Code

Cómo crear subagentes especializados en Claude Code

Novedades de Claude Code 2.0 y Sonnet 4.5

Subagentes de frontend y backend en paralelo

Módulo 2: Implementación Backend

Migraciones de base de datos con pruebas en Claude Code

Revisión de seguridad automática con Claude Code

Ratings en frontend con datos mock y Claude Code

Integración full stack con add dir en Claude Code

Módulo 3: Gestión de Contexto y Comandos

Playwright, Notion y Linear como MCPs en Claude Code

Control de costos y modelos en Claude Code

Instala Claude Code en GitHub Actions

Cómo invocar Claude Code desde un pull request

Qué aprendiste sobre desarrollo conversacional

Migraciones de base de datos con pruebas en Claude Code

Progreso del curso

Módulo 1: Discovery-Análisis-Planning

Módulo 2: Implementación Backend

Módulo 3: Gestión de Contexto y Comandos

Recursos

Recursos