KURUMSAL EĞİTİM, ARGO CD FUNDAMENTALS

ARGO CD VE GİTOPS EĞİTİMİ

Yazılım ekipleri artık kodu geliştirmekten çok kodu üretime taşımakla zaman kaybediyor. Manuel deployment adımları, tutarsız ortam konfigürasyonları, kim ne değiştirdi bilinmiyor, geri alma (rollback) başlı başına bir kriz — bunların hepsi aslında aynı problemin belirtisi: sürüm kontrolü dışında kalan altyapı konfigürasyonu. GitOps, bu problemi kökten çözer: Git tek gerçek kaynaktır ve sistem her zaman Git'te tanımlı duruma kendiliğinden döner. Kubernetes için GitOps'un uygulamaya dökülmüş hali ise Argo CD'dir.

Bu eğitim, .NET geliştiricilerinin, DevOps mühendislerinin ve yazılım mimarlarının Argo CD'yi kavramsal düzeyden üretim ortamına taşımasını sağlayan kapsamlı bir programdır. GitOps felsefesinin temel ilkelerinden Argo CD'nin üç bileşenli mimarisine (API Server, Repo Server, Application Controller), Helm ve Kustomize entegrasyonundan sync policy'lere (auto-sync, self-heal, prune), CLI yönetiminden RBAC ve ApplicationSet'e, Resource Hook'lardan CI/CD entegrasyonuna uzanan yedi modüle yayılan uygulamalı bir program sunar.

Her modül, gerçek .NET projelerinin Kubernetes'e dağıtılması senaryoları üzerinden işlenir. Katılımcılar eğitim boyunca kendi geliştirme ortamlarında hands-on çalışmalar yapar: Application manifest yazar, Helm Chart hazırlar, Kustomize overlay'leri oluşturur, rollback dener ve CI pipeline'ını Argo CD senkronizasyonuna bağlar.

Eğitim sonunda katılımcılar; Git'i tek gerçek kaynak olarak kullanarak Kubernetes dağıtımlarını tamamen otomatikleştirir, konfigürasyon kaymasını (drift) engeller ve geri almayı bir Git revert'e indirger. Bu, deployment kaosunun kesin çözümüdür.

EĞİTİM HEDEFİ

Bu eğitimin temel hedefi, katılımcılara Argo CD ve GitOps metodolojisini yalnızca kavramsal düzeyde öğretmekle kalmayıp; gerçek Kubernetes ortamında .NET uygulamalarının uçtan uca GitOps pipeline'ını kurma, yönetme ve operasyonel olarak sürdürme yetkinliği kazandırmaktır. Eğitim sonunda katılımcılar; GitOps'un dört temel prensibini derinlemesine kavrar ve bunları kendi deployment süreçlerine yansıtır. Argo CD Application kaynağını YAML ile tanımlar ve Git reposunu hedef Kubernetes kümesine bağlar; auto-sync, self-heal ve prune politikalarını doğru kurallarla yapılandırır. Helm Chart ve Kustomize overlay'leri Argo CD üzerinden çok ortamda (dev/staging/prod) yönetir; rollback'i Git geçmişinden gerçekleştirir. ApplicationSet ile çok servisli mikroservis mimarisini tek kaynaktan orkestre eder; PreSync/PostSync Resource Hook'larıyla veritabanı migration gibi kritik adımları otomatikleştirir; RBAC ile ekip ve proje bazlı erişim politikası uygular; Slack bildirimleri ile CI/CD entegrasyonu kurar.

EĞİTİM İÇERİĞİ

MODÜL 1: GİTOPS FELSEFESİ VE KUBERNETES TEMELLERİ

