ArgoCD ile Versiyon Yönetimi

Argo CD, Kubernetes ortamları için geliştirilen açık kaynaklı bir GitOps Continuous Deployment aracıdır. GitOps’un temel taşı olan Single Source of Truth modeline dayanan bir mimariye sahiptir ve belirli aralıklarla Kubernetes’e dağıtılmış uygulamaları izleyerek git deposundaki yaml dosyalarıyla karşılaştırır. Herhangi bir değişiklik tespit ettiğinde otomatik olarak senkronize eder.

​

ArgoCD Kurulumu

ArgoCD’nin Kubernetes Cluster’a kurulumunu gerçekleştirmek için aşağıdaki adımları izleyin.

1. Namespace oluşturma

   ArgoCD için namespace oluşturun:

   kubectl create namespace argocd
   
2. ArgoCD kurulumu

   GitHub deposundan ArgoCD manifest dosyalarını uygulayın:

   kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
   
3. Pod durumunu izleme

   Pod’ların başlatılmasını izleyin:

   watch kubectl get pods -n argocd
   

   
4. Servis tipini yapılandırma

   ArgoCD arayüzüne erişim sağlamak için servis tipini NodePort olarak yapılandırın:

   kubectl patch svc argocd-server -n argocd -p '{"spec": {"type": "NodePort"}}'
   kubectl get svc argocd-server -n argocd
   

   
5. Arayüze erişim

   Servisinizin dışarı açtığı port adresini kullanarak ArgoCD arayüzüne erişin:

   http://<KUBERNETES_WORKER_IP_ADDRESS>:<PORT>
   

   
6. Şifre alma

   Base64 formatında kodlanmış şifreyi decode ederek görüntüleyin:

   kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d; echo
   

   Varsayılan kullanıcı adı admin’dir. Bu bilgileri kullanarak ArgoCD arayüzüne giriş yapabilirsiniz.

​

Git Kurulumu ve Repository Yapılandırması

Deployment dosyalarını GitHub’a push etmek için Git kurulumunu gerçekleştirin ve repository’yi yapılandırın.

1. Git kurulumu

   Git paketini kurun:

   sudo apt update
   sudo apt install git
   git --version
   

   Git sizden kullanıcı bilgilerini isteyebilir. Aşağıdaki komutları kullanarak yapılandırın:

   git config --global user.email "[e-mail]"
   git config --global user.name "Your Name"
   
2. GitHub repository oluşturma

   Deployment dosyalarınızı tutmak için GitHub üzerinden bir repository oluşturun.

3. Remote address yapılandırması

   GitHub repository’sine dosya ekleyebilmek için git sistemine remote address olarak ekleyin.

   Authentication Hatası Çözümü

   Eğer git kullanımında “Authentication failed” hatası alırsanız, aşağıdaki adımları takip edin:

   1. GitHub hesabınıza giriş yapın
   2. Sağ üst köşedeki profil resminize tıklayın ve “Settings” (Ayarlar) seçeneğini seçin
   3. Sol menüden “Developer settings” (Geliştirici ayarları) altında “Personal access tokens” seçeneğine gidin
   4. “Token” ardından “Generate new token” düğmesine tıklayın
   5. Gerekli izinleri verin
   6. Sayfanın en altına gidin ve “Generate token” düğmesine tıklayın
   7. Token değerini kopyalayın ve güvenli bir yere kaydedin. Bu değeri tekrar görüntüleyemezsiniz.

   Token ile remote address’i yapılandırın:

   git remote set-url origin https://<USERNAME>:<ACCESS_TOKEN>@<REPO_ADDRESS>
   

   Örnek: https://test:[e-mail]/test/test.git

4. Deployment dosyalarını push etme

   Apinizer Manager deployment yaml dosyasını git versiyon sistemine ekleyin ve uzak repository’ye push edin:

   git init
   git add apinizer-api-manager-deployment.yaml
   git commit -m "manager add"
   git remote add origin <GITHUB_REPO_ADDRESS>
   git push -u origin master
   

​

Git Repository’sinin ArgoCD’ye Eklenmesi

YAML dosyalarını GitHub repository’sine ekledikten sonra, ArgoCD arayüzünden bu repository adresini eklemeniz gerekmektedir.

Birçok bağlantı yöntemi vardır. HTTPS yöntemi için aşağıdaki alanları doldurmanız gereklidir.

Önemli

Bağlantı yöntemi olarak HTTPS seçilirse, password kısmına önceki adımda oluşturduğunuz token değerini yazınız.

​

ArgoCD Uygulama Oluşturma

ArgoCD üzerinde uygulama oluşturarak deployment süreçlerinizi otomatikleştirebilirsiniz.

1. Uygulama adı belirleme

   Uygulama için bir isim verin.

2. Sync Policy yapılandırması

   ArgoCD’nin repository’deki güncellemeleri otomatik olarak kontrol etmesini istiyorsanız, SYNC POLICY seçeneğini Automatic olarak ayarlayın.

   Automatic sync policy aktif olduğunda, ArgoCD sizin yerinize 3 dakikada bir kontrol sağlar.

   
3. Namespace otomatik oluşturma

   Kubernetes Cluster’ınızda daha önceden oluşturulmamış bir namespace’e ihtiyaç duyduğunuzda, AUTO-CREATE NAMESPACE seçeneği ile ArgoCD Kubernetes cluster’ınızda bir namespace oluşturur.

   

​

Uygulama Yönetimi

ArgoCD size deployment, replica set ve pod’ları görsel olarak gösterir. Pod’ların anlık log verilerini görüntüleyebilirsiniz.

Manuel Senkronizasyon: YAML dosyanızda yapılan bir değişikliği manuel olarak SYNC butonuna basarak senkronize edebilirsiniz.

Otomatik Senkronizasyon: YAML dosyalarında yapılan her değişikliği otomatik olarak tespit eden ArgoCD, pod’larınızı güncelleyerek deploy süreçlerinizi otomatikleştirir. Bu sayede deploy süreçleriniz daha verimli ve hızlı bir şekilde gerçekleşirken, manuel müdahalelerin ve hataların önüne geçebilirsiniz.