AI CodeOps

Migration Specialist ajanı

Migration Specialist ajanı migration'ları, codemod'ları ve yükseltme adımlarını geri alma notlarıyla yazar. Dependency Refresh ve Data Migration'da çalışır.

Migration Specialist ajanı kodu ve veriyi bir biçimden başka bir biçime taşır. Veritabanı migration'larını, büyük ve mekanik kod değişiklikleri için codemod'ları ve adım adım yükseltme talimatlarını, her biri nasıl geri alınacağına dair notlarla birlikte yazar.

Nerede çalışır

İş akışıAdım
Dependency RefreshUpgrade
Data MigrationMigration

Dependency Refresh'te Dependency Auditor'ın bulgularını bir yükseltmeye dönüştürür. Data Migration'da ise Database Engineer'ın tasarladığı şema için migration'ı yazar; ardından Tester, Security Auditor ve Reviewer onu kontrol eder.

Girdiler

  • Oturumun görevi.
  • Projenin reposundaki ilgili dosyaların salt okunur bir anlık görüntüsü: manifest'ler, mevcut migration'lar ve etkilenen paketleri veya tabloları kullanan kod.
  • Bir önceki adım: bağımlılık denetimi veya şema tasarımı.

Çıktılar

Gerektirdiği kodla birlikte yazılı bir migration planı:

  • Bağımlılık yükseltmeleri için: sürüm değişiklikleri, geriye dönük uyumluluğu bozan her değişikliğin gerektirdiği kod düzenlemeleri ve bunların yapılma sırası.
  • Veri migration'ları için: migration'ın kendisi, mevcut satırların nasıl doldurulacağı (backfill) ve yarıda başarısız olursa ne yapılacağı.
  • Her adım için geri alma notları; geri almanın artık mümkün olmadığı noktalar dahil.

Onun adımı değişikliği uygulayan adımdır; bu yüzden oturumun kod geçişi dosyaları hemen ardından yazar ve projenin testleri verify (doğrulama) adımında sonuç üzerinde çalışır. Onu izleyen adımlar (Dependency Refresh'te Test ve Verify secure; Data Migration'da Validate, Security ve Final review) ardından yazılmış değişiklik ve kaydedilen test sonucu üzerinde çalışır. Bulgu geçişi diff'i en son inceler.

Örnek çalıştırma

Gösterim amaçlı bir örnektir, kaydedilmiş bir oturum değildir. Data Migration'da Database Engineer, milyonlarca satırı olan bir siparişler tablosuna not-null yeni bir durum sütunu tasarlamıştır. Migration Specialist işi üç migration'a böler: sütunu varsayılan değerli ve nullable olarak ekle, onu toplu işlerle doldur (backfill), ardından not-null kısıtlamasını ekle. İlk ikisinin sütun silinerek geri alınabileceğini, üçüncüsünün ise yalnızca backfill'in tamamlandığı doğrulandıktan sonra çalıştırılması gerektiğini not eder. Migration'lar yazılıp projenin testleri çalıştıktan sonra Tester onları okur ve her aşama için kontrolleri listeler.

Sınırlar

  • Migration çalıştırmaz ve veritabanınıza bağlanmaz. Satır sayılarını veya canlı kilitleri göremez.
  • Anlık görüntüde gördüğü kurallara uyar. Migration'ları alışılmadık bir yerde duran bir projede bunun görevde belirtilmesi gerekebilir.
  • Canlı ortamda daha önce çalışmış bir migration'ı asla düzenlemeyin. Bunun yerine yenisini isteyin.
  • Geri alma notları tavsiyedir. Onları canlı ortam dışındaki bir ortamda test edin.

Sık sorulan sorular

Migration Specialist ajanı migration'ları veritabanımda çalıştırır mı?

Hayır. Migration'ı reponuzda kod olarak yazar. Değişiklik onaylandıktan sonra onu çalıştırmak sizin kendi dağıtım sürecinize kalmıştır.

Bir geri alma notu neleri içerir?

Adımın nasıl geri alınacağını ve örneğin bir sütun silindikten sonra olduğu gibi, geri almanın ne zaman mümkün olmadığını. Herhangi bir şeyi çalıştırmadan önce karar verebilmeniz için yazılır.