• GitOps Nedir ve Neden Önemlidir? GitOps'un dört temel prensibi: Declarative (bildirimsel konfigürasyon), Versioned (sürümlü ve değiştirilemez), Pulled (çekme tabanlı güncelleme) ve Continuously Reconciled (sürekli uyumluluk); geleneksel push tabanlı deployment ile GitOps'un pull tabanlı yaklaşımı arasındaki mimari fark ve güvenlik avantajı.
• Git'i Tek Gerçek Kaynak Olarak Kullanmak: Uygulama kodu, Kubernetes manifest'leri ve altyapı konfigürasyonunun Git'te versiyonlanmasının sağladığı izlenebilirlik; her deployment değişikliğinin commit geçmişinde görünmesi; audit trail ve compliance kazanımları.
• Kubernetes Temel Kavramları — .NET Odaklı Bakış: Pod, Deployment, Service, ConfigMap, Secret ve Namespace kavramlarının .NET uygulamaları bağlamında anlamı; bir ASP.NET Core API'sini Kubernetes'te çalıştırmak için gereken minimum manifest seti; kubectl ile küme yönetimi temelleri.
• YAML ile Kubernetes Manifest Yazımı: YAML sözdiziminin anatomisi; Deployment, Service ve ConfigMap manifest dosyalarını okuma ve yazma; yaygın YAML hataları ve hızlı doğrulama yöntemleri.
• Git Branch Stratejileri ve GitOps: feature branch, develop, main akışının GitOps deployment döngüsüyle ilişkisi; GitHub, GitLab ve Azure Repos'ta app repo ile config repo ayrımı; mono-repo ve poly-repo yaklaşımlarının karşılaştırması.

MODÜL 2: ARGO CD MİMARİSİ VE İLK UYGULAMA DAĞITIMI

• Argo CD'nin Üç Temel Bileşeni: API Server (UI, CLI ve CI sistemleri için giriş noktası), Repository Server (Git repo'larındaki manifest'leri önbellekleyen ve işleyen servis) ve Application Controller (Git ile küme arasındaki farkı sürekli izleyen ve uyumluluk döngüsünü yöneten kontrolcü).
• Application Kaynağı ve Manifest Anatomisi: Argo CD'nin temel CRD'si olan `Application` objesinin yapısı: `repoURL`, `path`, `targetRevision`, `destination.server`, `destination.namespace` ve `syncPolicy` alanları; bir Application YAML dosyasını sıfırdan yazma pratiği.
• İlk Deployment — .NET API Uygulaması: Basit bir ASP.NET Core API'sinin Kubernetes manifest'inin hazırlanması; Git reposuna push edilmesi ve Argo CD Application kaynağının bu manifest'e bağlanması; ilk sync işleminin adım adım izlenmesi.
• Argo CD Kullanıcı Arayüzü: Web UI'a erişim ve gezinme; uygulama ağaç görünümünde (resource tree) Pod, Deployment, Service ilişkilerinin görselleştirilmesi; sync status (Synced/OutOfSync) ve health status (Healthy/Degraded/Progressing) okuma ve yorumlama.
• Argo CD'nin Git Repo'yu İzleme Mekanizması: Polling aralığı ve webhook tabanlı tetikleme karşılaştırması; GitHub ve GitLab webhook yapılandırması; Repo Server'ın manifest önbellekleme ve refresh döngüsü.

MODÜL 3: SENKRONİZASYON STRATEJİLERİ VE SAĞLIK KONTROLLERİ

• Senkronizasyon Politikaları — Otomatik ve Manuel: Auto-Sync ile Git'teki her değişikliğin otomatik olarak kümeye uygulanması; Manuel Sync ile değişikliklerin onay sonrası uygulanması; ortam tipine (dev/prod) göre doğru politika seçimi.
• Self-Heal — Kendi Kendini İyileştirme: Kubernetes kümesinde `kubectl edit` veya diğer yollarla yapılan manuel değişikliklerin (drift) Argo CD tarafından otomatik olarak Git'teki duruma geri döndürülmesi; self-heal politikasının etkinleştirilmesi ve test edilmesi.
• Prune — Eski Kaynakları Temizleme: Git'ten silinen Kubernetes kaynağının kümeden de otomatik olarak kaldırılması; prune seçeneğinin riskleri ve hangi ortamlarda dikkatli kullanılması gerektiği; `--dry-run` ile prune önizlemesi.
• Sağlık Kontrolleri (Health Checks): Argo CD'nin Deployment, StatefulSet, DaemonSet, CronJob ve Service için yerleşik sağlık değerlendirme mantığı; bir Pod'un CrashLoopBackOff durumunda Argo CD'nin "Degraded" sağlık durumunu nasıl raporladığı.
• Rollback — Geri Alma: Hatalı bir deployment sonrasında Git geçmişindeki önceki sürüme dönme; Argo CD UI ve CLI üzerinden rollback işlemi; otomatik sync etkin olduğunda rollback davranışının nasıl yönetileceği.

