Blog

GitHub Actions, GitLab ve Jenkins ile Otomatik Gece API Testleri Nasıl Yapılır

API'leriniz için gecelik derleme ayarlayın: Apidog CLI ile CI'da otomatik regresyon testlerini planlayın. Sabaha kadar hataları yakalamak için GitHub Actions, GitLab ve Jenkins cron konfigürasyonlarını kopyalayıp yapıştırın.

Ashley Innocent

Ashley Innocent

15 June 2026

GitHub Actions, GitLab ve Jenkins ile Otomatik Gece API Testleri Nasıl Yapılır

enterprise.banner.title

enterprise.banner.feature1

enterprise.banner.feature2

enterprise.banner.feature3

enterprise.banner.ctaB

API testleriniz her çekme isteğinde (pull request) başarılı olur. Derleme yeşildir. Ürünü dağıtırsınız. Sonra sabah 9'da, farklı bir zaman dilimindeki biri, ödeme işleminin 500 hatası verdiğini bildirir ve kimse ödeme kodunu değiştirmemiştir. Değişen şey üçüncü taraf bir ödeme sanal ortamı, gece boyunca çalışan bir veritabanı geçişi veya sessizce süresi dolmuş bir token olabilir. Her commit'e özel testleriniz bunu asla yakalayamadı çünkü deponuzda hiçbir şey hareket etmedi.

Gece derlemesi (nightly build) işte bu boşluğu kapatır. Gece derlemesi, genellikle sabahın erken saatlerinde, yalnızca kod değişiklikleri yerine gerçek hizmetleriniz ve ortamlarınız üzerinde günde bir kez çalışan, zamanlanmış, tam bir test çalışmasıdır. Commit'ler arasındaki hataları yakalar: veri kayması, istikrarsız entegrasyonlar, süresi dolmuş kimlik bilgileri, performanstaki yavaş sızıntılar ve kontrolünüz dışındaki hizmetlerin neden olduğu sözleşme ihlalleri. Özellikle API'ler için, gece çalışan bir regresyon testi, kurabileceğiniz en ucuz erken uyarı sistemidir.

Bu rehber, bu sistemi Apidog ile uçtan uca kurmayı anlatıyor. Bir regresyon paketi tasarlayacak, Apidog CLI ile bir komut satırı çalıştırması oluşturacak, bunu GitHub Actions, GitLab ve Jenkins'teki zamanlanmış bir CI işine bağlayacak ve toplantıdan (standup) önce sizi bekleyen bir rapora sahip olacaksınız. Eğer bir gece çalıştırmasının saatler önce tespit edeceği bir kesintinin hata ayıklamasını yaptıysanız, bu iş akışı size o saatleri geri kazandırır.

Düğme

Commit Başına Testler Neden Yeterli Değil?

Sürekli entegrasyon bizi her itme (push) işleminde test yapmaya alıştırdı. Bu iyi bir şey ve yapmaya devam etmelisiniz. Ancak commit başına testler dar bir soruyu yanıtlar: "Bu değişiklik bir şeyi bozdu mu?" Hızlı çalışırlar, sık çalışırlar ve geliştiricilerin engelsiz kalmasını sağlamak için kapsamları belirlenmiştir. Bu kapsam belirleme, tam da bir dizi problemi neden kaçırdıklarının nedenidir.

Bir gece derlemesi daha geniş bir soruyu yanıtlar: "Kimse dokunup dokunmadığına bakılmaksızın sistem şu anda hala sağlıklı mı?" Fark önemlidir çünkü üretim ortamında commit'lerinizin asla görmediği hareketli parçalar bulunur.

Bu nedenle desen iki katmanlıdır, ya o ya bu değil. Hızlı smoke testler her commit'i korur. Daha derin bir regresyon paketi bir programa göre çalışır. Gece katmanı, çok yavaş, çok geniş veya canlı dünyaya çok bağımlı olduğu için iç döngüye ait olmayan her şeyi koyduğunuz yerdir.

Gece API Regresyon Paketinde Neler Bulunur?

Herhangi bir şeyi planlamadan önce, gece çalıştırmasının gerçekten neyi kontrol ettiğine karar verin. Gece paketi, commit kapısı smoke testlerinizden daha geniş ve hızlı bir sağlık kontrolünden daha kapsamlıdır. Sessizce bozulduğunda sizi utandıracak bir kapsamı hedefleyin.

Sağlam bir gece API paketi şunları kapsar:

