Technical Tutorials

Yazılım geliştirme dünyasında hız ve güvenilirlik her şeyden önemlidir. Sürekli Entegrasyon ve Sürekli Dağıtım (CI/CD), artık lüks bir ayrıcalıktan ziyade ciddi bir mühendislik ekibi için vazgeçilmez bir altyapıya dönüşmüştür. Mevcut çeşitli araçlar arasında GitHub Actions, otomasyona sezgisel ve kod tabanlı bir yaklaşım sunarak baskın bir güç haline gelmiştir. Bu rehber, basit örneklerin ötesine geçerek mimari en iyi uygulamalara odaklanan, GitHub Actions kullanarak güçlü ve ölçeklenebilir CI/CD hatlarının nasıl oluşturulacağını keşfeder.

Temel Mimarayı Anlamak

Kod yazmadan önce, GitHub Actions'ın hiyerarşik yapısını anlamak kritik öneme sahiptir. Bir workflow (iş akışı), bir veya daha fazla job (iş) içeren, yapılandırılabilir bir otomatik süreçtir. Her bir iş, runner (çalıştırıcı) adı verilen yeni bir sanal makinede çalışır. İş akışı, deposunun .github/workflows/ dizininde saklanan YAML dosyalarında tanımlanır. Belirli bir olay gerçekleştiğinde—örneğin bir push, pull request veya manuel tetikleme—GitHub iş akışı yürütmesini başlatır.

Orta seviye geliştiriciler için verimlilik anahtarı, iş bağımlılıklarında yatar. needs anahtar kelimesinden yararlanarak, iş akışlarınızda yönlendirilmiş döngüsüz grafikler (DAG'ler) oluşturabilir ve dağıtımın yalnızca testlerin başarılı olması ve kod incelemesinin (linting) tamamlanması sonrasında gerçekleşmesini sağlayabilirsiniz.

Güçlü Bir CI İş Akışının Tanımlanması

Tipik bir CI hattı, kalite güvencesine odaklanır. Bu süreç bağımlılıkları getirmeyi, kaynak kodu derlemeyi, statik analiz yapmayı ve birim testlerini çalıştırmayı içerir. Aşağıda, bağımlılıkları önbelleğe alarak sonraki çalıştırmaları hızlandıran bir Node.js uygulaması için pratik bir örnek bulunmaktadır.

name: Continuous Integration

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  build-and-test:
    runs-on: ubuntu-latest

    strategy:
      matrix:
        node-version: [14.x, 16.x, 18.x]

    steps:
    - name: Checkout repository
      uses: actions/checkout@v3

    - name: Setup Node.js ${{ matrix.node-version }}
      uses: actions/setup-node@v3
      with:
        node-version: ${{ matrix.node-version }}
        cache: 'npm'

    - name: Install dependencies
      run: npm ci

    - name: Lint code
      run: npm run lint

    - name: Run unit tests
      run: npm test
      env:
        CI: true

Bu kod parçasında, birden fazla Node.js sürümü üzerindeki uyumluluğu aynı anda test etmek için bir matrix stratejisi kullanıyoruz. cache: 'npm' yönergesi, node_modules dizinini depolayarak derleme sürelerini önemli ölçüde azaltır; bu, büyük monorepo'lar için kritik bir optimizasyondur.

Dağıtımı Gizli Bilgiler Yönetimiyle Entegre Etme

Kodunuz CI aşamasını geçtiğinde, bir sonraki adım dağıtımdır. İşte burada secrets (gizli bilgiler) kritik hale gelir. API anahtarlarını, tokenları veya şifreleri asla kodun içine gömme (hardcode). Bunun yerine, bunları GitHub depo ayarlarınızda "Secrets and variables" > "Actions" altında saklayın. Ardından, bu gizli bilgileri iş akışınızda ${{ secrets.SECRET_NAME }} sözdizimini kullanarak başvurabilirsiniz.

Dağıtım için, CI işi başarılı olduğunda yalnızca çalışacak ayrı bir iş oluşturmak üzere needs anahtar kelimesini kullanmayı düşünün. Bu, bozuk kodun asla üretim ortamına ulaşmasını engeller.

  deploy:
    needs: build-and-test
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    steps:
    - name: Checkout code
      uses: actions/checkout@v3

    - name: Deploy to Production
      run: |
        echo "Deploying to production..."
        # Use environment-specific secrets
        ssh -o StrictHostKeyChecking=no user@production-server "cd /app && git pull && npm run build"
      env:
        SERVER_SSH_KEY: ${{ secrets.PRODUCTION_SSH_KEY }}

Bu örnek, temel bir SSH tabanlı dağıtımı göstermektedir. Ancak daha karmaşık ortamlar için, AWS CodeDeploy veya Kubernetes Helm grafikleri gibi özel dağıtım eylemlerini veya araçlarını kullanmayı düşünün. if koşulu, dağıtımın yalnızca ana dalda gerçekleşmesini sağlayarak özellik dallarından yanlışlıkla yayınlamaları önler.

Kurumsal Seviye Hatlar İçin En İyi Uygulamalar

Organizasyonunuz büyüdükçe, hatlarınız da karmaşıklık kazanacaktır. Bakılabilirliği korumak için aşağıdaki uygulamaları benimseyin:

Composite Actions ile Modülerleştirme: Karmaşık iş akışlarını yeniden kullanılabilir composite eylemlere ayırın. Bu, tekrarları azaltır ve mantığı merkezileştirir.
Dal Korumasını Zorlayın: GitHub'da, birleştirme öncesi durum kontrollerinin başarılı olmasını gerektirecek dal koruma kurallarını yapılandırın. Bu, CI/CD'nizi kod inceleme sürecinize doğrudan entegre eder.
İzleme ve Uyarı: İş akışı çalıştırmalarını izlemek için GitHub API'sini kullanın ve başarısızlıklar konusunda anında geri bildirim almak için Slack veya PagerDuty gibi uyarı araçlarıyla entegrasyon sağlayın.

Sonuç

GitHub Actions, CI/CD hatlarını uygulamak için güçlü ve esnek bir platform sağlar. İş akışları, işler ve çalıştırıcılar gibi temel kavramları anlamak; önbellekleme, güvenlik ve modülerlik konularındaki en iyi uygulamalara bağlı kalarak geliştiriciler, yazılım teslimat yaşam döngülerini güvenle otomatikleştirebilir. İster kişisel bir projeyi dağıtan tek başına bir geliştirici olun, ister büyük bir kurumsal ekibin parçası olun, GitHub Actions'da ustalaşmak DevOps mükemmelliğine ulaşmak için hayati bir adımdır.