# Kapı denetimli dağıtımlar

> 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ı.

Kaynak: https://aicodeops.dev/tr/docs/gated-deploys · Son güncelleme: 2026-10-18

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

1. Bir oturumun değişikliği testlerinden ve yapay zekâ incelemesinden geçer ve bir insan onu onaylar. Bkz. [Kalite kapıları](https://aicodeops.dev/tr/docs/quality-gates).
2. AI CodeOps pull request'i açar.
3. 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.
4. 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

1. **Release → Deployments** sayfasını açın ve **Deploy targets** düğmesini seçin.
2. Her proje için **Deploy webhook URL** alanını doldurun. Herkese açık bir `https://` adresi olmalıdır.
3. Dağıtım yaptığı ortamı **Environment** alanına girin. Varsayılan `production` değeridir.
4. İsterseniz bir **Signing secret** girin.
5. **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:

```json
{
  "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:

```json
{ "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](https://aicodeops.dev/tr/docs/approvals-and-policies).

## Bir dağıtımı elle kaydedin

AI CodeOps dışında gerçekleşen dağıtımlar için:

1. **Release → Deployments** sayfasını açın ve **Record deployment** düğmesini seçin.
2. **Project** alanında projeyi seçin ve **Environment** alanına ortamı girin.
3. **Status** alanını ayarlayın: succeeded, in progress, queued veya failed.
4. İsterseniz bir **Version** ve bir **Commit SHA** (en az 7 karakter) ekleyin.
5. **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](https://aicodeops.dev/tr/docs/evidence-packs) 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](https://aicodeops.dev/tr/docs/api); [CI'da yayın kapısı](https://aicodeops.dev/tr/docs/release-gate-ci) 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

- [Geri alma](https://aicodeops.dev/tr/docs/rollback)
- [Kalite kapıları](https://aicodeops.dev/tr/docs/quality-gates)
- [Kapı denetimli dağıtımlar ve geri alma takibi](https://aicodeops.dev/tr/product/deploy)

## 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.
