
Izrada CI/CD pipeline-a pomoću GitHub Actions: primer za Node.js
GitHub Actions automatski pokreće testiranje, izgradnju i isporuku pri svakom slanju koda. Vodič gradi kompletan Node.js pipeline sa Docker image-om, bezbednosnim skeniranjem i isporukom na Kubernetes.
Elif Demir
Arhitekta cloud rešenja
Ručni procesi testiranja i isporuke i spori su i skloni greškama. GitHub Actions je besplatna CI/CD platforma koja automatski pokreće korake testiranja, izgradnje i isporuke kada se kod pošalje. Ovaj vodič gradi kompletan pipeline za Node.js aplikaciju, uključujući testiranje, izgradnju Docker image-a, bezbednosno skeniranje i isporuku na Kubernetes.
Osnove GitHub Actions
GitHub Actions se definišu YAML fajlovima u direktorijumu .github/workflows/ vašeg repozitorijuma. Svaki workflow sadrži jedan ili više jobova, a svaki job se sastoji od koraka. Workflow se mogu pokrenuti događajima push, pull request, po rasporedu ili ručnim pokretanjem.
| Pojam | Opis | Primer |
|---|---|---|
| Workflow | Definicija automatizovanog procesa | fajl ci.yml |
| Job | Radna jedinica koja se izvršava paralelno ili redom | test, build, deploy |
| Korak | Jedna komanda ili akcija unutar joba | npm test, docker build |
| Akcija | Paket koraka koji se može ponovo koristiti | actions/checkout@v4 |
Pipeline za testiranje i lint
Kao prvi korak napravimo workflow koji automatski pokreće testove i lint pri svakom push-u i pull request-u.
name: CI Pipeline
on:
push:
branches: [main, develop]
pull_request:
branches: [main]
jobs:
test:
runs-on: ubuntu-latest
strategy:
matrix:
node-version: [18, 20, 22]
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node-version }}
cache: 'npm'
- run: npm ci
- run: npm run lint
- run: npm test -- --coverage
- uses: actions/upload-artifact@v4
with:
name: coverage-${{ matrix.node-version }}
path: coverage/
Pipeline za izgradnju i isporuku Dockera
Nakon što testovi prođu, evo kompletnog pipeline-a koji gradi Docker image, šalje ga u registry i isporučuje na Kubernetes:
name: Build & Deploy
on:
push:
branches: [main]
env:
REGISTRY: ghcr.io
IMAGE_NAME: ${{ github.repository }}
jobs:
build:
runs-on: ubuntu-latest
permissions:
contents: read
packages: write
steps:
- uses: actions/checkout@v4
- uses: docker/login-action@v3
with:
registry: ${{ env.REGISTRY }}
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
- uses: docker/build-push-action@v5
with:
context: .
push: true
tags: |
${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ github.sha }}
${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest
cache-from: type=gha
cache-to: type=gha,mode=max
deploy:
needs: build
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: azure/k8s-set-context@v4
with:
kubeconfig: ${{ secrets.KUBE_CONFIG }}
- run: |
kubectl set image deployment/web-app \
web-app=${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ github.sha }} \
-n production
💡 Savet: cache-from: type=gha koristi GitHub Actions keš da bi značajno skratio vreme Docker izgradnje. Nakon prve izgradnje, nepromenjeni slojevi se isporučuju iz keša.
Bezbednosni koraci pipeline-a
-
Čuvajte tajne u podešavanjima repozitorijuma Čuvajte API ključeve, kubeconfig i kredencijale za registry u GitHub Secrets. Nikada ih ne upisujte kao običan tekst u workflow fajlove.
-
Fiksirajte verzije akcija Koristite
actions/[email protected]ili commit SHA umestoactions/checkout@v4. Ovo štiti od napada na lanac snabdevanja. -
Dodajte bezbednosno skeniranje image-a Skenirajte image-e alatom Trivy nakon izgradnje. Zaustavite pipeline ako se pronađu kritične ranjivosti:
trivy image --exit-code 1 --severity CRITICAL -
Primenite princip najmanjih privilegija Koristite
permissionsblok da svakom jobu dodelite samo dozvole koje su mu potrebne. Podrazumevano su sve dozvole otvorene.
Za optimizaciju Docker image-a pogledajte naš vodič za Multi-Stage Build. Za bezbednost kontejnera pogledajte naš vodič za bezbednost kontejnera. Za GitOps pristup istražite naš ArgoCD vodič. Korisni dodatni resursi su GitHub Actions dokumentacija i Actions Marketplace .
Često postavljana pitanja
Da li je GitHub Actions besplatan?
Potpuno je besplatan za javne repozitorijume. Privatni repozitorijumi na Free planu dobijaju 2.000 besplatnih minuta mesečno. Dodatni minuti se naplaćuju. Troškove možete svesti na nulu korišćenjem self-hosted runnera.
Koja je razlika između GitHub Actions i Jenkinsa?
GitHub Actions radi u oblaku i nativno je integrisan sa GitHubom, bez potrebe za upravljanjem serverom. Jenkins se hostuje samostalno, fleksibilniji je, ali zahteva podešavanje i održavanje. GitHub Actions odgovara malim i srednjim timovima, dok Jenkins može biti bolji za složene enterprise pipeline-ove.
Čemu služi matrix strategija?
Matrix strategija izvršava isti job paralelno sa različitim parametrima. Na primer, možete istovremeno testirati na Node.js 18, 20 i 22. To vam pomaže da rano uočite probleme sa kompatibilnošću.
Kada treba da koristim self-hosted runner?
Koristite self-hosted runnere kada su vam potrebni poseban hardver (GPU, ARM), mrežna ograničenja (pristup privatnoj mreži) ili optimizacija troškova. Radi bezbednosti pokrećite runnere u izolovanom okruženju i redovno ih ažurirajte.
Zaključak
Automatizacijom procesa testiranja, izgradnje i isporuke pomoću GitHub Actions možete povećati brzinu razvoja i smanjiti broj grešaka. Koristite matrix strategiju za testiranje više verzija, Docker keš za skraćenje vremena izgradnje, bezbednosno skeniranje za rano otkrivanje ranjivosti i pravilno upravljanje tajnama da kredencijali ostanu bezbedni.
Moćna infrastruktura za vaš CI/CD pipeline
Brzo i bezbedno isporučite svoje aplikacije uz Hosted Cloud servere.
Pogledajte pakete cloud servera →Elif Demir
Arhitekta cloud rešenja
Specijalizovana za projekte migracije preduzeća u cloud i dizajn hibridne infrastrukture, sa 8 godina iskustva u AWS, Azure i privatnim cloud okruženjima.
Komentari uskoro