Agente Migration Specialist
El agente Migration Specialist escribe migraciones, codemods y pasos de actualización con notas de rollback. Se ejecuta en Dependency Refresh y Data Migration.
El agente Migration Specialist lleva código y datos de una forma a otra. Escribe migraciones de bases de datos, codemods para cambios de código grandes y mecánicos, e instrucciones de actualización paso a paso, cada una con notas sobre cómo hacer rollback.
Dónde se ejecuta
| Flujo de trabajo | Paso |
|---|---|
| Dependency Refresh | Upgrade |
| Data Migration | Migration |
En Dependency Refresh convierte los hallazgos del Dependency Auditor en una actualización. En Data Migration escribe la migración para el esquema que diseñó el Database Engineer, antes de que el Tester, el Security Auditor y el Reviewer la comprueben.
Entradas
- La tarea de la sesión.
- Una instantánea de solo lectura de los archivos relevantes del repositorio del proyecto: manifiestos, migraciones existentes y el código que usa los paquetes o las tablas afectados.
- El paso anterior: la auditoría de dependencias o el diseño del esquema.
Salidas
Un plan de migración por escrito, con el código que necesita:
- Para actualizaciones de dependencias: los cambios de versión, las modificaciones de código que necesita cada cambio incompatible y el orden en que hacerlas.
- Para migraciones de datos: la propia migración, cómo se rellenan las filas existentes y qué hacer si falla a medias.
- Notas de rollback para cada paso, incluidos los puntos a partir de los cuales ya no es posible el rollback.
Su paso es el que implementa el cambio, así que la pasada de código de la sesión escribe los archivos justo después y las pruebas del proyecto se ejecutan contra el resultado en el paso verify (verificación). Los pasos que lo siguen (Test y Verify secure en Dependency Refresh; Validate, Security y Final review en Data Migration) se ejecutan entonces sobre el cambio escrito y el resultado de pruebas registrado. La pasada de hallazgos revisa el diff al final.
Ejemplo de ejecución
Ejemplo ilustrativo, no una sesión registrada. En Data Migration, el Database Engineer ha diseñado una nueva columna de estado not-null en una tabla de pedidos con millones de filas. El Migration Specialist divide el trabajo en tres migraciones: añadir la columna como nullable con un valor por defecto, rellenarla por lotes y después añadir la restricción not-null. Señala que las dos primeras se pueden deshacer eliminando la columna, y que la tercera solo debe ejecutarse cuando se haya confirmado que el relleno está completo. Una vez escritas las migraciones y ejecutadas las pruebas del proyecto, el Tester las lee y enumera comprobaciones para cada etapa.
Límites
- No ejecuta migraciones ni se conecta a tu base de datos. No puede ver recuentos de filas ni bloqueos en vivo.
- Sigue las convenciones que ve en la instantánea. En un proyecto con las migraciones en un lugar poco habitual, puede que haya que indicarlo en la tarea.
- No edites nunca una migración que ya se haya ejecutado en producción. Pide una nueva en su lugar.
- Las notas de rollback son consejos. Pruébalas en un entorno que no sea de producción.
Preguntas frecuentes
¿El agente Migration Specialist ejecuta migraciones contra mi base de datos?
No. Escribe la migración como código en tu repositorio. Ejecutarla le corresponde a tu propio proceso de despliegue, una vez aprobado el cambio.
¿Qué contiene una nota de rollback?
Cómo deshacer el paso, y cuándo no es posible deshacerlo, por ejemplo después de eliminar una columna. Está escrita para que puedas decidir antes de ejecutar nada.