MODÜL 4: KONFİGÜRASYON YÖNETİMİ — HELM VE KUSTOMIZE

• Helm ile Argo CD Entegrasyonu: Helm Chart'ın anatomisi (Chart.yaml, values.yaml, templates/); Argo CD'nin Helm kaynak tipini otomatik algılaması; `values.yaml` dosyalarıyla chart özelleştirme; `.NET Core` uygulaması için basit bir Helm Chart oluşturma ve Argo CD üzerinden dağıtma.
• Helm Chart'larla Çok Ortam Yönetimi: `values-dev.yaml`, `values-staging.yaml`, `values-prod.yaml` ile ortam özgün değerlerin ayrıştırılması; Argo CD Application kaynağında `helm.valueFiles` parametresinin kullanımı; Helm secrets ve harici secret yönetim araçları entegrasyonu.
• Kustomize ile Argo CD Entegrasyonu: Kustomize'ın şablon gerektirmeyen overlay yaklaşımı; `base/` ve `overlays/` dizin yapısı; `kustomization.yaml` dosyasının yapılandırılması; geliştirme, staging ve production ortamları için ayrı Kustomize overlay'leri oluşturma.
• Düz YAML Manifest Dizileri: Helm veya Kustomize kullanmadan doğrudan Kubernetes YAML dosyalarını içeren Git dizinlerinin Argo CD ile senkronize edilmesi; `directory.recurse` ile iç içe dizinlerin işlenmesi.
• Helm ve Kustomize Karşılaştırması: Hangi proje tipinde Helm, hangisinde Kustomize daha uygundur; Kustomize ile Helm'i birlikte kullanmak (Helm-Kustomize hibrit); kurumsal standart template yaklaşımı önerileri.

MODÜL 5: CLI YÖNETİMİ, PROJELER VE RBAC

• Argo CD CLI — Tam Kontrol: `argocd login` ile sunucu kimlik doğrulaması; `argocd app create`, `argocd app sync`, `argocd app list`, `argocd app get` ve `argocd app delete` komutlarının pratik kullanımı; CI/CD pipeline son adımında CLI ile senkronizasyon tetikleme.
• `argocd app diff` ve Sorun Tespiti: Git'teki istenen durum ile kümedeki mevcut durum arasındaki farkı önceden görme; `argocd app logs` ile container log erişimi; `argocd app history` ile deployment geçmişini inceleme.
• Argo CD Projeleri: Argo CD Project CRD'si ile uygulamaları mantıksal gruplara ayırma; proje bazlı kaynak kısıtlamaları (hangi küme, hangi namespace, hangi kaynak türleri); çok ekipli organizasyonlarda proje izolasyonunun önemi.
• Rol Tabanlı Erişim Kontrolü (RBAC): Argo CD'nin dahili RBAC sistemi ve `policy.csv` yapısı; geliştirici, operasyon ve yönetici rollerinin tanımlanması; proje bazlı RBAC kuralları: belirli bir kullanıcıya yalnızca belirli projede sync izni verme.
• SSO Entegrasyonu — Genel Bakış: Dex üzerinden Azure AD, GitHub OAuth ve LDAP entegrasyonu; grup bazlı RBAC ile kurumsal kimlik yönetim sisteminin Argo CD'ye bağlanması; SSO token'larının Argo CD CLI ile kullanımı.

MODÜL 6: GELİŞMİŞ YÖNETİM — APPLICATIONSET VE RESOURCE HOOK'LAR

• ApplicationSet Controller — Çok Uygulama Orkestrasyonu: Tek bir ApplicationSet manifest'inden onlarca Argo CD Application kaynağını otomatik üretme; monorepo içindeki her microservice klasörü için ayrı Application oluşturan Git Directory Generator.
• ApplicationSet Generator Türleri: List Generator (sabit küme/ortam listesi), Cluster Generator (kayıtlı tüm cluster'larda deployment), Matrix Generator (generator'ların iç çarpımı) ve Pull Request Generator (her PR için izole ortam oluşturma) kullanım senaryoları.
• Resource Hook'lar — Sync Yaşam Döngüsü Kontrolü: PreSync (senkronizasyondan önce çalışan Job): veritabanı migration, schema güncelleme; Sync (kaynak oluşturma aşamasında); PostSync (deployment tamamlandıktan sonra): smoke test, bildirim gönderme; Hook başarısızlığında sync davranışının kontrolü.
• Sync Waves ile Dağıtım Sıralaması: `argocd.argoproj.io/sync-wave` annotation'ı ile kaynakların belirli bir sırayla deploy edilmesi; önce ConfigMap ve Secret, sonra Deployment, en son Ingress gibi bağımlılık temelli sıralama.
• Özel Sağlık Kontrolleri ve CRD Yönetimi: Yerleşik health check'lerin yetersiz kaldığı Kubernetes Operator ve Custom Resource senaryoları için Lua script ile özel sağlık kontrolü yazımı; CRD'leri Argo CD üzerinden yönetmenin avantajları ve dikkat noktaları.

