DevOps

Запускает workflow при пуше в репозиторий. Можно настроить для определённых веток, тегов или типов файлов.

on:
  push:
    branches:
      - main
    tags:
      - 'v*' # Срабатывает при пуше тегов, начинающихся с "v"
    paths:
      - 'src/**' # Срабатывает при изменении файлов в папке src

Запускает workflow при создании или обновлении pull request. Как и с push, можно ограничить запуск для определённых веток или типов файлов.

on:
  pull_request:
    branches:
      - main
    paths-ignore:
      - '**/*.md' # Игнорирует изменения только в .md файлах

Добавляет возможность вручного запуска workflow.

on:
  workflow_dispatch:
    inputs:
      environment:
        description: 'Deployment environment'
        required: true
        default: 'production'
        type: choice
        options:
          - development
          - staging
          - production

Позволяет настроить запуск по расписанию, используя cron-формат.

on:
  schedule:
    - cron: '0 3 * * *' # Запускается ежедневно в 3:00 UTC

Запускает workflow при создании, публикации или изменении релиза.

on:
  release:
    types: 
      - created # Срабатывает при создании релиза
      - published # Срабатывает при публикации

Позволяет запускать workflow при действиях с issue (например, открытие, закрытие, комментарий и т.д.).

on:
  issues:
    types: [opened, edited]

Определяет группу для workflow, которые не должны выполняться одновременно. Задав группу, можно указать, что workflow из этой группы не могут быть запущены параллельно. Значение группы может быть статическим или динамическим с использованием переменных.

concurrency:
  group: build-${{ github.ref }}

Контролирует, должны ли уже запущенные workflow в этой группе быть отменены при запуске нового.

• true отменяет текущие выполняющиеся workflow из этой группы при запуске нового.

• false оставляет текущие запущенные workflow в группе, не отменяя их.

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

Каждый job может иметь уникальное имя, которое помогает организовать и понять назначение задачи в workflow.

jobs:
  build:

Указывает, на каком типе виртуальной машины (runner) будет выполняться job. Например, ubuntu-latest, macos-latest, или windows-latest.

jobs:
  build:
    runs-on: ubuntu-latest

Задаёт последовательность шагов, выполняемых в рамках job. Шаги могут включать команды, действия, сценарии и проверки.

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Check out code
        uses: actions/checkout@v2
      - name: Run tests
        run: ./gradlew test

Позволяет задать зависимость одного задания от другого. Например, если deploy должен выполняться только после успешного выполнения build, можно указать needs.

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Build code
        run: ./gradlew build

  deploy:
    runs-on: ubuntu-latest
    needs: build
    steps:
      - name: Deploy application
        run: ./deploy.sh

Позволяет указать, при каких условиях job должен выполняться. Например, можно запускать job только при выполнении определённых условий (например, при пуше в основную ветку).

jobs:
  build:
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
    steps:
      - name: Build code
        run: ./gradlew build

Устанавливает максимальное время выполнения для job, после которого выполнение будет прервано, чтобы избежать бесконечных циклов или задержек.

jobs:
  build:
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:
      - name: Build code
        run: ./gradlew build

Можно передавать секретные данные или переменные окружения, которые будут использоваться только в рамках этого job.

jobs:
  deploy:
    runs-on: ubuntu-latest
    env:
      DEPLOY_TOKEN: ${{ secrets.DEPLOY_TOKEN }}
    steps:
      - name: Deploy code
        run: ./deploy.sh