CI/CD Pipeline Builder

Tier: POWERFUL
Category: Engineering
Domain: DevOps / Automation

Özet

Bu skill'i, proje stack sinyallerinden pragmatik CI/CD pipeline'ları oluşturmak için kullanın — tahminden değil. Hızlı baseline oluşturma, tekrarlanabilir kontroller ve ortam-duyarlı deployment aşamalarına odaklanır.

Temel Yetenekler

• Repository dosyalarından dil/runtime/tooling algılama
• CI aşamalarını önerilendirme (lint, test, build, deploy)
• GitHub Actions veya GitLab CI starter pipeline'ları oluşturma
• Algılanan stack'e dayalı caching ve matrix stratejisini dahil etme
• Otomasyon için makine-tarafından okunabilir detection output yayınlama
• Pipeline mantığını project lockfiles ve build komutlarıyla uyumlu tutma

Ne Zaman Kullanılır

• Yeni bir repository için CI bootstrap'i
• Kırılgan kopyalanan pipeline dosyalarını değiştirme
• GitHub Actions ile GitLab CI arasında geçiş yapma
• Pipeline adımlarının gerçek stack'le eşleşip eşleşmediğini denetleme
• Özel sertleştirmeden önce tekrarlanabilir baseline oluşturma

Temel İş Akışları

1. Stack Algıla

python3 scripts/stack_detector.py --repo . --format text
python3 scripts/stack_detector.py --repo . --format json > detected-stack.json

Çevrimdışı analiz payload'ları için stdin veya --input dosyası aracılığıyla giriş destekler.

2. Detection'dan Pipeline Oluştur

python3 scripts/pipeline_generator.py \
  --input detected-stack.json \
  --platform github \
  --output .github/workflows/ci.yml \
  --format text

Veya repo'dan doğrudan end-to-end:

python3 scripts/pipeline_generator.py --repo . --platform gitlab --output .gitlab-ci.yml

3. Merge Öncesinde Doğrula

1. Komutların projede var olduğunu doğrula (test, lint, build).
2. Oluşturulan pipeline'ı mümkün olduğu yerde yerel olarak çalıştır.
3. Gerekli secret'ları/env değişkenlerinin belgelendiğini kontrol et.
4. Deploy işlerini korumalı branches/environments'lar tarafından kapılı tut.

4. Deployment Aşamalarını Güvenli Şekilde Ekle

• CI-only ile başla (lint/test/build).
• Açık ortam bağlamına sahip staging deploy ekle.
• Manual gate/approval ile production deploy ekle.
• Rollout/rollback komutlarını açık ve denetlenebilir tut.

Script Arayüzleri

• python3 scripts/stack_detector.py --help
  • Repository dosyalarından stack sinyallerini algılar
  • stdin/--input dosyasından optional JSON input okur
• python3 scripts/pipeline_generator.py --help
  • Detection payload'undan GitHub/GitLab YAML oluşturur
  • stdout veya --output'a yazar

Referanslar

• references/pipeline-design-notes.md — yaygın tuzaklar, en iyi uygulamalar, detection heuristics, generation stratejisi, platform karar notları, merge öncesi doğrulama checklist'i ve ölçekleme rehberi
• references/github-actions-templates.md
• references/gitlab-ci-templates.md
• references/deployment-gates.md
• README.md