# ArgoCD

Kubernetes için pull-based GitOps continuous delivery aracı; Git repo'su ile küme durumunu izleyip kontrollü veya otomatik sync süreçleriyle dağıtımı sadeleştirir.

ArgoCD; Kubernetes için **pull-based GitOps** continuous delivery aracıdır. Argo projesi CNCF'te **graduated** statüdedir. Çekirdek prensip basittir: kümede çalışan bir controller, Git'teki manifest'leri sürekli izler ve fark gördüğünde kümeyi Git'teki istenen duruma yaklaştırır. Bu yaklaşım, uygulama dağıtımında **tek değişim girişi olarak Git** ilkesini güçlendirir; ancak cluster dışı veri, secret ve bağımlı servislerin yedeğini tek başına çözmez.

Görsel UI'ı, ArgoCD'yi Flux'tan ayıran en görünür özelliklerden biridir: kaynak ağacı, sync durumu, manifest diff ve rollout health bilgisi tek pencerede görülür. Kurumsal kullanımda asıl karar noktası ise UI değil; repo modeli, yetki sınırları, secret akışı, ortam onayları ve geri dönüş prosedürüdür.

## Kurulum seçenekleri
- **Resmi manifest:** `kubectl apply -n argocd -f install.yaml` , hızlı başlangıç ve test kümesi için yeterli.
- **Helm chart:** Community tarafından bakımı yapılan `argo-helm` chart'ı; values ile HA, ingress ve SSO ayarları tek yerden yönetilir. Üretim kurulumlarında Mono'nun tercihi budur.
- **HA kurulum:** Üretimde `argocd-repo-server` ve `argocd-application-controller` replikaları artırılır; Redis HA modda çalıştırılır.

## Tipik akış
1. Geliştirici `app-repo`'da PR açar → CI image build/push → CI manifest repo'da `image.tag` günceller.
2. ArgoCD manifest repo'daki değişikliği algılar → "OutOfSync" durumuna geçer.
3. Staging'de otomatik sync açıksa uygular; production'da çoğu kurgu manuel onay bekler.
4. Sync sonrası health check; aşamalı dağıtım için [Argo Rollouts ile canary deploy](/blog/kubernetes-canary-deploy-argocd/) yazımıza bakın.
5. Hata olursa rollout stratejisine göre otomatik abort veya manuel durdurma; uygulama manifest'i için Git revert, veri katmanı için ayrıca migration/restore planı uygulanır.

## Ne zaman doğru tercih değil?
- Kubernetes kullanmayan veya tek VM üzerinde çalışan küçük uygulamalar için ArgoCD gereksiz platform yükü yaratabilir.
- Git'te tutulmayan manuel üretim değişiklikleri normal kabul ediliyorsa GitOps disiplini önce organizasyonel olarak kurulmalıdır.
- Stateful uygulamalarda yalnızca manifest rollback'i yeterli görülüyorsa risk eksik değerlendirilmiştir; schema migration, volume snapshot ve dış servis bağımlılıkları ayrı plan ister.
- CI aracının cluster-admin yetkisiyle doğrudan deploy etmesi kısa vadede hızlı görünebilir; fakat audit, yetki ayrımı ve drift yönetimi ihtiyacı doğduğunda pull-based model daha güvenli olur.

## Yaygın sorunlar ve çözümler
- **"OutOfSync" sürekli görünüyor:** Mutating webhook'lar (örn. service-mesh sidecar enjekte ediyor) tarafından eklenen field'ları **`ignoreDifferences`** ile filtreleyin.
- **Webhook gecikmesi:** ArgoCD Git'i belirli aralıklarla yoklar; bu aralık `timeout.reconciliation` ayarıyla belirlenir ve varsayılanı dakikalar mertebesindedir. Değişikliğin daha hızlı yansıması gerekiyorsa GitHub/GitLab webhook entegrasyonu kurulmalıdır.
- **Sırlar:** Git'e şifresiz secret koymayın. **Sealed Secrets**, **External Secrets Operator** veya **SOPS** ile şifreli akış.
- **Yavaş büyük repo:** Manifest repo'sunu domain'lere ayırın; her takım kendi alt-projesinde.
- **Drift uyarısı:** SRE ekibine Slack alert; otomatik geri alma istiyorsanız `selfHeal: true` açıkça etkinleştirilir, istemiyorsanız manuel onay akışı korunur.

## Maliyet ve işletme kalemleri
ArgoCD için lisans bedeli yoktur; maliyet çoğunlukla işletme tarafındadır: HA kurulum, SSO/RBAC entegrasyonu, secret yönetimi, manifest repo standardı, uygulama ekiplerinin eğitimi, sürüm yükseltmeleri, yedek/restore tatbikatı ve incident runbook'ları. Alıcı açısından doğru soru "ArgoCD ücretsiz mi?" değil, "GitOps disiplinini kim tasarlayıp sürekli işletecek?" sorusudur.

## Resmi kaynaklar
- Argo CD dokümantasyonu: https://argo-cd.readthedocs.io/
- Argo CD GitHub deposu: https://github.com/argoproj/argo-cd
- CNCF Argo proje sayfası: https://www.cncf.io/projects/argo/

## Mono'nun yaklaşımı
GitOps sadece "araç kurmak" değil, **organizasyonel disiplin** gerektirir. Mono'nun ArgoCD kurulumlarında her zaman şu kararları netleştiririz:

