Monorepo Yapısında CI/CD: Turborepo ve GitHub Actions Entegrasyonu

Birden fazla uygulama ve paketi tek bir repository'de yonetmek, dogru araçlar olmadan kaosa donusebilir. Turborepo, akıllı caching ve task pipeline mekanizmasıyla monorepo projelerinde CI/CD süreçlerini dramatik şekilde hızlandırır. Bu rehberde Turborepo kurulumundan GitHub Actions entegrasyonuna, remote caching'den affected filter'a kadar tüm süreci adım adım inceliyoruz.

Monorepo vs Polyrepo Karşılaştırması

Monorepo ve polyrepo arasındaki seçim, ekip büyüklüğü, proje yapısı ve deployment stratejisine bağlıdır. Aşağıdaki tablo temel farkları özetler.

Turborepo Kurulumu ve Proje Yapısı

Turborepo, Vercel tarafından geliştirilen yüksek performanslı bir monorepo build sistemidir. Yeni bir proje oluşturmak veya mevcut projeye eklemek oldukça kolaydır.

# Yeni monorepo projesi oluşturma
npx create-turbo@latest my-monorepo

# Mevcut projeye Turborepo ekleme
npm install turbo --save-dev

# Proje yapısı
my-monorepo/
├── apps/
│   ├── web/          # Next.js frontend
│   ├── api/          # Express backend
│   └── admin/        # Admin panel
├── packages/
│   ├── ui/           # Paylaşılan UI bileşenleri
│   ├── config/       # ESLint, TS config
│   └── utils/        # Ortak yardımcı fonksiyonlar
├── turbo.json
├── package.json
└── pnpm-workspace.yaml

Workspace tanımı için pnpm-workspace.yaml dosyasında apps ve packages dizinlerini belirtin:

packages:
  - "apps/*"
  - "packages/*"

Task Pipeline Yapılandırması (turbo.json)

Turborepo'nun gücü turbo.json dosyasındaki task pipeline tanımlarından gelir. Her task'ın bağımlılıkları, çıktıları ve cache davranışı burada belirlenir.

{
  "$schema": "https://turbo.build/schema.json",
  "globalDependencies": ["**/.env.*local"],
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
    },
    "test": {
      "dependsOn": ["build"],
      "inputs": ["src/**/*.tsx", "src/**/*.ts", "test/**"]
    },
    "lint": {
      "dependsOn": ["^build"]
    },
    "dev": {
      "cache": false,
      "persistent": true
    }
  }
}

GitHub Actions ile Affected Filter

Monorepo'da her push'ta tüm uygulamaları build etmek gereksizdir. Turborepo'nun --filter flag'i ile yalnızca değişen paketleri ve onlara bağımlı uygulamaları build edebilirsiniz.

name: CI
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 2

      - uses: pnpm/action-setup@v3
        with:
          version: 9

      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: "pnpm"

      - run: pnpm install --frozen-lockfile

      # Yalnızca değişen paketleri build et
      - run: pnpm turbo build --filter=...[HEAD^1]

      # Değişen paketlerin testlerini çalıştır
      - run: pnpm turbo test --filter=...[HEAD^1]

      # Lint kontrolü
      - run: pnpm turbo lint --filter=...[HEAD^1]

--filter=...[HEAD^1] ifadesi son commit'ten bu yana değişen paketleri ve onlara bağımlı tüm paketleri seçer. Bu sayede 10 uygulamalı bir monorepo'da sadece 2 uygulama değiştiyse, yalnızca o 2 uygulama build edilir.

Remote Caching ile Build Hızlandırma

Turborepo'nun en güçlü özelliklerinden biri remote caching'dir. Bir geliştirici veya CI runner build çıktısını cache'e yazar, aynı input'a sahip başka bir runner bu cache'i kullanarak build'i atlar.

jobs:
  build:
    runs-on: ubuntu-latest
    env:
      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
      TURBO_TEAM: ${{ vars.TURBO_TEAM }}
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v3
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: "pnpm"
      - run: pnpm install --frozen-lockfile
      # Remote cache otomatik olarak aktif
      - run: pnpm turbo build test lint

CI/CD pipeline temelleri için GitHub Actions CI/CD rehberimizi, GitOps yaklaşımı için ArgoCD rehberimizi, deployment stratejileri için Blue-Green ve Canary Deployment rehberimizi inceleyin. Turborepo Resmi Dokümantasyonu ve GitHub Actions Dokümantasyonu ek kaynak olarak faydalıdır.

Sıkça Sorulan Sorular

Sonuç

Turborepo ve GitHub Actions kombinasyonu, monorepo projelerinde CI/CD süreçlerini hızlı, verimli ve yönetilebilir kılar. Task pipeline ile bağımlılık sıralamasını otomatikleştirin, affected filter ile gereksiz build'leri atlayın ve remote caching ile CI sürelerini dramatik şekilde kısaltın.