Daha önce bu tür yapılandırılmış durumlar yazmadıysanız, API test senaryosu şablonu ve örneği iyi bir başlangıç noktasıdır ve API iddiaları yanıt gövdesini, durumunu, başlıklarını ve zamanlamasını hassas bir şekilde nasıl doğrulayacağınızı kapsar.

Adım 1: Apidog'da regresyon paketini oluşturun

Apidog, testi API yaşam döngüsünün birinci sınıf bir parçası olarak görür, eklenti olarak değil. Uç noktaları tasarlar, ardından bunları gerçek iş akışlarını yansıtan test senaryolarına zincirlersiniz. Bir senaryo, her adımın iddiaları olan bir API isteği olduğu ve verilerin bir adımdan diğerine aktığı sıralı bir adım listesidir.

İşte bir ödeme regresyon senaryosunun şekli:

  1. POST /auth/login: kimlik bilgilerini gönder, 200 olduğunu iddia et, yanıttan accessToken değerini bir değişkene çıkar.
  2. POST /carts: token kullanarak bir sepet oluştur, 201 olduğunu iddia et, cartId değerini çıkar.
  3. POST /carts/{cartId}/items: bir ürün ekle, 200 olduğunu iddia et, yanıt gövdesinin total değerinin beklenen fiyata eşit olduğunu iddia et.
  4. POST /checkout: sepeti gönder, 200 olduğunu iddia et, order.status değerinin "confirmed" olduğunu iddia et.
  5. GET /orders/{orderId}: siparişi geri oku, doğru kalemlerle kalıcı olduğunu iddia et.

Apidog'da bunu görsel olarak oluşturursunuz. Her adım, kalıp kod yazmaya gerek kalmadan iddialara sahip olur: "yanıt durumu 200" veya "JSONPath $.order.status teyit edildiye eşittir" gibi görsel bir iddia. Şema uyumluluğu için Apidog, yanıtı uç noktanın kaydedilmiş OpenAPI tanımına göre otomatik olarak doğrulayabilir, böylece her alan için el ile bir kontrol yazmak zorunda kalmazsınız.

Bir gece paketini sürdürülebilir kılan birkaç tasarım kuralı:

Başka bir araçtan geliyorsanız, bu bildiğiniz kavramlarla sorunsuz bir şekilde eşleşir. Senaryoları bir araya getirmenin daha geniş resmi API test orkestrasyon rehberinde yer almaktadır ve daha önce Apidog'da yapılandırılmış bir test çalıştırmadıysanız, Apidog ile API testi nasıl yapılır adım adım başlangıç noktasıdır. Daha fazla okumadan önce Apidog'u indirin ve bir senaryo oluşturun; bu rehberin geri kalanı, çalıştıracak bir pakete sahip olduğunuzu varsaymaktadır.

Adım 2: Paketi komut satırından çalıştırın

Bir gece derlemesi gözetimsiz çalıştığı için, başsız bir çalıştırıcıya (headless runner) ihtiyaç duyar. Bu, kaydedilmiş test senaryolarınızı herhangi bir terminalden, GUI gerektirmeden çalıştıran bir npm paketi olan Apidog CLI'dır. Tam da bunun için yapılmıştır: bir CI/CD hattı içinde otomatik çalıştırmalar.

Genel olarak kurun. CLI, Node.js v16 veya daha yenisini gerektirir.

npm install -g apidog-cli

Çevrimiçi bir senaryoyu (Apidog projenizde bulunan bir senaryo) çalıştırmak için iki şeye ihtiyacınız vardır: bir erişim tokenı ve senaryo veya paket kimliği. Tokeni Apidog'da CI/CD ayarları altında, "Erişim tokenı ekle" düğmesinin bulunduğu yerden oluşturun. Bu tokeni bir parola gibi değerlendirin; bir sır olarak saklanmalı, asla deponuza konmamalıdır.

Tek bir test senaryosu çalıştırma komutu şöyle görünür:

apidog run \
  --access-token $APIDOG_ACCESS_TOKEN \
  -t 123456 \
  -e 789 \
  -r cli,html \
  --out-dir ./apidog-reports

Gerçek Apidog CLI seçeneklerini kullanarak bayrak bayrak:

Diğer bayraklar gece çalıştırmasında yerini alır. -n, --iteration-count <n> istikrarsızlığı yüzeye çıkarmak için çalıştırmayı tekrarlar. -d, --iteration-data <path> bir CSV veya JSON dosyasını besler, böylece bir senaryo birçok veri satırı üzerinde çalışır; sınır testi için mükemmeldir. --env-var "key=value" ve --global-var "key=value" çalışma zamanında değerleri enjekte eder, kimlik bilgilerini kaydedilmiş senaryonun dışında tutmanın yolu budur.