- **Tek repo mu çoklu repo mu?** Genelde **iki repo:** uygulama kodu (CI ile container image build/push) + ortam manifest'leri (CD'nin tek kaynağı). Image promotion, manifest repo'da tag güncellemesi şeklinde olur.
- **App-of-Apps:** Her kümenin "root" Application'ı vardır; bu da diğer Application'ları yönetir. Yeni servis eklemek için tek dosya değiştirmek yeterli.
- **ApplicationSet:** Çoklu ortam (dev/staging/prod) ve çoklu küme senaryolarında uygulama tanımını tek şablona indirir. Ortak Helm chart'ı sabit kalır; her uygulama ve ortam kendi `values` dosyasıyla ayrışır.
- **Sync politikaları:** Üretim için **manual sync** + onay; staging için açıkça etkinleştirilmiş **automated sync + self-heal**. `prune` ve `selfHeal` varsayılan güvenli davranışlar değildir, uygulama bazında seçilir.
- **RBAC:** Geliştiriciler kendi namespace'lerine sync yetkisi; SRE/platform ekibi cluster-wide.
- **Operasyon sorumluluğu:** ArgoCD'nin kendi yedeği, sürüm yükseltmeleri, Redis/repo-server kapasitesi, Git provider erişimi, secret controller'ları ve acil rollback runbook'u baştan sahiplenilir.

## Sıkça sorulan sorular

### ArgoCD nedir?

ArgoCD, Kubernetes için **deklaratif, pull-based GitOps continuous delivery** aracıdır. Kümede çalışan bir controller Git'teki manifest'leri ve canlı küme durumunu izler; fark oluştuğunda uygulamayı **OutOfSync** gösterir. Eşitleme manuel yapılabilir veya uygulama bazında **automated sync** açıkça etkinleştirilebilir. CNCF'in **graduated** Argo projesinin parçasıdır.

### ArgoCD ücretsiz mi?

Evet. ArgoCD **Apache-2.0 lisanslı, %100 açık kaynak** bir projedir; lisans ücreti, node/kullanıcı sınırı veya ücretli 'enterprise sürümü' yoktur. Maliyet yalnızca işletme tarafındadır: kurulum, yükseltme, RBAC/SSO entegrasyonu ve GitOps disiplininin kurulması. Mono bu işletme yükünü üstlenen destek modeli sunar.

### ArgoCD ile Jenkins farkı nedir?

Sınırları farklıdır. Jenkins CI için güçlüdür; kodu derler, test eder, container image üretir ve isterse deploy da yapabilir. ArgoCD ise Kubernetes tarafında **GitOps CD** sağlar: manifest repo'sunu izler, farkı gösterir ve manuel ya da otomatik sync ile kümeye uygular. Birlikte kullanılabilirler, fakat bazı ekipler deploy'u Jenkins'te tutabilir; karar güvenlik, audit ve operasyon ayrımına göre verilir.

### ArgoCD mi Flux mu?

İkisi de pull-based GitOps. **ArgoCD** UI/UX ve görsel sync ağacı açısından daha güçlü; **Flux** GitOps Toolkit modüler yapısı ve CRD yönelimli operatör mimarisi açısından öne çıkar. Mono varsayılanı ArgoCD; çoklu küme + GitOps Toolkit ihtiyacı varsa Flux.

### Push (CI'dan kubectl) yerine neden pull?

**Güvenlik** - CI'a kümeye admin erişimi vermek zorunda değilsiniz. **Auditability** - Git, dağıtım tanımının tek kaynağı olur. **Drift yönetimi** - manuel değişiklikler görünür hâle gelir; otomatik geri alma için `selfHeal` ayrıca etkinleştirilmelidir. **Felaket kurtarma** - manifest'ler Git'ten yeniden uygulanabilir; fakat volume verileri, secret yönetimi ve dış servisler için ayrıca yedek/restore planı gerekir.

### Helm mi Kustomize mı kullanmalı?

ArgoCD ikisini de doğrudan destekler; seçim ekibin şablon yönetimi alışkanlığına bağlıdır. **Mono'nun varsayılanı Helm'dir:** kendi uygulamalarımız için ortak bir Helm chart'ı yazıp her uygulama ve ortam için ayrı `values` dosyası tutuyoruz. Böylece deployment, servis, kaynak limitleri ve zamanlama kuralları tek yerde standartlaşır; uygulamalar arasında yalnızca değerler değişir. Üçüncü taraf bileşenlerde (cert-manager, ingress-nginx) ilgili projenin kendi Helm chart'ı kullanılır. Kustomize da geçerli bir yoldur; özellikle hazır manifest'lere sınırlı yama uygulamak isteyen ekipler için uygundur.

### ApplicationSet ne işe yarar?

Çoklu küme veya çoklu ortam senaryolarında **uygulama tanımını parametrik şablona dönüştürür**. Örnek: 5 bölgedeki 5 kümeye aynı uygulamayı `cluster-name` parametresiyle deploy eden tek bir ApplicationSet, 25 ayrı YAML'ı eler.

## İlgili hizmetler
- [DevOps, Konteyner ve Mikroservis Tasarım ve Yönetimi](https://mono.tr/hizmetler/devops-konteyner-ve-mikroservis-tasarim-ve-yonetimi/)
- [Yazılım Geliştirme Yaşam Döngüsü Tasarımı (SDLC)](https://mono.tr/hizmetler/yazilim-gelistirme-yasam-dongusu-tasarimi-sdlc/)
- [Kod Olarak Altyapı (IaC) Dönüşümü](https://mono.tr/hizmetler/kod-olarak-altyapi-iac-donusumu/)

## GitOps dağıtım hattını netleştirelim

ArgoCD kurulumu, RBAC/SSO, ortam promotion akışı ve rollback disiplinini birlikte tasarlayalım. Mono ekibi kurulum ve işletme sorumluluklarını netleştirir.

[Görüşme Planla](https://mono.tr/gorusme-planla/)