MODÜL 7: CI/CD ENTEGRASYONU, GÜVENLİK VE ÜRETİM MİMARİSİ

• CI ve CD'nin Ayrılması — GitOps Yaklaşımı: CI pipeline'ının görevi: kodu build etmek, test etmek ve container image'ı registry'e push etmek; CD'nin görevi: Git config reposunu güncellemek ve Argo CD'nin senkronizasyonu devralması; Push vs Pull CD modelinin güvenlik avantajı.
• Image Updater ile Otomatik Image Güncelleme: Argo CD Image Updater'ın container registry'yi izleyerek yeni etiket (tag) çıktığında config repo'yu otomatik güncellemesi; semver, latest ve regex etiket filtreleme stratejileri; commit mesajı şablonu ile .NET CI'ından gelen yeni image'ın deployment'a yansıtılması.
• GitHub Actions / Azure DevOps ile Tam CI/CD Pipeline: .NET build → Docker image → registry push → config repo güncelleme → Argo CD auto-sync akışının uçtan uca kurulumu; CI sonunda `argocd app sync` CLI çağrısıyla senkronizasyonun manuel tetiklenmesi alternatifleri.
• Secret Yönetimi — Kubernetes Secrets ve Vault Entegrasyonu: Git'e plain text secret commit etmemenin zorunluluğu; Sealed Secrets ile şifreli secret Git'e kaydetme; HashiCorp Vault veya Azure Key Vault'un Argo CD pipeline'ına entegrasyonu; External Secrets Operator kullanım örneği.
• Yüksek Erişilebilirlik ve Ölçeklendirme: Argo CD HA kurulumu için Application Controller, Repo Server ve API Server replikasyonu; Redis HA ile oturum dayanıklılığı; artan microservice sayısıyla Repo Server'a gelen yükü yatay ölçeklendirme ile dengeleme.
• Bildirimler ve Gözlemlenebilirlik: Argo CD Notifications Controller ile sync başarı/başarısızlık ve sağlık değişimi olaylarının Slack, Microsoft Teams ve e-posta'ya iletilmesi; Prometheus metriklerinin Grafana'dan izlenmesi; `argocd_app_info`, `argocd_app_sync_total` ve `argocd_cluster_info` metriklerinin anlamı.

EĞİTİM YÖNTEMİ

• Kavramsal Anlatım ve Mimari Diyagramlar: Her konu, yazılım sistemlerinden tanıdık bir analoji ve gerçek mühendislik problemiyle açılır; ardından Argo CD'nin bu problemi nasıl çözdüğü mimari diyagramlarla somutlaştırılır. GitOps döngüsünün her adımı görsel olarak aktarılır.
• Hands-On Laboratuvarlar — Gerçek Kubernetes Kümesi: Eğitim boyunca her modülün karşılığı olan pratik egzersizler, katılımcıların kendi ortamlarında kurulu Kubernetes kümesi (minikube, kind veya bulut) ve Argo CD üzerinde yürütülür. Application manifest yazımından ApplicationSet kurulumuna kadar her adım bizzat uygulanır.
• .NET Projesi Odaklı Senaryolar: Tüm örnekler ASP.NET Core API ve .NET mikroservis senaryoları üzerinden işlenir; katılımcılar kendi .NET projelerini Argo CD pipeline'ına entegre etmeye hazır biçimde ayrılır.
• Kasıtlı Hata Yaratma ve Sorun Giderme Pratiği: Sync hatası, self-heal testi, yanlış yapılandırılmış manifest ve drift senaryoları kasıtlı olarak oluşturulur; katılımcılar Argo CD loglarını okuyarak ve `argocd app diff` kullanarak hataları bağımsız olarak giderme becerisi kazanır.
• CI/CD Pipeline Simülasyonu: GitHub Actions veya Azure DevOps ile .NET build pipeline'ı entegre edilerek Argo CD senkronizasyonunu tetikleyen uçtan uca bir deployment akışı simüle edilir; katılımcılar her adımın tetikleyicisini ve çıktısını gerçek zamanlı izler.
• Danışmanlık ve Açık Soru-Cevap: Her gün sonunda serbest danışmanlık zamanı; katılımcılar kendi Kubernetes ve deployment mimarilerine özgü sorularını uzmana yöneltir; CKA, CKS ve Argo CD Associate sertifikasyon yolları hakkında rehberlik sağlanır.

