# GitLab'i bağlama

> GitLab.com'u veya kendi yönettiğiniz bir GitLab sunucusunu OAuth veya kişisel erişim token'ı ile AI CodeOps'a bağlayın ve merge request'lerin sizin için nasıl açıldığını görün.

Kaynak: https://aicodeops.dev/tr/docs/git/gitlab

AI CodeOps, GitLab.com ve kendi yönettiğiniz (self-managed) GitLab sunucularıyla çalışır. Bir hesabı bir kez bağlayın; oturumlar ardından değişiklikleri yeni bir branch'e yazar ve inceleme için bir merge request açar.

## Başlamadan önce

- Kullanmak istediğiniz projelere en az Developer erişimi olan bir GitLab hesabı; böylece branch push edebilir ve merge request açabilir.
- Kendi yönettiğiniz bir sunucu için: herkese açık **https** adresi; örneğin `https://gitlab.example.com`. Platformun ona internet üzerinden ulaşabilmesi gerekir. Özel ağlardaki adresler, `localhost` ile `.local` veya `.internal` uzantılı adlar reddedilir.

## OAuth ile bağlanın

1. Çalışma alanınızda **Configure → Settings** sayfasını açın ve **Git Providers** bölümüne kaydırın.
2. **GitLab** kartında, GitLab.com için **Instance URL (blank for gitlab.com)** alanını boş bırakın.
3. **Connect via OAuth** düğmesini seçin ve isteği GitLab'de onaylayın.

AI CodeOps `api` ve `read_user` kapsamlarını ister. `api` kapsamı repoları okumasını, branch push etmesini ve merge request oluşturup merge etmesini sağlar; `read_user` kapsamı ise hangi hesabın bağlı olduğunu gösterir.

OAuth yalnızca platformun OAuth uygulamasının kayıtlı olduğu GitLab sunucusuyla çalışır (varsayılan olarak GitLab.com). Kart, OAuth'u yalnızca o sunucu için sunar. Başka her sunucu için token kullanın.

## Kişisel erişim token'ı ile bağlanın

Kendi yönettiğiniz bir sunucu için olağan yol budur.

1. GitLab'de `api` kapsamına sahip bir kişisel erişim token'ı oluşturun (**User settings → Access tokens**). `api` kapsamına ve Developer rolüne veya daha üstüne sahipse bir proje veya grup erişim token'ı da çalışır.
2. AI CodeOps'taki GitLab kartında **Instance URL** alanını doldurun (veya GitLab.com için boş bırakın).
3. Token'ı **or access token** alanına yapıştırın ve **Connect with token** düğmesini seçin.

AI CodeOps, token'ı kaydetmeden önce sunucunuzda kontrol eder. Bağlanamazsa mesaj hangi kısmın düzeltilmesi gerektiğini söyler: GitLab token'ı tanımadı, token'da `api` kapsamı eksik veya adreste hiçbir GitLab API'si yanıt vermedi. Token'lar yenilenmez: birinin süresi GitLab'de dolduğunda bağlantıyı kesin ve yeni bir token ile yeniden bağlanın.

## AI CodeOps repoyla neler yapar

- **Göz atma:** **Develop → Repositories** sayfası projelerinizi branch'leri, dosyaları ve merge request'leriyle birlikte listeler.
- **Branch'ler ve merge request'ler:** bir değişiklik onaylanıp [kalite kapılarından](https://aicodeops.dev/tr/docs/quality-gates) geçtiğinde AI CodeOps `codeops/run-<id>` adlı bir branch'i push eder ve projenin varsayılan branch'ine bir merge request açar. Commit'lerin yazarı "AI CodeOps" olarak görünür.
- **Merge:** konsolun açtığı bir merge request konsoldan merge edilebilir. Önce yayın kapısı yeniden çalışır.

Oturumlar projelerinize webhook kaydetmez ve AI CodeOps merge request'lere yorum yazmaz. **Build & Test → Builds** altında bağladığınız bir proje bunun istisnasıdır: bir push veya merge request'in build başlatabilmesi için bir webhook, her build'in sonucuyla birlikte de bir commit durumu alır.

## Token'ınız ve erişiminiz

- Bir bağlantı çalışma alanına değil, size aittir. Her üyenin neler yapabileceğine yine çalışma alanı rolleri karar verir.
- Token'lar depolanırken şifrelenir (AES-256-GCM). OAuth token'ları süreleri dolmadan önce yenilenir.
- Erişimi kaldırmak için hesabın yanındaki **Disconnect** düğmesini seçin veya token'ı GitLab'de iptal edin.

## Sonraki adımlar

- Bir GitLab reposundan [bir proje oluşturun](https://aicodeops.dev/tr/docs/projects).
- [İlk oturumunuzu çalıştırın](https://aicodeops.dev/tr/docs/sessions).
- Gitea veya Forgejo da mı kullanıyorsunuz? [Gitea'yı bağlama](https://aicodeops.dev/tr/docs/git/gitea) ve [Forgejo'yu bağlama](https://aicodeops.dev/tr/docs/git/forgejo) sayfalarına bakın.
