GitHub Actions: Полное руководство по автоматизации для вайбкодеров

Если ты уже умеешь работать с GitHub, но до сих пор деплоишь проект вручную или забываешь запускать тесты — эта статья изменит твою жизнь.

GitHub Actions — это твой личный DevOps-инженер, который работает 24/7 бесплатно (в разумных пределах).

В этой статье мы разберём всё с нуля до продвинутого уровня, специально под вайбкодеров и проекты, которые создаются с помощью ИИ.

## Зачем GitHub Actions именно вайбкодеру?

Представь типичную ситуацию:

Ты попросил агента написать фичу → проверил → закоммитил → и забыл:

• запустить тесты
• проверить линтер
• задеплоить на прод

В итоге через день клиент пишет: «У меня ничего не работает».

GitHub Actions решает эту проблему навсегда.

С ним ты можешь настроить:

• Автоматический запуск тестов при каждом Pull Request
• Автоматический деплой при пуше в main
• Проверку кода на уязвимости
• Сборку Docker-образа
• Отправку уведомлений в Telegram
• Запуск AI-агента по расписанию

И всё это — бесплатно и работает даже когда ты спишь.

## Что такое GitHub Actions простыми словами

GitHub Actions — это система автоматизации, встроенная прямо в GitHub.

Ты создаёшь файл с инструкциями (workflow), и GitHub выполняет их автоматически при определённых событиях (пуш, Pull Request, по расписанию и т.д.).

## Основные понятия

## Шаг 1. Создаём первый Workflow

1. Перейди в свой репозиторий
2. Зайди во вкладку Actions
3. Нажми New workflow → set up a workflow yourself

GitHub создаст папку .github/workflows/ и файл main.yml.

Пример самого простого workflow:

name: Hello World

on:
  push:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Say hello
        run: echo "Привет, вайбкодер! 🚀"

Сохрани файл — и workflow уже работает!

## Шаг 2. Основные триггеры (on:)

Самые полезные триггеры для вайбкодера:

on:
  push:
    branches: [ main, develop ]
  
  pull_request:
    branches: [ main ]
  
  schedule:
    - cron: '0 9 * * 1'        # Каждый понедельник в 9:00 UTC
  
  workflow_dispatch:           # Ручной запуск из интерфейса

Самые популярные комбинации:

• push + main → деплой в продакшен
• pull_request → запуск тестов и проверок
• workflow_dispatch → ручной запуск (очень удобно)

## Шаг 3. Секреты и переменные окружения

Никогда не храни API-ключи и пароли в коде!

### Как добавить секрет:

1. Репозиторий → Settings → Secrets and variables → Actions
2. Нажми New repository secret
3. Добавь, например:
   • VERCEL_TOKEN
   • RAILWAY_TOKEN
   • TELEGRAM_BOT_TOKEN

### Использование в workflow:

- name: Deploy to Vercel
  env:
    VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
  run: vercel --prod --token $VERCEL_TOKEN

## Шаг 4. Кэширование (чтобы было быстро)

Без кэширования каждый запуск workflow будет скачивать все зависимости заново. Это долго и дорого.

Пример кэширования Node.js:

- name: Setup Node.js
  uses: actions/setup-node@v4
  with:
    node-version: '20'
    cache: 'npm'

- name: Install dependencies
  run: npm ci

Для Python:

- uses: actions/setup-python@v5
  with:
    python-version: '3.11'
    cache: 'pip'

## Шаг 5. Автоматический деплой (самое вкусное)

### Деплой на Vercel

name: Deploy to Vercel

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Deploy to Vercel
        uses: amondnet/vercel-action@v25
        with:
          vercel-token: ${{ secrets.VERCEL_TOKEN }}
          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
          vercel-args: '--prod'

### Деплой на Railway

- name: Deploy to Railway
  run: railway up --service ${{ secrets.RAILWAY_SERVICE_ID }}
  env:
    RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}

## Шаг 6. Полезные готовые Actions

• actions/checkout@v4 — клонирование репозитория
• actions/setup-node@v4 — установка Node.js
• actions/setup-python@v5 — установка Python
• actions/cache@v4 — кэширование
• slackapi/slack-github-action — уведомления в Slack
• appleboy/telegram-action — уведомления в Telegram

## Лучшие практики для вайбкодеров

1. Всегда используй workflow_dispatch — чтобы можно было запустить вручную
2. Разделяй большие workflow на несколько мелких (CI + CD)
3. Используй матрицы для тестирования на разных версиях Python/Node
4. Добавляй continue-on-error для некритичных шагов
5. Пиши понятные названия шагов — это важно, когда workflow падает

## Частые ошибки

• Забывают добавить actions/checkout@v4
• Хранят секреты прямо в коде
• Не используют кэширование (workflow выполняется по 10–15 минут)
• Делают слишком сложные workflow (лучше разбивать)
• Не тестируют workflow локально (можно через act)