HEDEF KİTLE

.NET C# GELİŞTİRİCİLERİ VE FULL-STACK MÜHENDİSLER

• Kubernetes ortamlarına .NET uygulamalarını GitOps prensiplerine uygun biçimde dağıtmak, deployment süreçlerini tamamen otomatikleştirmek ve Git'i deployment'ın tek kontrol noktası haline getirmek isteyen .NET geliştiricileri ve full-stack mühendisler.

DEVOPS VE SRE MÜHENDİSLERİ

• Kubernetes deployment pipeline'larını standartlaştırmak, konfigürasyon kaymasını (drift) sistematik olarak engellemek, rollback süresini dakikalardan saniyelere indirmek ve Argo CD'yi kurumsal ölçekte (çok küme, çok ekip) yönetmek isteyen DevOps ve SRE mühendisleri.

YAZILIM MİMARLARI VE TEKNİK LİDERLER

• Mikroservis mimarisinde uçtan uca GitOps akışını tasarlamak, ApplicationSet ile çok servisli deployment stratejisi oluşturmak, Helm ve Kustomize arasında bilinçli mimari kararlar almak ve ekiplere deployment standartları belirlemek isteyen yazılım mimarları ve teknik liderler.

SİSTEM YÖNETİCİLERİ VE OPERASYON UZMANLARI

• Kubernetes kümelerindeki uygulama yaşam döngüsünü Argo CD ile daha etkin ve şeffaf biçimde yönetmek, RBAC ile erişim kontrolü uygulamak, sync sorunlarını hızla teşhis etmek ve yüksek erişilebilir Argo CD kurulumunu operasyonel olarak sürdürmek isteyen sistem yöneticileri.

TEKNİK PROJE YÖNETİCİLERİ VE TAKIM LİDERLERİ

• Yazılım teslim süreçlerinin şeffaflığını ve denetlenebilirliğini artırmak, deployment gecikmelerini ve insan kaynaklı hataları azaltmak, GitOps yaklaşımının iş değerini üst yönetime raporlamak isteyen teknik proje yöneticileri ve takım liderleri.

KATILIMCILARDAN BEKLENTİLERİMİZ

• Temel Kubernetes Bilgisi: Pod, Deployment, Service ve Namespace kavramlarını genel düzeyde bilmek; `kubectl get pods` veya `kubectl apply` gibi temel komutları daha önce çalıştırmış olmak. İleri Kubernetes uzmanlığı beklenmez; modül 1'de gerekli temeller aktarılır.
• Git Temel Kullanımı: `git commit`, `git push`, `git pull` ve `git branch` komutlarını pratikte kullanmış olmak; Git'in yazılım geliştirme sürecindeki rolünü kavramış olmak. GitOps felsefesinin incelikleri eğitim kapsamında öğretilir.
• YAML Okuma ve Yazma: Kubernetes manifest dosyalarında girinti, liste ve eşleme (map) gibi temel YAML yapılarını okuyup anlayabilmek; kendi başına basit bir Deployment YAML'ı yazabilmek.
• Temel .NET/C# Uygulama Geliştirme Deneyimi: Eğitim .NET odaklı olduğundan, bir ASP.NET Core projesi oluşturup Docker image haline getirme konusunda temel deneyim faydalıdır; bu adımlar eğitimde açıklamalı biçimde gösterilir.
• Hands-On Uygulamalara Aktif Katılım: Lab ortamında kendi bilgisayarında Argo CD kurulumunu takip etmeye, verilen manifest'leri yazmaya ve hata senaryolarını bizzat test etmeye istekli olmak. Argo CD'yi gerçekten öğrenmenin tek yolu uygulamaktır.