- Ana sayfa
- Dokümantasyon
- Kapı denetimli dağıtımlar
Kapı denetimli dağıtımlar
Son güncelleme
AI CodeOps merge edilen bir değişikliği dağıtım pipeline'ınıza nasıl devreder: merge öncesi kalite kapısı, dağıtım webhook'ları, ortam bazında politika kuralları ve dağıtım kayıtları.
AI CodeOps altyapınıza kod dağıtmaz. Değişikliği merge edilmeden önce kapıdan geçirir, merge edildiğinde dağıtım pipeline'ınızı çağırır ve her dağıtımın kaydını tutar. Build'i ve yayını kendi pipeline'ınız yapar.
Dağıtıma giden yol
- Bir oturumun değişikliği testlerinden ve yapay zekâ incelemesinden geçer ve bir insan onu onaylar. Bkz. Kalite kapıları.
- AI CodeOps pull request'i açar.
- Onu konsoldan merge edersiniz. Önce kalite kapısı yeniden çalışır: açık yüksek (high) veya kritik (critical) bulgular, başarısız testler veya tamamlanmamış bir inceleme merge işlemini durdurur.
- Değişikliğin projesinin bir dağıtım hedefi varsa AI CodeOps onun webhook'unu çağırır ve bir dağıtım kaydeder.
Merge için dağıtımları yönetebilen bir rol gerekir: Owner, Admin, Developer, Member ve DevOps Admin. Kapı kontrolü çalışamıyorsa merge gerçekleşmez: "The release check couldn't run just now. Try again in a moment."
Merge sırasındaki kapı, AI CodeOps'un bir oturum için açtığı pull request'lere uygulanır. Birinin elle yazdığı bir pull request'in oturumu yoktur; dolayısıyla kapının onu değerlendireceği bulgu veya test yoktur.
Bir dağıtım hedefi ayarlayın
- Release → Deployments sayfasını açın ve Deploy targets düğmesini seçin.
- Her proje için Deploy webhook URL alanını doldurun. Herkese açık bir
https://adresi olmalıdır. - Dağıtım yaptığı ortamı Environment alanına girin. Varsayılan
productiondeğeridir. - İsterseniz bir Signing secret girin.
- Save düğmesini seçin.
O proje için otomatik dağıtımları kapatmak için URL'yi boş bırakın. Dağıtım hedeflerini ayarlamak için projeleri yönetebilen bir rol gerekir.
Webhook'unuz ne alır
Bir değişiklik konsoldan merge edildiğinde AI CodeOps şu gövdeyle bir POST isteği gönderir:
{
"event": "pr_merged",
"workspaceID": "wrk_…",
"projectID": "billing-api",
"repo": "acme/billing-api",
"prNumber": 42,
"prUrl": "https://github.com/acme/billing-api/pull/42"
}
Bir signing secret ile istek X-CodeOps-Signature: sha256=<hex> başlığını taşır: ham gövdenin, secret'ınızla anahtarlanmış HMAC-SHA256 değeri. Dağıtım yapmadan önce bunu kontrol edin.
Çağrı 10 saniye sonra zaman aşımına uğrar ve yönlendirmeleri izlemez. Bir 2xx yanıtı dağıtımı in progress olarak kaydeder. Başka her şey onu "The deploy webhook answered HTTP …" mesajıyla failed olarak kaydeder ve bir olay açar. Yeniden göndermek için satırdaki Retry delivery düğmesini seçin; her yeniden deneme yeni bir kayıttır.
Pipeline'ınız nihai sonucu AI CodeOps'a geri bildiremez; dolayısıyla webhook ile gönderilen bir dağıtım geçmişte in progress olarak kalır. Biten bir dağıtımı sonucuyla birlikte kaydetmek için onu elle kaydedin (aşağıda).
Otomatik dağıtımlara izin verin veya reddedin
Otomatik dağıtımlar, çalışma alanı politikanızın ortam adıyla eşleştirilen release.deploy kurallarına uyar. Örneğin şu kural production ortamına otomatik dağıtımları durdurur:
{ "id": "no-production-deploys", "action": "release.deploy", "resource": "production", "decision": "deny" }
Reddedilen bir dağıtım asla gönderilmez. canceled olarak kaydedilir ve satır, gerekçesiyle birlikte "not deployed" ifadesini gösterir. Politika yüklenemezse dağıtım aynı şekilde iptal edilir. Bu kurallar yalnızca izin verebilir veya reddedebilir; bir onayı bekleyemezler. Retry delivery düğmesini seçen bir kişi için bu kurallar değil, rolü belirleyicidir. Bkz. Onaylar ve politikalar.
Bir dağıtımı elle kaydedin
AI CodeOps dışında gerçekleşen dağıtımlar için:
- Release → Deployments sayfasını açın ve Record deployment düğmesini seçin.
- Project alanında projeyi seçin ve Environment alanına ortamı girin.
- Status alanını ayarlayın: succeeded, in progress, queued veya failed.
- İsterseniz bir Version ve bir Commit SHA (en az 7 karakter) ekleyin.
- Record deployment düğmesini seçin.
Dağıtım kayıtları
Her kayıtta proje, ortam ve ortam başına bir sıra numarası, commit veya sürüm, durum, başlangıç ve bitiş zamanları ve değişikliği üreten oturum bulunur. Durumlar queued, in progress, succeeded, failed, rolled back ve canceled değerleridir.
Bir oturumun değişikliği için başarılı olan bir dağıtım, değişikliği Develop → Changes altında deployed olarak işaretler. Kayıtlar gösterge panelindeki teslimat metriklerini ve değişikliğin kanıt paketini besler.
Bir yayını CI'dan kontrol edin
Pipeline'ınız dağıtım yapmadan önce yayın kapısına sorabilir. POST /api/release/check adresini bir çalışma alanı API anahtarı, pull request URL'si veya commit SHA'sı ve requireDeployedTo gibi seçeneklerle çağırın. "requireDeployedTo": "staging" ile, değişikliğin staging ortamında hâlihazırda succeeded durumunda bir dağıtımı yoksa yayın reddedilir: "Not yet deployed to "staging" — promote there before releasing". Yanıttaki allowed alanını kontrol edin. Alanlar API sayfasındadır; CI'da yayın kapısı sayfasında ise kopyalanacak pipeline işleri bulunur.
Aynı kontrolü Review & Gate → Release gate altında elle de çalıştırabilirsiniz: bir pull request URL'si veya commit SHA'sı girin ve Evaluate gate düğmesini seçin.
Sonraki adımlar
Sık sorulan sorular
AI CodeOps sunucularıma dağıtım yapar mı?
Hayır. Proje bazında ayarladığınız bir dağıtım webhook'unu çağırır ve dağıtımı kendi pipeline'ınız yapar. AI CodeOps altyapınız için hiçbir kimlik bilgisi tutmaz.
Bir politika production ortamına otomatik dağıtımları durdurabilir mi?
Evet. Bir release.deploy kuralı otomatik dağıtımları ortam bazında reddedebilir. Reddedilen bir dağıtım, gerekçesiyle birlikte canceled olarak kaydedilir ve hiçbir şey gönderilmez.
Bir dağıtım insan onayını bekleyebilir mi?
Ayrı bir adım olarak hayır. Onay daha önce, değişiklik üzerinde, pull request'i açılmadan önce verilir. Dağıtım kuralları yalnızca izin verebilir veya reddedebilir.