GitHub Actions ile CI/CD: Kapsamlı Rehber
GitHub Actions ile sürekli entegrasyon ve dağıtımı kurun: başlangıç seviyesi bir test iş akışı, ortamlarla korumalı bir dağıtım, önbelleğe alma, sırlar ve izinler, kopyalamaya hazır YAML ile.

Bir ekip arkadaşı Cuma öğleden sonra bir pull request birleştirdi. Testler kendi dizüstü bilgisayarında geçmişti, ancak lockfile güncel değildi ve main artık temiz bir şekilde kurulmuyordu. Pazartesi dağıtımı başarısız olana kadar kimse fark etmedi. On satırlık bir iş akışı bunu iki dakikada yakalayabilirdi. Bu yazı, yeni bir depo için kurduğum başlangıç işlem hattıdır: her push işleminde testler, testler geçtikten ve bir insan onayladıktan sonra çalışan bir dağıtım ve bunu hızlı ve güvenli tutan birkaç ayar.
Zaten olgun bir işlem hattı çalıştırıyorsanız ve daha derin materyaller istiyorsanız, Güvenilir CI/CD İşlem Hattı Otomasyonu ve monorepo'ya özel Monorepolar için CI/CD İşlem Hattı Desenleri yazılarını okuyun. Burada sıfırdan başlıyoruz.
Hızlı çıkarımlar
- Bir iş akışı,
.github/workflows/içinde tetikleyiciler, işler ve adımlar içeren bir YAML dosyasıdır. Testlerinizi çalıştıran bir tanesiyle başlayın. - CI'da
npm ci(veya dilinizin lockfile kurulumunu) kullanın, asla düz bir kurulum yapmayın, böylece derleme taahhüt ettiğinizle eşleşir. - Dağıtımı, test işine
needsbağımlılığı olan ve korumalı bir ortamı hedefleyen ayrı bir iş haline getirin. - Bağımlılıkları kurulum eyleminin yerleşik önbellek seçeneğiyle önbelleğe alın; bu tek bir satırdır.
- İş akışına ihtiyaç duyduğu en az izni verin ve üçüncü taraf eylemleri tam bir commit SHA'sına sabitleyin.
Temel bir GitHub Actions iş akışı nasıl görünür?
Bu, main dalına yapılan her push işleminde ve her pull request'te, iki Node sürümünde bir Node projesi için lint ve testleri çalıştırır:
name: ci
on:
push:
branches: [main]
pull_request:
permissions:
contents: read
concurrency:
group: ci-${{ github.ref }}
cancel-in-progress: true
jobs:
test:
runs-on: ubuntu-latest
strategy:
matrix:
node: [20, 22]
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node }}
cache: npm
- run: npm ci
- run: npm run lint
- run: npm test
Bilmeye değer tetikleyiciler push, pull_request, schedule (cron sözdizimi, gece işleri için kullanışlıdır) ve manuel bir "İş akışını çalıştır" düğmesi ekleyen workflow_dispatch'tir. concurrency bloğu, aynı dala tekrar push yaptığınızda eski bir çalıştırmayı iptal eder, böylece kimsenin okumayacağı sonuçlar için ödeme yapmazsınız. matrix, aynı adımları her Node sürümü için bir kez, paralel olarak çalıştırır.
Testler geçtikten sonra nasıl dağıtım yaparım?
Dağıtımı kendi işine koyun, test işine bağımlı hale getirin ve bir GitHub ortamına bağlayın. Depo ayarlarında bu ortam için bir gözden geçiren isteyebilirsiniz, böylece üretim değişikliklerinden önce bir insan onaylar. Bu işi aynı dosyadaki jobs: altına ekleyin:
deploy:
needs: test
if: github.ref == 'refs/heads/main' && github.event_name == 'push'
runs-on: ubuntu-latest
environment: production
permissions:
contents: read
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- run: npm ci
- run: npm run build
- run: ./scripts/deploy.sh
env:
DEPLOY_TOKEN: ${{ secrets.DEPLOY_TOKEN }}
Dağıtım betiğini depoda tutun, böylece işlem hattının kendisi sorun olduğunda manuel olarak çalıştırabilirsiniz. Vercel'e, bir container kayıt defterine veya SSH üzerinden bir sunucuya push yapması yapıyı değiştirmez. Sırlar YAML'den uzak durur: onları ortamın ayarları altında saklayın ve secrets.NAME olarak okuyun. Çatallardan tetiklenen iş akışlarına maruz kalmazlar, ki bu istediğiniz davranıştır.
İş akışlarını nasıl hızlandırırım?
Çoğu yavaş işlem hattı üç nedenden birinden dolayı yavaştır. Birincisi, bağımlılıklar her seferinde indirilir: yukarıdaki cache: npm satırı, paket yöneticisi önbelleğini lockfile'ınız tarafından anahtarlanmış olarak saklar (diğer ekosistemler için cache: pip veya cache: gradle, özel yollar için actions/cache kullanın). İkincisi, her şey sırayla çalışır: lint ve testler gibi bağımsız işleri ayrı işlere ayırın, böylece yan yana çalışırlar. Üçüncüsü, Docker derlemeleri soğuk başlar; yukarıda bağlantısı verilen güvenilir işlem hatları yazısında açıklandığı gibi, docker/build-push-action içindeki BuildKit önbellek dışa aktarımları bunu düzeltir. Her değişiklikten önce ve sonra push'tan yeşile kadar ölçüm yapın, böylece neyin gerçekten yardımcı olduğunu bilirsiniz.
İşlem hattını nasıl güvende tutarım?
- En az ayrıcalık. En üste
permissions: contents: readayarlayın ve yalnızca gerektiğinde her iş için daha fazla izin verin. Varsayılan token çoğu işin gerektirdiğinden daha geniştir. - Eylemleri sabitleyin. Etiketler hareket eder. Üçüncü taraf eylemleri tam commit SHA'sı ile bir yorumla referans alın, örneğin
uses: owner/action@<40-char-sha> # v2.3.1ve Dependabot'un güncellemeler önermesine izin verin. - İçe aktardıklarınızı gözden geçirin. Bir eylem, deponuzun token'ı ile çalışır. Resmi veya yaygın olarak kullanılan eylemleri tercih edin ve küçük olanların kaynak kodunu okuyun.
pull_request_targetile dikkatli olun. Temel dalın bağlamında sırlarla çalışır; asla güvenilmeyen pull request kodunu içinde kontrol etmeyin ve çalıştırmayın.
İş akışını depolar arasında nasıl yeniden kullanabilirim?
Üç depo aynı adımları çalıştırdığında, kopyala-yapıştır bakım borcuna dönüşür. Paylaşılan işi yeniden kullanılabilir bir iş akışına taşıyın ve çağırın:
# .github/workflows/node-ci.yml in a shared repo
on:
workflow_call:
inputs:
node-version:
type: string
default: "22"
# in each project
jobs:
ci:
uses: your-org/shared-workflows/.github/workflows/node-ci.yml@main
with:
node-version: "22"
Paylaşılan iş akışı stabilize olduğunda @main'i bir etikete veya SHA'ya sabitleyin, böylece oradaki bir değişiklik tüm projeleri aynı anda bozamaz.
Bir şeyler bozulduğunda nasıl anlarım?
README dosyanıza durum rozetini ekleyin, böylece main dalının durumu görünür olur. Bildirimler için, if: failure() içeren son bir adım Slack'e gönderebilir veya bir e-posta gönderebilir. Bir çalıştırma başarısız olduğunda ve günlük yeterli olmadığında, Actions UI'dan hata ayıklama günlüğü etkinleştirilmiş olarak yeniden çalıştırın ve YAML'ye dokunmadan önce temiz bir checkout'ta npm ci && npm test ile yerel olarak yeniden üretin.
Sırada ne yapmalıyım?
Bugün ilk örnekle .github/workflows/ci.yml dosyasını oluşturun ve çalıştığını görmek için bir pull request açın. Stabil hale geldiğinde, main dalında dal korumasını etkinleştirin, böylece test işi zorunlu hale gelir, ki bu tam olarak Ekipler için Git İş Akışı Stratejileri yazısında açıklanan iş akışıdır. Korumalı dağıtım işini ancak bir hafta güvenilir test çalıştırmalarından sonra ekleyin. Uygulamayı konteynerize ederseniz, bir sonraki adım Docker ve Kubernetes dağıtım rehberi olacaktır.
Uğur Kaval
Modern teknolojilerle yenilikçi çözümler geliştirmede uzmanlaşmış AI/ML Mühendisi & Full Stack Geliştirici. Otomasyon, makine öğrenmesi ve web geliştirme tutkunu.


