GitHub Actions chuqur: trigger, job, matrix va ifodalar
Qisqacha: Haqiqiy loyiha CI'si bitta job'dan iborat emas. Bo'lim
onworkflow'ni nima uyg'otishini aytadi: push, PR, qo'lda yoki jadval. Filtrpathsbilan esa — faqat kerakli papka o'zgarganda. Job'lar parallel yuradi,needs— ketma-ketlik. Bo'limservices— test uchun Postgres va Redis konteynerlari,matrix— bitta job bir nechta variantda. Ifoda${{ … }}kontekstlardan (github,inputs,needs,matrix) qiymat oladi va qadam ishga tushishidan oldin matnga qo'yiladi. Loyihaning CI'si birinchi yugurishda qizil chiqdi — sabablarini shu darsda ochamiz.
Bu darsda
onbo'liminipaths,workflow_dispatchvaschedulebilan yozasiz.- Job'larni
needsbilan bog'laysiz va workflow umumiy vaqtini hisoblaysiz. - Testlar uchun
servicesbilan Postgres, Redis, S3 va pochta ko'tarasiz. matrixbilan bitta job'ni x64 va arm64 runner'da yurgizasiz.- Kontekst, ifoda,
outputsvaifqanday ishlashini haqiqiy log bilan tushuntirasiz.
Oldin bilishingiz kerak: CI/CD tushunchasi va pipeline bosqichlari, GitHub Actions: birinchi CI workflow, Git va monorepo, Docker Compose.
1. Nega bu kerak?
Birinchi CI workflow darsida bitta job, bitta runner va to'rtta qadam bor edi. Portfolio uchun shu yetardi. vazifalar monorepo'si esa boshqacha:
- api testlari uchun Postgres, Redis, S3 va pochta serveri kerak;
- web va api — ikki alohida loyiha, ikki xil
npm run check; - server ARM64 protsessorli — kod ikkala arxitekturada tekshirilsin;
- hujjat o'zgargan PR uchun 2 daqiqalik testlarni yurgizish — behuda.
31-qismda yozilgan CI fayli bularning bir qismini bilardi. Lekin u hech qachon ishga tushmagan. Bu darsda loyihaning to'liq ci.yml ini qism-qism o'qiymiz va uning GitHub'dagi birinchi uch yugurishini ko'ramiz. Ikkitasi qizil bo'ldi — va har biri haqiqiy xatoni ochdi.
Hayotiy o'xshatish: oshxonadagi buyurtma. Salat va sho'rva parallel tayyorlanadi, osh esa guruch damlangandan keyin. Har taomning o'z oshpazi bor, lekin hammasi bitta stol uchun. jobs — oshpazlar, needs — "bundan keyin" degan tartib.
2. on: workflow'ni nima uyg'otadi
2.1 Loyihaning trigger'lari
Trigger (ishga tushiruvchi hodisa) — workflow'ni boshlaydigan voqea. Loyihaning ci.yml ida uchta trigger bor. Fayllardagi uzun ro'yxatlar telefon uchun qatorlarga bo'lindi, mazmuni aynan; izohlar olib tashlandi:
on:
push:
branches: [main]
paths:
- "vazifalar-api/**"
- "vazifalar/**"
- "sql/**"
- ".github/workflows/ci.yml"
- ".github/actions/**"
pull_request:
paths:
- "vazifalar-api/**"
- "vazifalar/**"
- "sql/**"
- ".github/workflows/ci.yml"
- ".github/actions/**"
workflow_dispatch:push— faqatmainga, va faqat ro'yxatdagi papkalardan biri o'zgarganda;pull_request— har PR'da, xuddi shu papkalar bilan;workflow_dispatch— Actions sahifasidagi tugma yokigh workflow runbilan qo'lda.
E'tibor bering: .github/workflows/ci.yml ning o'zi ham ro'yxatda. CI faylini o'zgartirsangiz, yangi variant darhol sinovdan o'tadi.
2.2 paths: hujjat PR'i daqiqa yemasin
paths filtri — workflow faqat shu yo'llardagi fayl o'zgarganda ishga tushadi. Monorepo'da bu juda muhim. Faqat README.md ni tuzatgan PR uchun 2 daqiqalik api testlari kerak emas.
GitHub naqshlarni o'z qoidasi bilan solishtiradi. Uning eng ko'p ishlatiladigan qismini o'zimiz modellaymiz: papka/** — shu papka ichidagi istalgan fayl, qolgani — aniq nom.
function mosmi(fayl, naqsh) {
if (naqsh.endsWith("/**")) {
return fayl.startsWith(naqsh.slice(0, -2));
}
return fayl === naqsh;
}
function ishgaTushadimi(fayllar, naqshlar) {
return fayllar.some((f) => naqshlar.some((n) => mosmi(f, n)));
}
const CI = [
"vazifalar-api/**", "vazifalar/**", "sql/**",
".github/workflows/ci.yml", ".github/actions/**",
];
console.log(ishgaTushadimi(["vazifalar-api/src/a.ts"], CI)); // true
console.log(ishgaTushadimi(["sinov/README.md"], CI)); // false
console.log(ishgaTushadimi(["README.md", "sql/110.sql"], CI)); // true
console.log(ishgaTushadimi(["vazifalar-apiX/a.ts"], CI)); // falseUchinchi holat muhim: PR'da bitta fayl ham mos kelsa, workflow ishga tushadi. To'rtinchisi — tuzoqni tekshiradi: vazifalar-api/** dan /** olinsa, vazifalar-api/ qoladi. Oxiridagi / tufayli vazifalar-apiX mos kelmaydi. Haqiqiy GitHub naqshlarida *, ? va inkor uchun ! ham bor (GitHub Docs, workflow syntax, tekshirildi, 2026-11).
Diqqat:
pathsfiltri va majburiy tekshiruv birga ishlaganda tuzoq bor. Workflowpathstufayli umuman ishga tushmasa, majburiy tekshiruv natijasiz qoladi va PR "Pending" (kutilmoqda) holatida qotib qoladi — merge bloklanadi (GitHub Docs, tekshirildi, 2026-11; kursda sinalmagan). Shuning uchun ruleset'dapathsli workflow nomini majburiy qilishdan oldin buni o'z repo'ngizda sinab ko'ring.
2.3 Qo'lda va jadval bilan
Loyihada ikkinchi, o'quv workflow'i ham bor — ifodalar.yml. U faqat qo'lda va haftalik jadval bilan yuradi:
on:
workflow_dispatch:
inputs:
muhit:
description: Qaysi muhit
type: choice
options: [sinov, production]
default: sinov
batafsil:
type: boolean
default: false
schedule:
- cron: "17 3 * * 1"inputs — qo'lda ishga tushirishda so'raladigan qiymatlar. choice — ro'yxatdan tanlash, boolean — belgilash katakchasi. Buyruq satridan: gh workflow run ifodalar.yml -f muhit=production -f batafsil=true.
schedule — cron ifodasi. Ikki farqi bor: vaqt sukut bo'yicha UTC da (03:17 UTC = Toshkentda 08:17), va jadval faqat sukut tarmog'idagi fayldan o'qiladi. Daqiqa ataylab :17 — soat boshida GitHub yuklamasi eng katta va jadval kechikishi mumkin. Kurs tajribasida jadval bo'yicha yugurish kutilmadi — bu qism sinalmagan.
GitHub Docs'ga ko'ra (2026-11 holatiga) cron qatori ostiga ixtiyoriy timezone kaliti yozish mumkin, masalan timezone: "Asia/Tashkent". Kanon fayli uni ishlatmaydi va biz uni sinamadik. Shuning uchun darsda UTC hisobini o'zingiz qilasiz: Toshkent vaqtidan 5 soat ayiring.
3. Job'lar va needs
3.1 Loyihaning to'rt job'i
ci.yml da to'rtta job bor. Ular sukut bo'yicha parallel yuradi — har biri o'z toza runner'ida:
flowchart LR
P["push yoki PR"] --> A["api: tip, lint, test, build"]
P --> W["web: check, build"]
P --> X["tip: x64"]
P --> Y["tip: arm64"]
A --> R["artefakt"]
W --> RDiagrammaga qarang: artefakt job'i ikkita strelka kutadi. U needs: [api, web] bilan yozilgan — ikkalasi yashil tugamaguncha boshlanmaydi. Biri qizil bo'lsa, artefakt umuman yurmaydi.
jobs:
artefakt:
needs: [api, web]
runs-on: ubuntu-24.04
timeout-minutes: 5needs — job'lar orasidagi tartib: "mendan oldin shular tugasin". Undan tashqari needs orqali oldingi job'ning natijasi va outputs qiymatlari ham keladi — buni «Ifodalar va kontekstlar» bo'limida ko'ramiz. Artefakt yuklash va olish — Actions tezligi darsida.
3.2 Har job uchun ikki himoya
Har job'da ikki qator takrorlanadi:
timeout-minutes— job shuncha daqiqadan oshsa, to'xtatiladi. api uchun 25, web uchun 15. Yozilmasa, sukut — 360 daqiqa (GitHub Docs, tekshirildi, 2026-11). Osilib qolgan test olti soat runner yeydi;defaults.run.working-directory—runqadamlari qaysi papkada bajarilsin. Monorepo'da har job o'z papkasida ishlaydi va har qadamgacdyozish shart emas.
Fayl boshida yana ikki umumiy sozlama bor: permissions: contents: read — avtomatik token faqat o'qiy oladi (Actions xavfsizligi), va concurrency — bir tarmoqqa ketma-ket push bo'lsa, eski yugurish bekor qilinadi (Actions tezligi).
Tekshirib ko'ring:
artefaktjob'iganeeds: [api, web, arxitektura]yozilsa, workflow umumiy vaqti o'zgaradimi?
Javob
Deyarli yo'q. arxitektura (tip tekshiruvi) 27–37 soniyada tugaydi, api esa 2 daqiqa yuradi. artefakt baribir eng sekin job'ni kutadi. Lekin bitta farq bor: endi tip tekshiruvi arm64 runner'da yiqilsa, artefakt ham yurmaydi. needs — faqat vaqt emas, "nimaga tayanaman" degan shart ham.
4. services: test uchun haqiqiy bazalar
4.1 Servis konteynerlari
api testlari haqiqiy Postgres'ga yozadi, Redis'dan o'qiydi, S3'ga fayl yuklaydi va pochta yuboradi. services — job davomida yon tomonda ishlaydigan Docker konteynerlari. Job tugashi bilan ular o'chiriladi. Docker Compose dagi xizmatlarga o'xshaydi, faqat bitta job umriga.
api job'ining boshi (S3 va pochta servislari tushirib qoldirildi; options qatorlari telefon uchun bo'lindi — YAML'ning >- belgisi qatorlarni bitta bo'shliq bilan qayta yopishtiradi, natija aynan):
jobs:
api:
name: api (tip, lint, test, build)
runs-on: ubuntu-24.04
timeout-minutes: 25
defaults:
run:
working-directory: vazifalar-api
services:
postgres:
image: pgvector/pgvector:0.8.7-pg18-trixie
env:
POSTGRES_HOST_AUTH_METHOD: trust
ports: ["5432:5432"]
options: >-
--health-cmd "pg_isready -U postgres"
--health-interval 5s --health-timeout 5s
--health-retries 20
redis:
image: redis:8.8.4
ports: ["6379:6379"]
options: >-
--health-cmd "redis-cli ping" --health-interval 5s
--health-timeout 5s --health-retries 20Uchta narsaga qarang:
- Image versiyasi aniq —
redis:8.8.4,redis:8emas. Ertaga yangi Redis chiqsa, CI o'z-o'zidan o'zgarmaydi. options—docker createbayroqlari. Bu yerda healthcheck: GitHub servis "sog'lom" bo'lguncha qadamlarni boshlamaydi. Aks holda birinchi test Postgres hali tayyor bo'lmagan paytda ulanishga urinadi.POSTGRES_HOST_AUTH_METHOD: trust— parolsiz kirish. Bu faqat shu job ichidagi vaqtinchalik konteyner uchun. Production'da — hech qachon.
Job runner'ning o'zida ishlaydi, servislar esa konteynerda. Shuning uchun ularga 127.0.0.1 va ports dagi port orqali ulanamiz: TEST_DATABASE_URL — postgres://postgres@127.0.0.1:5432/vazifalar_test. Qolgan ikki servis — rustfs/rustfs:1.0.4 (S3 bilan mos fayl ombori) va axllent/mailpit:v1.33.0 (soxta pochta serveri). Ularning kalitlari ham faqat sinov qiymatlari — sir emas.
4.2 Namuna baza sql/ dan
Test bazalari Prisma migratsiyalari bilan noldan yaratiladi. Lekin bitta test — ombor-modul.test — namuna bazaga tayanadi: unda Aziz va uning demo paroli bor. Namuna sql/ papkasidagi fayllardan quriladi. Shuning uchun job'da alohida qadam bor: u vazifalar bazasini yaratadi va ../sql/*.sql fayllarini tartib bilan psql orqali yuklaydi. Bu qadam qayerdan kelib chiqqani — pastda, «Birinchi uch yugurish» bo'limida.
5. matrix: bitta job, bir necha variant
Server ARM64 protsessorli. Kod x64 noutbukda yozilib, x64 runner'da tekshirilsa, arm64'ga xos muammo (masalan, faqat x64 uchun chiqarilgan paket) faqat serverda chiqadi. matrix — bitta job ta'rifidan bir nechta nusxa yasash:
jobs:
arxitektura:
name: tip (${{ matrix.runner }})
strategy:
fail-fast: false
matrix:
runner: [ubuntu-24.04, ubuntu-24.04-arm]
runs-on: ${{ matrix.runner }}
timeout-minutes: 10GitHub bu yerdan ikkita job yasaydi: tip (ubuntu-24.04) va tip (ubuntu-24.04-arm). ${{ matrix.runner }} har nusxada o'z qiymatini oladi.
ubuntu-24.04-arm— GitHub'ning arm64 runner'i. Ochiq repo'da u bepul — narxlarni CI narxi va byudjetsiz CI darsida ko'ramiz.fail-fast: false— bir nusxa yiqilsa ham, ikkinchisi oxirigacha yursin. Sukut (true) da qolganlari bekor qilinadi. Arxitektura tekshiruvida ikkala natijani ko'rish foydali: "faqat arm64'da yiqildi" — muhim belgi.
Bu job'da faqat tip tekshiruvi bor — testlar va servislar emas. Sabab — narx va vaqt. Kanon yugurishida x64 nusxasi 27 soniya, arm64 — 37 soniya oldi. To'liq testlarni ikki arxitekturada yurgizish vaqtni ikki baravar oshirardi.
Tekshirib ko'ring: Matrix'ga uchinchi o'lcham qo'shildi:
node: [22, 24]. Endi nechta job yuradi?
Javob
To'rtta: har runner × har Node versiyasi (2 × 2). Matrix — barcha kombinatsiyalar. Uch o'lcham 3 tadan qiymat bilan bo'lsa — 27 job. Shuning uchun matrix'ni o'ylab kengaytiring: har yangi o'lcham ko'paytiradi, qo'shmaydi.
6. Ifodalar va kontekstlar
6.1 ${{ … }} qachon hisoblanadi
Ifoda (expression) — ${{ … }} ichidagi kichik til. Kontekst — ifoda o'qiydigan ma'lumot obyekti: github (hodisa, tarmoq, kim), runner (OS, arxitektura), inputs, env, secrets, matrix, needs, steps.
Eng muhim qoida: ifoda runner'da qadam ishga tushishidan oldin hisoblanadi va natija matnga to'g'ridan-to'g'ri qo'yiladi. Shell ifodani ko'rmaydi — u faqat tayyor matnni oladi. Buni ifodalar.yml ning haqiqiy logida ko'ramiz. Fayldagi qadam:
echo "${{ matrix.papka }} — $(node -p "require('./${{ matrix.papka }}/package.json').name") (api versiyasi ${{ needs.tayyorla.outputs.versiya }})"GitHub log'ida esa shu qadam boshqacha ko'rinadi:
Run echo "vazifalar — $(node -p "require('./vazifalar/package.json').name") (api versiyasi 4.1.1)"${{ … }} lar allaqachon vazifalar va 4.1.1 ga almashgan. $( … ) esa joyida — uni keyin shell bajaradi. Bu farq Actions xavfsizligi darsida hal qiluvchi bo'ladi: tashqaridan kelgan matn ${{ }} orqali run ga tushsa, u shell buyrug'iga aylanadi.
6.2 Kontekstlarni chiqaramiz
ifodalar.yml qo'lda ishga tushirildi: muhit=production, batafsil=true. Birinchi job kontekstlarni env orqali chiqardi (kim qiymati login ga almashtirildi):
hodisa=workflow_dispatch kim=login ref=refs/heads/main muhit=production os=Linux arch=X64
lock hash (kesh kaliti uchun): 9936824de8869dc4…hashFiles('vazifalar-api/package-lock.json') — lock faylining xeshi. U Actions tezligi darsida kesh kaliti bo'lib chiqadi.
6.3 outputs: job'dan job'ga qiymat
Job'lar alohida runner'larda yuradi va o'zgaruvchilarini bo'lisha olmaydi. Qiymat uzatish yo'li — outputs. Qadam qiymatni maxsus $GITHUB_OUTPUT fayliga yozadi:
echo 'papkalar=["vazifalar-api","vazifalar"]' >> "$GITHUB_OUTPUT"Shu qadamning birinchi qatori ham xuddi shunday versiya=4.1.1 ni yozadi (qiymat package.json dan). Job ularni outputs ga chiqaradi:
jobs:
tayyorla:
runs-on: ubuntu-24.04
timeout-minutes: 5
outputs:
versiya: ${{ steps.v.outputs.versiya }}
papkalar: ${{ steps.v.outputs.papkalar }}steps.v — id: v li qadam. Keyingi job needs.tayyorla.outputs.versiya deb o'qiydi.
6.4 Dinamik matrix: fromJSON
Output — doim satr. papkalar ham JSON ko'rinishidagi satr. Uni matrix'ga massiv sifatida berish uchun fromJSON kerak:
jobs:
har-papka:
needs: tayyorla
strategy:
matrix:
papka: ${{ fromJSON(needs.tayyorla.outputs.papkalar) }}Natija — ikki job, har papka uchun bittadan:
vazifalar-api — vazifalar-api (api versiyasi 4.1.1)
vazifalar — vazifalar (api versiyasi 4.1.1)Bu usul katta monorepo'larda ishlatiladi: birinchi job qaysi papkalar o'zgarganini aniqlaydi, matrix esa faqat ular uchun yuradi.
6.5 if: shartli job
jobs:
faqat-production:
needs: tayyorla
if: >-
inputs.muhit == 'production'
&& startsWith(github.ref, 'refs/heads/main')startsWith — ifoda tilining funksiyasi (yana contains, endsWith, format, join bor). Shart ikkalasi ham bajarilganda job yuradi. Bizda production tanlangan va tarmoq main — logda: production yo'li (versiya 4.1.1).
Oxirgi job — hisobot. U needs: [tayyorla, har-papka, faqat-production] va if: always() bilan yozilgan. always() — oldingi job'lar qizil yoki o'tkazib yuborilgan bo'lsa ham yur. Hisobot qadami toJSON(needs.*.result) ni chiqaradi:
needs natijalari: [
"success",
"success",
"success"
]
batafsil rejimneeds.*.result — har kutilgan job natijasi: success, failure, cancelled yoki skipped. muhit=sinov bilan ishga tushirilsa, faqat-production skipped bo'lardi. Bunday hisobot job'i bildirishnoma yuborish yoki tozalash uchun qulay.
Tekshirib ko'ring:
if: always()o'rnigaif: success()yozilsa vafaqat-productiono'tkazib yuborilsa (muhit=sinov), hisobot job'i yuradimi?
Javob
Yo'q. success() — "kutilgan hamma job muvaffaqiyatli". O'tkazib yuborilgan job muvaffaqiyat hisoblanmaydi, shuning uchun hisobot ham o'tkazib yuboriladi. if umuman yozilmasa ham shunday — sukut success(). Natijadan qat'i nazar yurishi kerak bo'lgan job'ga always() kerak.
7. Birinchi uch yugurish
7.1 Biz shunday xato qildik: CI fayli hech yurmagan edi
Sinov repo'siga 33-qism oxiridagi kod va yangi ci.yml push qilindi. 31-qismdan beri loyihada CI fayli bor edi, lekin u GitHub'da hech qachon ishga tushmagan. Uch yugurish natijasi:
| Commit | Natija | Nima topildi |
|---|---|---|
asos + ci.yml |
qizil, 2:50 | web formati; api'da 3 test |
namuna sql/ dan |
qizil, 3:00 | api yashil; web'da 23 test |
.gitignore tuzatildi |
yashil, 2:03 | — |
1-yugurish: web. npm run check ning birinchi qadami — Prettier — 2 soniyada yiqildi:
Checking formatting...
[warn] src/api.ts
[warn] Code style issues found in the above file. Run Prettier with --write to fix.25-qismda api.ts ga qo'shilgan o'zgarish formatlanmagan ekan. 33-qismda web loyihasining check i umuman yurgizilmagan — shuning uchun hech kim ko'rmadi.
1-yugurish: api. Testlar yakuni:
Test Files 1 failed | 68 passed | 1 skipped (70)
Tests 3 failed | 345 passed | 1 skipped (349)Uchala yiqilgan test bitta faylda — ombor-modul.test. Birinchisi:
Error: expected 200 "OK", got 401 "Unauthorized"Test Aziz nomidan kiradi. Aziz esa namuna bazada — sql/ dagi fayllarda. Eski CI faylida baza npm run db:seed bilan to'ldirilardi. Seed skripti esa boshqa foydalanuvchilarni yaratadi (…@seed.example). Aziz yo'q — kirish 401. Ikkinchi test boshqacha yiqildi: 1 !== 0 — test oxirida bazaga ulanish yopilmay qolgan. Bu kaskad: birinchi test yarim yo'lda yiqilib, ilovani yopmagan. Bitta sabab — uch qizil test.
Tuzatish — namuna bazani sql/ dan qurish (yuqoridagi qadam).
2-yugurish. api — yashil. Web'da esa 23 test yiqildi, hammasi bir xil xabar bilan:
AssertionError: expected 'Serverga ulanib bo\'lmadi. Ro\'yxat —…' to be '' // Object.is equalityBu safar xato bizniki edi. Sinov repo'sining ildizidagi .gitignore da .env.* naqshi bor edi. U web loyihasining commit qilingan .env.test va .env.production fayllarini ham repo'dan chiqarib tashladi. Bu fayllarda sir yo'q — ular konfiguratsiya (testlar qaysi manzilga murojaat qilishi). Fayl yo'q — testlar boshqa manzilga ulanmoqchi bo'ldi. .gitignore tuzatildi: endi faqat .env.
3-yugurish — yashil, 2 daqiqa 3 soniya. Shu yugurishda S3 va pochta servislari bilan testlar ham birinchi marta GitHub'da o'tdi. Aslida ular 1-yugurishdayoq yashil edi:
✓ asosiy test/bildirishnoma.test.ts (4 tests) 1033ms
✓ asosiy test/fayl.test.ts (3 tests) 1620ms
✓ asosiy test/email.test.ts (7 tests) 1245ms
✓ asosiy test/pochta.test.ts (4 tests) 825msSaboq: CI fayli yozilgan, lekin yurmagan bo'lsa — u yo'q. Har qism davomida "testlar yashil" deganimiz faqat lokal kompyuterda rost edi. Birinchi haqiqiy yugurish ikki yashirin nuqsonni va bitta yangi xatomizni topdi.
Diqqat:
.gitignoredagi keng naqsh (.env.*,*.local) xavfsizlik uchun qulay tuyuladi, lekin kerakli fayllarni ham yashiradi. Qo'shgandan keyingit status --ignoredbilan nima chiqib ketganini ko'ring.
7.2 Yashil yugurish ichida vaqt qayerga ketdi
api job'i 2 daqiqa yurdi. Uning qadamlari:
- servislar20 s
- npm ci16 s
- bazalar5 s
- tip4 s
- lint10 s
- test54 s
- build4 s
Manba: Kurs tajribasi (IlmHamroh, 2026-11): GitHub Actions, ubuntu-24.04, bitta yugurish
Test — eng katta bo'lak. Servislarni ko'tarish (20 s) va paket o'rnatish (16 s) ham sezilarli. npm ci ni tezlashtirishga urinishni Actions tezligi darsida o'lchaymiz — natija kutilganidek bo'lmaydi.
Bitta yugurish — bitta o'lchov. Keyingi yugurishlarda test qadami 66–87 soniya oralig'ida bo'ldi. Runner'lar umumiy bulutda ishlaydi va tezligi o'zgarib turadi.
8. Loyiha qadami
Monorepo'ngizga .github/workflows/ci.yml ni qo'shing. Tuzilma «Job'lar va needs» bo'limidagi diagrammadagidek: api, web, arxitektura (matrix), artefakt. To'liq fayl qismning yakuniy kodida bor. Tekshiring:
sql/papkasi repo'da — namuna baza shundan quriladi..gitignoreildizda.envni yashiradi, lekin web'ning.env.testini emas.env: HUSKY: 0— web'ningnpm cii Git hook o'rnatmoqchi bo'ladi (Git hooklar); CI'da hook kerak emas.- Push qiling va
gh run watchbilan kuzating (Birinchi CI workflow).
Birinchi yugurish qizil chiqsa — xavotir olmang, bu normal. Xatoni o'qing (gh run view --log-failed), lokal takrorlang, tuzating. Kanon ham ikki marta qizil bo'ldi.
Commit xabari, masalan:
ci: monorepo CI — api (Postgres, Redis, S3, pochta servislari), web, x64/arm64 matrixRepo'ngiz ochiq (public) bo'lsa, standart runner'lar, jumladan arm64 ham, bepul.
9. Ko'p uchraydigan xatolar
9.1 Servis tayyor bo'lmasdan test boshlandi
connect ECONNREFUSED 127.0.0.1:5432 — Postgres hali ishga tushmoqda. Yechim — options da --health-cmd: GitHub sog'lom holatni kutadi.
9.2 Servisga noto'g'ri manzil
Job runner'da ishlasa — 127.0.0.1 va ports. Job o'zi konteynerda (container:) ishlasa — servis nomi (postgres:5432), ports shart emas (GitHub Docs, tekshirildi, 2026-11; kursda sinalmagan). Aralashtirsangiz — ulanish xatosi.
9.3 Output'ni massiv deb o'ylash
needs.x.outputs.papkalar — satr. matrix ga to'g'ridan berilsa, bitta element bo'ladi. fromJSON unutilmasin.
9.4 schedule ishlamayapti
Ikki sabab: fayl sukut tarmog'ida emas yoki vaqtni Toshkent bo'yicha yozgansiz. timezone kaliti yozilmasa, cron — UTC'da.
9.5 timeout-minutes yo'q
Osilib qolgan test olti soat davom etadi va daqiqalarni yeydi (yopiq repo'da — pul). Har job'ga real chegarani yozing.
10. Mashqlar
Mashqlar kurs/mashqlar/34/02-actions/ da. 2-mashq Node 24.21.0 da, 3-mashq Git Bash'da tekshirilgan (biz ishga tushirdik).
1-mashq (oson): bo'shliqlarni to'ldiring
- Job'ni boshqa job'lardan keyin yurgizadigan kalit —
- Workflow'ni qo'lda ishga tushirish trigger'i —
- Bitta job ta'rifidan bir nechta nusxa yasaydigan bo'lim —
- Job'dan job'ga qiymat uzatish uchun qadam yozadigan fayl —
$ - Satr ko'rinishidagi JSON'ni massivga aylantiruvchi ifoda funksiyasi —
Yechim
- needs — tartib va natijalarga kirish.
- workflow_dispatch —
inputsbilan. - matrix — kombinatsiyalar ko'paytmasi.
- GITHUB_OUTPUT —
nom=qiymatqatorlari. - fromJSON — dinamik matrix uchun.
2-mashq (o'rta): workflow qancha yuradi
Job'lar parallel yuradi, needs esa kutishga majbur qiladi. Workflow'ning umumiy vaqti — eng uzun "kutish zanjiri". devorVaqti(joblar) funksiyasini yozing. joblar — obyekt: { nom: { soniya, needs } } (needs bo'lmasligi mumkin). Funksiya "<vaqt> s: <zanjir>" satrini qaytarsin, zanjir — api → artefakt ko'rinishida. Navbatda kutish va runner'ni tayyorlash vaqtini hisobga olmang.
Ma'lumot — kanon yugurishidan: api 165 s, web 47 s, tip x64 34 s, tip arm64 46 s, artefakt 7 s (needs: [api, web]). Ikkinchi holatda api testlari ikki parallel job'ga bo'lingan deb hisoblang: api-1 va api-2, har biri 90 s.
Ishora: job tugash vaqti = needs dagi job'larning eng kech tugashi + o'z vaqti. Buni rekursiv funksiya bilan hisoblang va natijalarni Map da saqlang (Map). Math.max(0, ...massiv) — bo'sh massivda 0.
Yechim
function devorVaqti(joblar) {
const tugash = new Map();
const oldingi = new Map();
function hisobla(nom) {
if (tugash.has(nom)) return tugash.get(nom);
let boshi = 0;
for (const n of joblar[nom].needs ?? []) {
const t = hisobla(n);
if (t > boshi) {
boshi = t;
oldingi.set(nom, n);
}
}
const t = boshi + joblar[nom].soniya;
tugash.set(nom, t);
return t;
}
let oxiri = null;
for (const nom of Object.keys(joblar)) {
if (oxiri === null || hisobla(nom) > hisobla(oxiri)) oxiri = nom;
}
const zanjir = [oxiri];
while (oldingi.has(zanjir[0])) {
zanjir.unshift(oldingi.get(zanjir[0]));
}
return `${tugash.get(oxiri)} s: ${zanjir.join(" → ")}`;
}
console.log(devorVaqti({
api: { soniya: 165 },
web: { soniya: 47 },
"tip-x64": { soniya: 34 },
"tip-arm64": { soniya: 46 },
artefakt: { soniya: 7, needs: ["api", "web"] },
}));
console.log(devorVaqti({
"api-1": { soniya: 90 },
"api-2": { soniya: 90 },
web: { soniya: 47 },
artefakt: { soniya: 7, needs: ["api-1", "api-2", "web"] },
}));Konsolda:
172 s: api → artefakt
97 s: api-1 → artefaktModel 172 soniya dedi, GitHub'dagi haqiqiy yugurish esa 176 soniya davom etdi. Farq — runner ajratish va job'lar orasidagi kutish. Ikkinchi holat ko'rsatadiki, tezlashtirish uchun eng uzun zanjirni qisqartirish kerak: api ikkiga bo'linsa, workflow 75 soniya tezlashadi. tip job'larini tezlashtirish esa umumiy vaqtga hech ta'sir qilmaydi.
3-mashq (qiyin): timeout-minutes yozilmagan job'lar
Bash skript yozing. U avval uch job'li namunaviy ci.yml ni yaratsin (bittasida timeout-minutes yo'q). Keyin awk bilan har job uchun nom: N daqiqa yoki nom: yozilmagan (sukut 360) chiqarsin, oxirida — yozilmaganlar soni. Faqat jobs: ichidagi job'lar hisoblansin.
Ishora: job nomi qatori — aynan ikki bo'shliq bilan boshlanadi va : bilan tugaydi: /^ [a-z][a-z0-9_-]*:$/. timeout-minutes — to'rt bo'shliq bilan. Job'lar tartibini saqlash uchun nomlarni massivga yozing (tartib[++n] = nom). awk dasturi bitta tirnoq ichida — matnda apostrof ishlatmang (Fayl va matn qidirish).
Yechim
cat > ci.yml <<'YML'
name: CI
jobs:
api:
runs-on: ubuntu-24.04
timeout-minutes: 25
steps:
- run: npm test
web:
runs-on: ubuntu-24.04
steps:
- run: npm run check
artefakt:
needs: [api, web]
runs-on: ubuntu-24.04
timeout-minutes: 5
YML
awk '
/^jobs:/ { ichida = 1; next }
/^[^ ]/ { ichida = 0 }
ichida && /^ [a-z][a-z0-9_-]*:$/ {
job = $1; sub(/:$/, "", job); tartib[++n] = job; next
}
ichida && /^ timeout-minutes:/ { vaqt[job] = $2 }
END {
for (i = 1; i <= n; i++) {
j = tartib[i]
if (j in vaqt) print j ": " vaqt[j] " daqiqa"
else { print j ": yozilmagan (sukut 360)"; yoq++ }
}
print "yozilmaganlar: " yoq + 0
}
' ci.ymlBiz ishga tushirdik:
api: 25 daqiqa
web: yozilmagan (sukut 360)
artefakt: 5 daqiqa
yozilmaganlar: 1/^[^ ]/ — bo'shliqsiz boshlangan qator (name:, on:) jobs: bo'limi tugaganini bildiradi. yoq + 0 — bitta ham topilmasa, bo'sh satr o'rniga 0 chiqsin. Bunday tekshiruv YAML'ni to'liq tushunmaydi: job nomi qo'shtirnoqda yoki boshqa chekinish bilan yozilsa, adashadi. Jiddiy loyihada buning uchun YAML o'quvchi kutubxona yoki actionlint kabi linter ishlatiladi.
11. Real ishda
- Katta monorepo'lar (Nx, Turborepo) "nima o'zgardi" job'i va dinamik matrix bilan faqat ta'sirlangan paketlarni tekshiradi —
fromJSONnaqshining sanoat ko'rinishi. - Servis konteynerlari — integratsiya testlarining standart yo'li. Muqobili — Testcontainers: test o'zi konteyner ko'taradi (Test arxitekturasi va CI).
- Matrix — kutubxonalarda keng: bir paket Node 20, 22, 24 va uch OS'da sinaladi.
- Intervyu savollari: "
needsvaif: always()qachon kerak?", "Job'lar orasida qiymat qanday uzatiladi?", "CI'da Postgres'ni qanday ko'tarasiz?", "${{ }}qachon hisoblanadi?"
Xulosa
on:push/pull_request+paths(monorepo'da behuda yugurishsiz),workflow_dispatch+inputs,schedule(sukut UTC, faqat sukut tarmog'idan).- Job'lar parallel;
needs— tartib, natija vaoutputs; umumiy vaqt — eng uzun zanjir. services— test uchun Postgres, Redis, S3, pochta; healthcheck bilan, aniq versiyada.matrix— kombinatsiyalar;fail-fast: falsebilan ikkala arxitektura natijasi ko'rinadi.${{ }}qadam ishga tushishidan oldin matnga qo'yiladi; output — satr, massiv uchunfromJSON.- Birinchi haqiqiy yugurish: format xatosi, seed ↔ namuna baza nomuvofiqligi va keng
.gitignore— uch yugurishda yashil.
Keyingi dars: Actions xavfsizligi: secrets, permissions, environments, OIDC — avtomatik token huquqlarini, sir maskalashning chegarasini va PR sarlavhasi orqali buyruq bajarishni haqiqiy yugurishlarda sinaymiz.
Manbalar
- GitHub Docs — Workflow syntax (
on.<push>.paths,jobs.<job_id>.timeout-minutessukut 360,strategy.fail-fastsukuttrue): https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax (tekshirildi, 2026-11) - GitHub Docs — Events that trigger workflows (
schedule: sukut tarmog'i, UTC,timezone, soat boshidagi kechikish): https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule (tekshirildi, 2026-11) - GitHub Docs — Contexts reference: https://docs.github.com/en/actions/reference/workflows-and-actions/contexts (tekshirildi, 2026-11)
- GitHub Docs — Expressions: https://docs.github.com/en/actions/reference/workflows-and-actions/expressions (tekshirildi, 2026-11)
- GitHub Docs — Service containers: https://docs.github.com/en/actions/tutorials/use-containerized-services/use-docker-service-containers (tekshirildi, 2026-11)
- Kurs tajribasi (IlmHamroh, 2026-11): sinov repo'sidagi
ci.ymlvaifodalar.ymlning GitHub Actions yugurishlari (uch CI yugurishi, qo'lda ishga tushirilganifodalar). Mashq yechimlari — biz ishga tushirdik (2026-11-08).
Izohlar · 0
Izoh yozish uchun kiring.