Next.js pull request'i: üç inceleme, testleriniz ve CI'dan yayın kontrolü
Son güncelleme
Parallel Review ile doğruluk, güvenlik ve test kapsamı açısından incelenen, kendi test paketinizle test edilen ve merge öncesinde CI'dan yeniden kontrol edilen bir Next.js değişikliği.
Tarayıcıdan girdi kabul eden bir route handler, birden fazla kişinin gözünden geçmeyi hak eder. Bu şablon bir Next.js değişikliği üzerinde odaklı üç inceleme çalıştırır, kendi test paketinizi yazılan koda karşı çalıştırır ve CI'ınızın merge öncesinde aynı soruyu yeniden sormasını sağlar.
Hangi ajanlar çalışır
| Adım | Ajan |
|---|---|
| Correctness review | Reviewer |
| Security review | Security Auditor |
| Test coverage review | Tester |
| Merge findings | Architect |
Architect üç incelemeyi tek bir listede birleştirir. Ardından kod geçişi değişikliği yazar ve verify adımı (doğrulama), lockfile'ınızın işaret ettiği paket yöneticisiyle package.json test script'inizi çevrimdışı bir sandbox içinde çalıştırır. Vitest ve Jest çıktıları toplamlara ayrıştırılır.
İlgili kalite kapıları
- Bulgular. Bir bulgu incelemesi, üç incelemeyi bağlam olarak alarak gerçek diff'i okur. Açık yüksek (high) veya kritik (critical) bulgular, triyajdan geçirilene kadar pull request'i engeller.
- Bu sürümdeki testler. Başarısız testler engeller. Testleri çalıştıktan sonra değişikliği düzenlemek onu test edilmemiş olarak işaretler.
- Onay. Çalışma alanında onay verebilecek başka biri olduğu sürece oturumu başlatan kişi onay oyunu veremez.
CI'dan yeniden kontrol edin
Konsol pull request'i codeops/run-<id> adlı bir branch üzerinde açar. GitHub Actions'ta, pull request'lerde çalışan iş akışına bir adım ekleyin ve secret olarak saklanan bir çalışma alanı API anahtarı kullanın:
- name: AI CodeOps release check
if: startsWith(github.head_ref, 'codeops/run-')
env:
AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
PR_URL: ${{ github.event.pull_request.html_url }}
run: |
curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
-H "Authorization: Bearer $AICODEOPS_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"pullRequestURL\":\"$PR_URL\",\"blockOnInFlight\":true}" \
| jq -e '.allowed == true'
Uç nokta, değişikliğe izin verilse de verilmese de 200 yanıtı verir; bu yüzden adım allowed alanını okur. blockOnInFlight, pull request'in arkasındaki herhangi bir oturum hâlâ çalışırken reddeder. Konsolu açtığınız adresi kullanın. Tüm alanlar API sayfasındadır.
Sonraki adımlar
Bu kontrol geçip değişiklik merge edildiğinde, canlı ortama giden yolu kapı denetimli staging dağıtımı şablonu ele alır. Hiçbir pull request'in dokunmadığı kod için haftalık kod tabanı incelemesi zamanlayın.
Sık sorulan sorular
Üç inceleme aynı anda mı çalışır?
Hayır. Birbiri ardına çalışırlar ve her biri öncekilerin yazdıklarını okur. Parallel sözcüğü işin nasıl bölündüğünü anlatır.
CI adımı elle yazılmış pull request'leri reddeder mi?
Evet, arkasında oturum olmayan bir pull request No workflow runs found yanıtını alır. Bu yüzden adım yalnızca codeops/run- branch'lerinde çalışır.
İlgili içerikler
- Kötü merge'leri engelleyen yapay zekâ kod incelemesi
- Çok ajanlı incelemeler
- AI CodeOps API'si
- Next.js uygulaması: önce kapı denetimli staging dağıtımı, sonra canlı ortam
- Yapay zekânın yazdığı değişiklikler için pull request açıklaması şablonu
- Yapay zekânın yazdığı bir değişiklik için olay postmortem şablonu
- Tüm şablonlar