JavaScript Full-stackGitHub Actions chuqur: trigger, job, matrix va ifodalar
JavaScript Full-stack · 34-qism. CI/CD, monitoring, bulut

GitHub Actions chuqur: trigger, job, matrix va ifodalar

20 daqiqa2/30-dars

Qisqacha: Haqiqiy loyiha CI'si bitta job'dan iborat emas. Bo'lim on workflow'ni nima uyg'otishini aytadi: push, PR, qo'lda yoki jadval. Filtr paths bilan esa — faqat kerakli papka o'zgarganda. Job'lar parallel yuradi, needs — ketma-ketlik. Bo'lim services — 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

  • on bo'limini paths, workflow_dispatch va schedule bilan yozasiz.
  • Job'larni needs bilan bog'laysiz va workflow umumiy vaqtini hisoblaysiz.
  • Testlar uchun services bilan Postgres, Redis, S3 va pochta ko'tarasiz.
  • matrix bilan bitta job'ni x64 va arm64 runner'da yurgizasiz.
  • Kontekst, ifoda, outputs va if qanday 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:

yaml
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 — faqat main ga, va faqat ro'yxatdagi papkalardan biri o'zgarganda;
  • pull_request — har PR'da, xuddi shu papkalar bilan;
  • workflow_dispatch — Actions sahifasidagi tugma yoki gh workflow run bilan 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.

js
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)); // false

Uchinchi 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: paths filtri va majburiy tekshiruv birga ishlaganda tuzoq bor. Workflow paths tufayli 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'da paths li 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:

yaml
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 --> R

Diagrammaga qarang: artefakt job'i ikkita strelka kutadi. U needs: [api, web] bilan yozilgan — ikkalasi yashil tugamaguncha boshlanmaydi. Biri qizil bo'lsa, artefakt umuman yurmaydi.

yaml
jobs:
  artefakt:
    needs: [api, web]
    runs-on: ubuntu-24.04
    timeout-minutes: 5

needs — 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 — run qadamlari qaysi papkada bajarilsin. Monorepo'da har job o'z papkasida ishlaydi va har qadamga cd yozish 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: artefakt job'iga needs: [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):

yaml
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 20

Uchta narsaga qarang:

  • Image versiyasi aniq — redis:8.8.4, redis:8 emas. Ertaga yangi Redis chiqsa, CI o'z-o'zidan o'zgarmaydi.
  • options — docker create bayroqlari. 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:

yaml
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: 10

GitHub 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:

text
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:

text
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):

text
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:

bash
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:

yaml
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:

yaml
jobs:
  har-papka:
    needs: tayyorla
    strategy:
      matrix:
        papka: ${{ fromJSON(needs.tayyorla.outputs.papkalar) }}

Natija — ikki job, har papka uchun bittadan:

text
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

yaml
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:

text
needs natijalari: [
  "success",
  "success",
  "success"
]
batafsil rejim

needs.*.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'rniga if: success() yozilsa va faqat-production o'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:

text
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:

text
 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:

text
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:

text
AssertionError: expected 'Serverga ulanib bo\'lmadi. Ro\'yxat —…' to be '' // Object.is equality

Bu 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:

text
 ✓  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) 825ms

Saboq: 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: .gitignore dagi keng naqsh (.env.*, *.local) xavfsizlik uchun qulay tuyuladi, lekin kerakli fayllarni ham yashiradi. Qo'shgandan keyin git status --ignored bilan nima chiqib ketganini ko'ring.

7.2 Yashil yugurish ichida vaqt qayerga ketdi

api job'i 2 daqiqa yurdi. Uning qadamlari:

CI: api job'i qadamlari (yashil yugurish)
  • 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:

  1. sql/ papkasi repo'da — namuna baza shundan quriladi.
  2. .gitignore ildizda .env ni yashiradi, lekin web'ning .env.test ini emas.
  3. env: HUSKY: 0 — web'ning npm ci i Git hook o'rnatmoqchi bo'ladi (Git hooklar); CI'da hook kerak emas.
  4. Push qiling va gh run watch bilan 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:

text
ci: monorepo CI — api (Postgres, Redis, S3, pochta servislari), web, x64/arm64 matrix

Repo'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 — inputs bilan.
  • matrix — kombinatsiyalar ko'paytmasi.
  • GITHUB_OUTPUT — nom=qiymat qatorlari.
  • 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
js
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:

text
172 s: api → artefakt
97 s: api-1 → artefakt

Model 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
bash
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.yml

Biz ishga tushirdik:

text
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 — fromJSON naqshining 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: "needs va if: 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 va outputs; umumiy vaqt — eng uzun zanjir.
  • services — test uchun Postgres, Redis, S3, pochta; healthcheck bilan, aniq versiyada.
  • matrix — kombinatsiyalar; fail-fast: false bilan ikkala arxitektura natijasi ko'rinadi.
  • ${{ }} qadam ishga tushishidan oldin matnga qo'yiladi; output — satr, massiv uchun fromJSON.
  • 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

34-qism. CI/CD, monitoring, bulut · 2-dars yakunlandi

GitHub Actions chuqur: trigger, job, matrix va ifodalar

20 daqvaqt
0belgi
Keyingi dars: Actions xavfsizligi: secrets, permissions, environments va OIDC
Telegram'da
Darsda xato koʻrdingizmi?

Izohlar · 0