Bunu ezberlemenize gerek yok. Apidog sizin için tam komutu üretir: istemcide CI/CD panelini açın, senaryonuzu veya paketinizi seçin ve hazır apidog run satırını doğrudan işlem hattı yapılandırmanıza kopyalayın. Zamanlamadan önce yeşil olduğunu doğrulamak için önce yerel olarak bir kez çalıştırın.

Adım 3: Gece derlemesi olarak zamanlayın

Bir gece derlemesi, zamanlayıcı üzerinde çalışan bir komuttur. Her CI platformu, cron sözdizimi aracılığıyla zamanlanmış işleri destekler. Tüm platformlarda desen aynıdır: günlük bir tetikleyici, bir sırttan erişim tokenı, CLI çalıştırması ve bir yapıt (artifact) olarak arşivlenen rapor.

GitHub Actions

GitHub Actions, standart cron ile bir schedule tetikleyicisini destekler. Bu iş akışı her gün 02:00 UTC'de çalışır ve ayrıca workflow_dispatch aracılığıyla manuel bir düğme sunar.

name: Nightly API Regression

on:
  schedule:
    - cron: '0 2 * * *'   # Her gün 02:00 UTC
  workflow_dispatch:        # manuel çalıştırmalara izin ver

jobs:
  regression:
    runs-on: ubuntu-latest
    steps:
      - name: Node'u kur
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Apidog CLI'ı yükle
        run: npm install -g apidog-cli

      - name: Gece regresyon paketini çalıştır
        run: |
          apidog run \
            --access-token $APIDOG_ACCESS_TOKEN \
            --test-suite ${{ vars.APIDOG_SUITE_ID }} \
            -e ${{ vars.APIDOG_ENV_ID }} \
            -r cli,html \
            --out-dir ./apidog-reports
        env:
          APIDOG_ACCESS_TOKEN: ${{ secrets.APIDOG_ACCESS_TOKEN }}

      - name: HTML raporunu yükle
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: apidog-nightly-report
          path: ./apidog-reports

Yükleme adımındaki if: always() önemlidir: çalıştırma başarısız olsa bile raporun arşivlenmesini istersiniz, çünkü bir hata tam olarak onu okumanız gerektiği zamandır. GitHub'ın zamanlanmış işlerinin UTC'de çalıştığını ve yoğun yük sırasında gecikebileceğini unutmayın, bu nedenle tam olarak belirli bir saniyede tetiklenmesi gereken hiçbir şeyi zamanlamayın.

GitLab CI/CD

GitLab, işlem hatlarını YAML yerine UI aracılığıyla (CI/CD > Schedules) zamanlar, ardından işiniz bir kurallar koşuluna dayanır, böylece yalnızca programa göre çalışır, her push işleminde değil.

nightly-regression:
  image: node:20
  rules:
    - if: '$CI_PIPELINE_SOURCE == "schedule"'
  before_script:
    - npm install -g apidog-cli
  script:
    - apidog run
        --access-token "$APIDOG_ACCESS_TOKEN"
        --test-suite "$APIDOG_SUITE_ID"
        -e "$APIDOG_ENV_ID"
        -r cli,html
        --out-dir ./apidog-reports
  artifacts:
    when: always
    paths:
      - apidog-reports/
    expire_in: 30 days

APIDOG_ACCESS_TOKEN'i maskelenmiş, korumalı bir CI/CD değişkeni olarak ayarlayın, ardından 0 2 * * * gibi bir cron ifadesiyle bir işlem hattı zamanlaması oluşturun. rules bloğu, bu işin normal commit'lerde çalışmasını engeller.

Jenkins

Jenkins'te, bir cron tetikleyicili bir pipeline aynı işi yapar. Tokeni bir kimlik bilgisi olarak saklayın ve withCredentials ile çekin.

