Agent Migration Specialist
L'agent Migration Specialist écrit des migrations, des codemods et des étapes de mise à niveau avec des notes de rollback. Il intervient dans Dependency Refresh et Data Migration.
L'agent Migration Specialist fait passer le code et les données d'une forme à une autre. Il rédige des migrations de base de données, des codemods pour les changements de code volumineux et mécaniques, et des instructions de mise à niveau étape par étape, chaque élément étant accompagné de notes sur la façon de faire un rollback.
Où il intervient
| Workflow | Étape |
|---|---|
| Dependency Refresh | Upgrade |
| Data Migration | Migration |
Dans Dependency Refresh, il transforme les constats du Dependency Auditor en mise à niveau. Dans Data Migration, il écrit la migration correspondant au schéma conçu par le Database Engineer, avant que le Tester, le Security Auditor et le Reviewer la vérifient.
Entrées
- La tâche de la session.
- Un instantané en lecture seule des fichiers pertinents du dépôt du projet : manifestes, migrations existantes, et code qui utilise les paquets ou les tables concernés.
- L'étape précédente : l'audit des dépendances ou la conception du schéma.
Sorties
Un plan de migration rédigé, avec le code dont il a besoin :
- Pour les mises à niveau de dépendances : les changements de version, les modifications de code qu'exige chaque changement incompatible, et l'ordre dans lequel les effectuer.
- Pour les migrations de données : la migration elle-même, la façon dont les lignes existantes sont remplies (backfill), et que faire si elle échoue à mi-parcours.
- Des notes de rollback pour chaque étape, y compris les points au-delà desquels le rollback n'est plus possible.
Son étape est celle qui implémente le changement : la passe de code de la session écrit donc les fichiers juste après elle, et les tests du projet s'exécutent sur le résultat à l'étape verify (vérification). Les étapes qui la suivent (Test et Verify secure dans Dependency Refresh ; Validate, Security et Final review dans Data Migration) s'exécutent ensuite sur le changement écrit et le résultat de test enregistré. La passe des constats relit le diff en dernier.
Exemple d'exécution
Exemple illustratif, pas une session enregistrée. Dans Data Migration, le Database Engineer a conçu une nouvelle colonne de statut non nulle sur une table de commandes qui compte des millions de lignes. Le Migration Specialist répartit le travail en trois migrations : ajouter la colonne en nullable avec une valeur par défaut, la remplir par lots, puis ajouter la contrainte not-null. Il note que les deux premières peuvent faire l'objet d'un rollback en supprimant la colonne, et que la troisième ne doit s'exécuter qu'une fois le backfill confirmé comme terminé. Une fois les migrations écrites et les tests du projet exécutés, le Tester les lit et liste des vérifications pour chaque phase.
Limites
- Il n'exécute pas de migrations et ne se connecte pas à votre base de données. Il ne peut voir ni le nombre de lignes ni les verrous en cours.
- Il suit les conventions qu'il voit dans l'instantané. Pour un projet dont les migrations se trouvent à un endroit inhabituel, il peut être nécessaire de le signaler dans la tâche.
- Ne modifiez jamais une migration qui a déjà été exécutée en production. Demandez-en plutôt une nouvelle.
- Les notes de rollback sont des conseils. Testez-les dans un environnement hors production.
Questions fréquentes
L'agent Migration Specialist exécute-t-il des migrations sur ma base de données ?
Non. Il écrit la migration sous forme de code dans votre dépôt. Son exécution relève de votre propre processus de déploiement, une fois le changement approuvé.
Que contient une note de rollback ?
Comment annuler l'étape, et quand l'annulation n'est pas possible, par exemple après la suppression d'une colonne. Elle est rédigée pour que vous puissiez décider avant d'exécuter quoi que ce soit.