AI CodeOps

Yapay zekâ değişiklikleri için kapı denetimli dağıtım ve geri alma kayıtları

AI CodeOps dağıtım webhook'unuzu ancak yapay zekâ değişikliği kapıdan geçip merge edilince çağırır, her dağıtımı ve geri almayı kaydeder, hata olursa olay açar.

AI CodeOps'ta dağıtım aşaması, onaylanmış bir yapay zekâ değişikliği konsoldan merge edildiğinde başlar: AI CodeOps projenin dağıtım webhook'unu çağırır, kendi pipeline'ınız da değişikliği derleyip yayına alır. Her dağıtım ve geri alma değişikliğe bağlı olarak kaydedilir, hatalar bir olay (incident) açar ve kayıtlar teslimat metriklerinizi besler.

Kendi kodunu doğrudan canlı ortama merge edebilen bir yapay zekâ ajanı, çoğu ekibin almayacağı bir risktir. AI CodeOps'ta bir değişiklik dağıtım pipeline'ınıza ancak testlerden, bulgu incelemesinden ve bir insanın onayından geçtikten sonra ulaşır; kapı, merge işleminden hemen önce yeniden kontrol edilir. AI CodeOps, sunucularınızın veya kümelerinizin kimlik bilgilerini asla tutmaz.

Hangi ajanlar çalışır

Dağıtımı bir ajan değil, pipeline'ınız yapar. Ajanlar dağıtıma giden değişiklikler ve sonrasında olanlar üzerinde çalışır:

Incident Response iş akışından gelen bir düzeltme, diğer her değişiklikle aynı kapıdan ve onaydan geçer.

Dört DORA metriğini ve son production ile staging dağıtımlarını gösteren AI CodeOps Deploys sayfası; dağıtımlardan biri rolled back olarak işaretlenmiş

Etkileşimli demo, örnek veriler.

Değişiklikten dağıtıma giden yol

  1. Bir yapay zekâ oturumu bir değişiklik üretir. Testler bu değişiklik üzerinde bir sandbox içinde çalışır ve bulgu incelemesi diff'i okur.
  2. Kalite kapısı sonucu kontrol eder ve bir insan değişikliği onaylar. Onay verebilecek başka biri varsa, onaylayan kişi oturumu başlatan kişi olamaz.
  3. AI CodeOps, pull request'i Git platformunuzda açar.
  4. Pull request konsoldan merge edilirken kapı, merge işleminden önce yeniden kontrol edilir.
  5. Projenin bir dağıtım webhook'u varsa AI CodeOps onu çağırır ve dağıtımı kaydeder.

Kapı hata durumunda kapalı kalır. Bir kontrol hata verirse merge veya dağıtım gerçekleşmez.

Dağıtım webhook'ları

Her projenin, Deployments sayfasında (Release altında) ayarlanan bir dağıtım webhook'u olabilir: herkese açık bir HTTPS URL'si, staging veya production gibi dağıtım yaptığı ortam ve isteğe bağlı bir HMAC secret'ı. Özel ağlardaki adresler, herhangi bir şey gönderilmeden önce reddedilir.

Bir değişiklik konsol üzerinden merge edildiğinde AI CodeOps şuna benzer bir POST isteği gönderir:

POST /hooks/deploy HTTP/1.1
Content-Type: application/json
X-CodeOps-Signature: sha256=5c1f0e9a7b2d4c6e8f0a1b3c5d7e9f2a4b6c8d0e1f3a5b7c9d2e4f6a8b0c1d3e

{"event":"pr_merged","workspaceID":"wrk_01JA8X2B4D6F8H0K2M4P6R8T0V","projectID":"checkout","repo":"acme/checkout","prNumber":42,"prUrl":"https://github.com/acme/checkout/pull/42"}

İmza başlığı yalnızca bir secret ayarladığınızda bulunur. Ham gövdenin, secret'ınızla anahtarlanmış onaltılık HMAC-SHA256 değeridir; böylece alıcınız çağrının AI CodeOps'tan geldiğini doğrulayabilir. Alıcı 2xx durum koduyla yanıt verirse dağıtım in progress olarak kaydedilir; aksi hâlde failed olarak kaydedilir ve yeniden deneyebilirsiniz. Her yeniden deneme ayrı bir kayıttır. Yayın, çağrı gönderilmeden önce kaydedilir; bu sayede iki kez bildirilen bir merge iki kez dağıtılmaz.

Dağıtım kayıtları

