
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.
Can Kaya
Specijalista za bezbednost
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.
# 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:
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.
{
"$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.
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š.
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 →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