Hodisalar va triggerlar

Quvur qachon ishlashi kerak? Har bir kommitda? Faqat asosiy tarmoqda? Har kecha? Bunga on: kaliti javob beradi va u workflow faylidagi eng muhim qarorlardan biri.

Eng ko'p ishlatiladigan hodisalar #

push va pull_request - asosiy juftlik #

name: Testlar

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: echo "Testlar ishlayapti"

Bu eng keng tarqalgan sozlama. U shuni bildiradi:

• main ga to'g'ridan-to'g'ri push bo'lganda - tekshir;
• main ga qaratilgan PR ochilganda yoki unga yangi kommit qo'shilganda - tekshir.

Tarmoq va teg filtrlari #

on:
  push:
    branches:
      - main
      - 'reliz/**'
    branches-ignore:
      - 'qoralama/**'
    tags:
      - 'v*'

branches va branches-ignore ni bitta hodisada birga ishlatib bo'lmaydi - bittasini tanlang.

Yo'l bo'yicha filtr - eng foydali tejamkorlik #

Hujjatdagi bitta harf o'zgargani uchun butun test to'plamini ishga tushirish keraksiz. paths buni hal qiladi:

on:
  push:
    paths:
      - 'src/**'
      - 'package.json'
      - '.github/workflows/**'
    paths-ignore:
      - '**.md'
      - 'docs/**'

Jadval bo'yicha ishga tushirish #

on:
  schedule:
    - cron: '0 3 * * *'

Cron formati besh maydondan iborat:

┌─ daqiqa (0-59)
│ ┌─ soat (0-23)
│ │ ┌─ oyning kuni (1-31)
│ │ │ ┌─ oy (1-12)
│ │ │ │ ┌─ hafta kuni (0-6, 0 - yakshanba)
│ │ │ │ │
0 3 * * *

Qo'lda ishga tushirish va kiritmalar #

workflow_dispatch ga parametr berish mumkin - shunda tugma bosilganda forma chiqadi:

on:
  workflow_dispatch:
    inputs:
      muhit:
        description: 'Qaysi muhitga'
        required: true
        default: 'sinov'
        type: choice
        options:
          - sinov
          - ishlab-chiqarish
      izoh:
        description: 'Qisqacha izoh'
        required: false
        type: string

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Tanlovni ko'rsatish
        run: |
          echo "Muhit: ${{ inputs.muhit }}"
          echo "Izoh:  ${{ inputs.izoh }}"

Muhit: ishlab-chiqarish
Izoh:  qo'lda chiqarilgan tuzatish

Hodisa turlari (types) #

Ba'zi hodisalarning ichki turlari bor. Masalan, PR yopilganda emas, faqat birlashtirilganda ishlashi kerak bo'lsa:

on:
  pull_request:
    types: [opened, synchronize, reopened]

Yozilmasa, pull_request uchun standart holat opened, synchronize va reopened bo'ladi - ko'pchilik uchun aynan shu kerak.

Keraksiz ishlarni to'xtatish #

PR ga ketma-ket uchta kommit yuborsangiz, uchta ishga tushirish boshlanadi - holbuki faqat oxirgisi muhim. concurrency eskisini bekor qiladi:

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

concurrency:
  group: deploy-ishlab-chiqarish
  cancel-in-progress: false

Hodisa haqida ma'lumot #

Har bir ishga tushirishda github konteksti mavjud:

      - name: Hodisa haqida
        run: |
          echo "Hodisa:  ${{ github.event_name }}"
          echo "Tarmoq:  ${{ github.ref_name }}"
          echo "Kommit:  ${{ github.sha }}"
          echo "Muallif: ${{ github.actor }}"

Hodisa:  push
Tarmoq:  main
Kommit:  9f2c1ab7e4d5c3b8a16f0e7d2c9b4a8f5e3d1c06
Muallif: husanboy

Xulosa #

• on: kaliti quvur qachon ishlashini belgilaydi - bu eng muhim qarorlardan biri.
• Odatiy juftlik: push + pull_request, ikkalasi main ga filtrlangan holda.
• branches, tags va paths keraksiz ishga tushirishlarni kesadi.
• branches va branches-ignore (xuddi paths va paths-ignore kabi) birga ishlatilmaydi.
• schedule UTC bo'yicha ishlaydi: Toshkentdagi 08:00 - bu 0 3 * * *.
• Jadval faqat asosiy tarmoqdan o'qiladi va bir necha daqiqa kechikishi mumkin.
• workflow_dispatch tugma beradi, inputs esa unga forma qo'shadi.
• types hodisaning qaysi holatida ishlashini aniqlaydi.
• concurrency eski ishga tushirishlarni bekor qilib, navbat va hisobni tejaydi.
• Deploy quvurida cancel-in-progress: false bo'lishi kerak - yarim bajarilgan deploy xavfli.

Keyingi bo'limda job, step va runner'lar bilan chuqurroq tanishamiz.