CI/CD u monorepo strukturi: integracija Turborepo i GitHub Actions

CI/CD u monorepo strukturi: integracija Turborepo i GitHub Actions

Podesite CI/CD pipeline-ove u monorepou uz Turborepo i GitHub Actions. Pipeline zadataka, udaljeno keširanje, affected filter i poređenje sa polyrepom.

C

Can Kaya

Specijalista za bezbednost

21. mart 2026.12 min čitanja0

Upravljanje većim brojem aplikacija i paketa u jednom repozitorijumu može se pretvoriti u haos bez pravih alata. Turborepo dramatično ubrzava CI/CD procese u monorepo projektima pametnim keširanjem i mehanizmom pipeline-a zadataka. Ovaj vodič vas korak po korak vodi kroz podešavanje Turborepo-a, integraciju sa GitHub Actions, udaljeno keširanje i filtriranje izmenjenih paketa.

Poređenje monorepoa i polyrepoa

Izbor između monorepoa i polyrepoa zavisi od veličine tima, strukture projekta i strategije deploymenta. Tabela ispod sažima ključne razlike.

Karakteristika Monorepo Polyrepo
Deljenje koda Lako (interni paketi) Teško (potreban npm publish)
Složenost CI/CD-a Srednja (uz affected filter) Niska (nezavisni pipeline-ovi)
Upravljanje zavisnostima Centralizovano (jedan lock fajl) Distribuirano (zasebno po repozitorijumu)
Atomarne izmene Moguće jednim PR-om Potrebno više PR-ova
Veličina repozitorijuma Velika (sav kod na jednom mestu) Mala (izolovani repozitorijumi)

💡 Savet: Ako imate 3+ aplikacije i deljene pakete, monorepo struktura pojednostavljuje deljenje koda i kompatibilnost verzija. Alati poput Turborepo-a, Nx-a ili Lerne čine taj proces upravljivim.

Podešavanje Turborepo-a i struktura projekta

Turborepo je visokoperformantan build sistem za monorepo koji je razvio Vercel. Kreiranje novog projekta ili dodavanje u postojeći je jednostavno.

terminal
# Create a new monorepo project
npx create-turbo@latest my-monorepo

# Add Turborepo to an existing project
npm install turbo --save-dev

# Project structure
my-monorepo/
├── apps/
│   ├── web/          # Next.js frontend
│   ├── api/          # Express backend
│   └── admin/        # Admin panel
├── packages/
│   ├── ui/           # Shared UI components
│   ├── config/       # ESLint, TS config
│   └── utils/        # Common utility functions
├── turbo.json
├── package.json
└── pnpm-workspace.yaml

Definišite direktorijume radnog prostora u pnpm-workspace.yaml:

pnpm-workspace.yaml
packages:
  - "apps/*"
  - "packages/*"

Konfiguracija pipeline-a zadataka (turbo.json)

Snaga Turborepo-a potiče iz definicija pipeline-a zadataka u turbo.json. Ovde se definišu zavisnosti, izlazi i ponašanje keša svakog zadatka.

turbo.json
{
  "$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
    }
  }
}

⚠️ Upozorenje: Oznaka ^build znači „prvo pokreni build zadatak zavisnosti“. Time se obezbeđuje da se packages/ui izgradi pre apps/web. Ako je redosled pogrešan, build neće uspeti.

GitHub Actions sa affected filterom

Građenje svih aplikacija pri svakom push-u u monorepou je rasipanje. Uz Turborepo-ov --filter flag možete graditi samo izmenjene pakete i pakete koji zavise od njih.

.github/workflows/ci.yml
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

      # Build only changed packages
      - run: pnpm turbo build --filter=...[HEAD^1]

      # Run tests for changed packages
      - run: pnpm turbo test --filter=...[HEAD^1]

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

Izraz --filter=...[HEAD^1] bira pakete izmenjene od poslednjeg commita i sve pakete koji zavise od njih. U monorepou sa 10 aplikacija, ako su se promenile samo 2, grade se samo te 2.

Ubrzavanje build-ova udaljenim keširanjem

Jedna od najmoćnijih funkcija Turborepo-a je udaljeno keširanje. Kada programer ili CI runner upiše izlaz builda u keš, drugi runner sa istim ulazom može potpuno preskočiti build koristeći taj keš.

.github/workflows/ci.yml (udaljeni keš)
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 is automatically active
      - run: pnpm turbo build test lint

💡 Savet: Udaljeno keširanje smanjuje prosečno vreme CI-ja za 40-65%. Vercel Remote Cache je besplatan, a možete i da postavite sopstveni keš server. Povežite svoj nalog komandama turbo login i turbo link .

Osnove CI/CD pipeline-a pogledajte u našem vodiču za GitHub Actions CI/CD. Za GitOps pristup pogledajte naš ArgoCD vodič. Za strategije deploymenta istražite naš vodič za Blue-Green i Canary deployment. Zvanična Turborepo dokumentacija i GitHub Actions dokumentacija vredni su dodatni izvori.

Najčešća pitanja

Koja je razlika između Turborepo-a i Nx-a?

Turborepo je lakši i jednostavniji za konfiguraciju i usmeren je posebno na JavaScript/TypeScript projekte. Nx nudi sveobuhvatniji ekosistem sa generisanjem koda i sistemom dodataka koji podržava više jezika. Turborepo se preferira za male i srednje projekte, dok Nx odgovara velikim poslovnim projektima.

Može li se svaka aplikacija nezavisno deploy-ovati u monorepou?

Da, pomoću Turborepo-ovog filter mehanizma možete graditi i deploy-ovati svaku aplikaciju nezavisno. Koristite komande poput --filter=web da biste ciljali određenu aplikaciju.

Da li je udaljeno keširanje bezbedno?

Vercel Remote Cache čuva artefakte šifrovane i samo ovlašćeni članovi tima mogu im pristupiti. Za rešenja koja sami hostujete treba koristiti HTTPS i autentifikaciju zasnovanu na tokenima.

Da li se Git performanse pogoršavaju u monorepou?

Git operacije mogu usporiti u velikim monorepoima. Koristite Git sparse-checkout i shallow clone da biste u CI-ju preuzeli samo potrebne direktorijume. Podešavanje fetch-depth: 2 u GitHub Actions ublažava ovaj problem.

Zaključak

Kombinacija Turborepo-a i GitHub Actions čini CI/CD procese u monorepo projektima brzim, efikasnim i upravljivim. Automatizujte redosled zavisnosti pomoću pipeline-a zadataka, preskočite nepotrebne build-ove affected filterima i dramatično skratite vreme CI-ja udaljenim keširanjem.

Brza infrastruktura za monorepo CI/CD

Ubrzajte svoje procese build-a i deploymenta uz Hosted Cloud servere.

Pogledajte cloud server pakete →

Podelite

C

Can Kaya

Specijalista za bezbednost

Stručnjak za bezbednost sa CISSP sertifikatom, autor sadržaja o sajber bezbednosti, DDoS zaštiti i ojačavanju servera.

Komentari uskoro