pipeline {
    agent any
    triggers {
        cron('H 2 * * *')   // yaklaşık 02:00, H yükü dağıtır
    }
    stages {
        stage('Install CLI') { // CLI'ı Yükle
            steps { sh 'npm install -g apidog-cli' }
        }
        stage('Nightly regression') { // Gece regresyonu
            steps {
                withCredentials([string(credentialsId: 'apidog-token',
                                        variable: 'APIDOG_ACCESS_TOKEN')]) {
                    sh '''
                        apidog run \
                          --access-token $APIDOG_ACCESS_TOKEN \
                          --test-suite $APIDOG_SUITE_ID \
                          -e $APIDOG_ENV_ID \
                          -r cli,html \
                          --out-dir ./apidog-reports
                    '''
                }
            }
        }
    }
    post {
        always {
            archiveArtifacts artifacts: 'apidog-reports/**', allowEmptyArchive: true
        }
    }
}

H 2 * * * içindeki H, bir Jenkins özelliğidir: saat içinde kararlı bir dakika seçer, böylece tüm gece işleriniz tam olarak 02:00'de yığılma yapmaz.

Bu cron alanı üç platformda da aynıdır. 0 2 * * *, her gün dakika 0, saat 2 demektir. Sorunları daha erken yakalamak için gece iki kez çalışmasını ister misiniz? 0 2,14 * * *. Sadece hafta içi mi? 0 2 * * 1-5. Hazırlık ortamınızın sessiz olduğu ve harici sanal ortamların aktif olduğu bir zaman seçin.

Adım 4: Hataları Göz Ardı Edilemez Hale Getirin

Kimsenin okumadığı bir günlük dosyasına başarısız olan bir gece çalıştırması, hiç gece çalıştırmamasından daha kötüdür; sahte bir güven duygusu yaratır. Buradaki asıl amaç uyarıdır. Sonucu ekibinizin zaten baktığı yere bağlayın.

CLI'ın çıkış kodu sizin kancanızdır. Bir senaryo başarısız olduğunda apidog run sıfırdan farklı bir değerle çıkar, bu nedenle CI işi otomatik olarak kırmızıya döner. Buradan itibaren:

Gece derlemelerini güvenilir tutan bir disiplin: bir hata aksi kanıtlanana kadar gerçek bir hata olarak ele alınmalıdır. Bir gece paketini öldürmenin en hızlı yolu, istikrarsız testlerin herkesi kırmızıyı görmezden gelmeye alıştırmasına izin vermektir. Bir senaryo aralıklı olarak başarısız olursa, testi veya ortamı düzeltin; omuz silkip geçmeyin. Bir senaryoyu tekrarlamak için -n ile çalıştırmak veya senaryonuzun bağlı olduğu verileri stabilize etmek genellikle gerçek istikrarsızlığı ortaya çıkarır.

Apidog Gece Çalıştırma Modelini Neden Uyuyor?

Gece API işlem hattını ayrı parçalardan bir araya getirebilirsiniz: tasarlamak için bir araç, test yazmak için başka bir araç, onları başsız çalıştırmak için üçüncü bir araç ve eklenmiş bir şema doğrulayıcı. Birçok ekip bu şekilde yaşar ve parçalar senkronizasyondan sapana kadar işe yarar. Sürtünme, sabah 2'de, çalıştırıcının yürüttüğü testin gerçekten gönderdiğiniz API ile artık eşleşmediği zaman ortaya çıkar.

Apidog bunu tek bir iş akışına indirger. Tasarladığınız uç nokta, test ettiğiniz senaryo, doğruladığınız şema ve zamanladığınız komutun tümü aynı doğruluk kaynağını referans alır. Bir uç noktayı değiştirdiğinizde, senaryo ve şema kontrolü onunla birlikte hareket eder. Dışa aktarma adımı yoktur, sessizce eskiyen bir koleksiyon yoktur, senkronize tutulacak ikinci bir sözleşme kopyası yoktur. Eğer gerçek bir doğruluk kaynağı olmayan Postman koleksiyonlarının acısını hissettiyseniz, bu tek kaynaklı tasarım fark yaratır.

CLI, GUI ile aynı motordur, bu nedenle masanızda görsel olarak hata ayıkladığınız bir senaryo, sabah 2'de CI'da aynı şekilde çalışır. Testleri tam görünürlükle oluşturur ve düzeltir, ardından tek bir komutla başsız çalıştırırsınız. Bu simetri, bir gece derlemesini bebek bakıcılığı yaptığınız bir şey yerine güvendiğiniz bir şey haline getirir.

Sıkça Sorulan Sorular

Gece derlemesi (nightly build) ile sürekli entegrasyon arasındaki fark nedir?