Otomatik olsun elle girilmiş olsun her dağıtım; projeyi, ortamı, commit SHA'sını, Git ref'ini ve sürümünü, onu kimin veya neyin tetiklediğini ve değişikliği üreten oturumu içeren bir kayda dönüşür. Durumu queued, in progress, succeeded, failed, rolled back veya canceled olur. AI CodeOps dışında yapılan dağıtımları Deployments sayfasından veya API üzerinden ekleyebilirsiniz; böylece geçmiş, tüm yayın sürecinizi kapsar.

Her değişikliğin sayfası pull request'ine ve dağıtımına bağlantı verir; ikisi de değişikliğin imzalı kanıt paketine girer.

Geri almalar pipeline'ınızda gerçekleşir. AI CodeOps eski bir sürümü yeniden dağıtmaz. Deployments sayfasındaki Mark as rolled back düğmesi, succeeded veya failed durumundaki bir dağıtımı rolled back durumuna getirir ve bu, değişiklik hata oranınıza sayılır. Bir kaydı yalnızca rolü dağıtımları yönetebilen üyeler değiştirebilir.

Başarısız dağıtımlar olay açar. Bir dağıtım başarısız olduğunda AI CodeOps ona bağlı bir olay açar. prod, production, live veya main adlı ortamlardaki hatalar daha yüksek bir önem derecesi alır. Bir olayın düzeltmesi merge edildiğinde olay, ancak düzeltme dağıtıldıktan sonra çözülmüş sayılır.

İlgili kalite kapıları

  • Merge öncesinde yayın kapısı. Bir oturumun açtığı pull request, konsoldan ancak kapısı hâlâ geçiyorsa merge edilir: inceleme tamamlanmış, engelleyici bulgu yok, güncel sürümde başarısız test yok.
  • Önce onay. Değişiklik, pull request'i açılmadan önce onaylanmıştır ve sonrasında kodunu düzenlemek bu onayı sıfırlar.
  • Dağıtım politikası. Bir release.deploy kuralı, otomatik dağıtımlara production gibi ortam bazında izin verebilir veya bunları reddedebilir. Reddedilen bir dağıtım, gerekçesiyle birlikte canceled olarak kaydedilir. Bir dağıtımı elle yeniden deneyen kişi için ise bunun yerine rolü belirleyicidir.
  • CI'dan ortam yükseltme. requireDeployedTo alanıyla /api/release/check adresine yapılan bir çağrı, o ortamda henüz succeeded durumunda bir dağıtımı olmayan yayını reddeder.

Teslimat metrikleri

Gösterge paneli, dağıtım ve olay kayıtlarınızdan hesaplanan dört DORA metriğini son 30 gün için gösterir: dağıtım sıklığı, bir değişikliği başlatan oturumdan dağıtımına kadar geçen teslim süresi, değişiklik hata oranı ve hizmeti geri getirme süresi. Webhook ile gönderilen bir dağıtım, durumu güncellenene kadar in progress olarak kalır; bu yüzden durumları güncel tutun, yoksa metrikler eksik sayar.

Sık sorulan sorular

AI CodeOps nereye dağıtım yapar?

Altyapıya kendisi dağıtım yapmaz. Proje bazında ayarladığınız, isteğe bağlı bir HMAC secret'ı ile imzalanan bir dağıtım webhook'unu çağırır; dağıtımı kendi pipeline'ınız yapar.

AI CodeOps başarısız bir dağıtımı otomatik olarak geri alır mı?

Hayır. Geri alma, kendi dağıtım pipeline'ınızda gerçekleşir. Ardından dağıtımı AI CodeOps'ta rolled back olarak işaretlersiniz; AI CodeOps kaydı saklar ve bunu değişiklik hata oranınıza dahil eder.

Bir politika otomatik dağıtımları durdurabilir mi?

Evet. release.deploy üzerindeki bir çalışma alanı politika kuralı, otomatik dağıtımlara ortam bazında izin verebilir veya bunları reddedebilir. Reddedilen bir dağıtım gönderilmez ve gerekçesiyle birlikte canceled olarak kaydedilir.

Dağıtımlar için insan onayı zorunlu tutulabilir mi?

Bugün için ayrı bir adım olarak hayır. Onay daha önce, değişikliğin kendisi üzerinde, pull request'i açılmadan önce verilir. Politikalar otomatik dağıtımlara izin verebilir veya bunları reddedebilir, ancak onay için bekletemez.

Staging başarılı olana kadar production engellenebilir mi?

Evet, CI'ınızdan. requireDeployedTo alanı staging olarak ayarlanmış bir yayın kapısı çağrısı, aynı değişikliğin orada succeeded durumunda bir dağıtımı yoksa yayını reddeder.