Sürekli entegrasyon, yeni commit'lerdeki regresyonları yakalamak için her kod değişikliğinde testler çalıştırır. Bir gece derlemesi, herhangi bir şeyin değişip değişmediğine bakılmaksızın, genellikle gece boyunca, sabit bir programa göre çalışır. CI ekibinizin bozukluklarını yakalar; gece çalıştırması dış dünyanın bozukluklarını yakalar: süresi dolmuş tokenler, kaymış bağımlılıklar, veri değişiklikleri ve yavaş performans kaymaları. Olgun işlem hatları her ikisini de çalıştırır. Hızlı smoke testler her commit'i sınırlar ve daha geniş bir regresyon paketi gece çalıştırılır.

Gece derlemesi ne zaman çalışmalı?

Test ortamınızın boşta olduğu ve bağımlı olduğunuz harici hizmetlerin erişilebilir olduğu bir zaman aralığı seçin. Birçok ekip için bu, yerel saatle gece 1'den sabah 4'e kadardır. API'leriniz üçüncü taraf sanal ortamları çağırıyorsa, bu saatte onların aktif olduğundan emin olun; bazı sağlayıcılar gece boyunca kısıtlama veya duraklatma yapabilir. Binlerce işin aynı anda tetiklendiği paylaşılan CI'da tam olarak saat başında zamanlamaktan kaçının; birkaç dakika geciktirmek (veya Jenkins'in H sözdizimini kullanmak) yükü dağıtır.

Üretim ortamına karşı gece paketi çalıştırabilir miyim?

Üretim ortamına karşı güvenli bir şekilde salt okunur kontroller çalıştırın. Veri yazan her şey için, gece paketini gerçekçi verilerle ayrılmış bir hazırlık (staging) veya ön üretim ortamına yönlendirin veya idempotent (tekrarlanabilir) operasyonlar ve bir temizleme adımı kullanın. Yaygın bir desen, hazırlık ortamına karşı tam bir okuma-yazma regresyon çalıştırması artı canlı sistemin erişilebilir ve doğru yanıt verdiğini doğrulamak için üretim ortamına karşı küçük bir salt okunur smoke çalıştırmasıdır.

Bu, izlemeden (monitoring) nasıl farklıdır?

Çalışma süresi izleme, "API çalışıyor mu?" sorusunu yanıtlar. Bir gece regresyon paketi ise "API doğru çalışıyor mu?" sorusunu yanıtlar. İzleme, bir uç noktayı pingler ve 200 durum kodunu kontrol eder. Bir regresyon çalıştırması tam iş akışlarını uygular, yanıt gövdelerini şemanıza göre doğrular, kimlik doğrulama sınırlarını kontrol eder ve iş kurallarını doğrular. Bunlar tamamlayıcıdır; izleme sürekli ve yüzeyseldir, gece testi periyodik ve derindir.

API testlerini zamanlamak için kod yazmam gerekiyor mu?

Hayır. Apidog'da betik yazmadan senaryoları görsel olarak oluşturur, ardından oluşturulan apidog run komutunu CI/CD panelinden kopyalarsınız. Tek "kod", CI platformunuza ne zaman çalışacağını söyleyen birkaç satırlık YAML veya işlem hattı yapılandırmasıdır ve bunlar yukarıdaki şablonlardır. Komut satırı çalıştırıcılarının genel olarak nasıl karşılaştırıldığını görmek isterseniz, Postman CLI vs Newman ve Newman olmadan CI'da koleksiyon çalıştırma alternatifleri kapsar.

İlk Gece Çalıştırmanızı Kurun

Küçük başlayın. Kritik bir iş akışı, giriş akışınız veya ödeme yolunuzu seçin ve bunu gerçek iddialarla tek bir Apidog senaryosu olarak oluşturun. Yeşil olana kadar CLI ile yerel olarak çalıştırın. Oluşturulan komutu yukarıdaki şablonlardan birini kullanarak zamanlanmış bir işe ekleyin. Başarısızlığı ekip sohbetinize bağlayın. Bu, bir öğleden sonra çalışan bir gece derlemesidir.

Oradan itibaren paketi büyütün. Sonraki en önemli yolculuklar için senaryolar ekleyin, genel olarak şema doğrulamasını açın ve yoğun uç noktalarınıza performans bütçeleri belirleyin. Bir hafta içinde, commit başına testlerinizin asla görmesi için tasarlanmadığı hataları yakalayan bir regresyon ağına sahip olacak ve bunları sabah 9'da bir müşteriden değil, sabah 2'de bir sohbet mesajından duyacaksınız.

Düğme

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin

Ücretsiz Kaydolİndir