Настройка CI/CD для сайта через GitHub Actions

Настройка CI/CD для сайта через GitHub Actions

Каждый второй релиз на production срывается из-за человеческого фактора: забыли залить файл, не обновили конфиг, пропустили тесты. CI/CD исключает эти риски. Мы, в компании с 5-летним опытом, настроили более 50 пайплайнов для проектов от лендингов до высоконагруженных SaaS. GitHub Actions — наш выбор для быстрой автоматизации. Закажите настройку — получите готовый пайплайн за 1–5 дней.

Почему GitHub Actions?

В отличие от Jenkins или GitLab CI, не нужно поднимать отдельный сервер, настраивать вебхуки и плагины. Всё управляется через YAML-файлы в репозитории. Для публичных проектов — бессрочно бесплатно. Для приватных — 2000 минут в месяц на бесплатном тарифе, чего хватает на 400–1000 деплоев. При превышении лимита можно подключить self-hosted runner на своём сервере — минуты не расходуются. GitHub Actions в 2 раза быстрее настраивается, чем GitLab CI, и не требует сервера, в отличие от Jenkins.

Как ускорить сборку с помощью кеширования?

Кеширование зависимостей — главный ускоритель. actions/setup-node с параметром cache: 'npm' автоматически кеширует ~/.npm. Для PHP используйте actions/cache с ключом по composer.lock. Пример для Composer:

- uses: actions/cache@v4
  with:
    path: vendor
    key: composer-${{ hashFiles('composer.lock') }}

После прогрева кеша время прогона падает с 3–5 минут до 60–90 секунд. Матричные сборки (несколько версий Node.js) выполняются параллельно и кешируются отдельно. Экономия времени команды — 3 часа в неделю, что при средней ставке DevOps даёт до 25 000 ₽ в месяц.

Структура воркфлоу

Минимальный воркфлоу для сайта на Node.js с деплоем на сервер по SSH:

name: Deploy

on:
  push:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-22.04
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm test

  build:
    needs: test
    runs-on: ubuntu-22.04
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run build
      - uses: actions/upload-artifact@v4
        with:
          name: dist
          path: dist/

  deploy:
    needs: build
    runs-on: ubuntu-22.04
    environment: production
    steps:
      - uses: actions/download-artifact@v4
        with:
          name: dist
          path: dist/
      - name: Deploy via rsync
        uses: burnett01/[email protected]
        with:
          switches: -avzr --delete
          path: dist/
          remote_path: /var/www/mysite
          remote_host: ${{ secrets.DEPLOY_HOST }}
          remote_user: deploy
          remote_key: ${{ secrets.DEPLOY_KEY }}

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

Управление секретами

Все чувствительные данные — в Settings → Secrets and variables → Actions. Никакие ключи или пароли не попадают в код. Для разных окружений используем Environments — каждый набор секретов изолирован. Деплой в production можно защитить ручным одобрением.

- name: Configure .env
  run: |
    echo "DATABASE_URL=${{ secrets.DATABASE_URL }}" >> .env
    echo "APP_KEY=${{ secrets.APP_KEY }}" >> .env

Docker-сборка и пуш в Registry

Если деплой идёт через контейнеры:

- name: Build and push Docker image
  uses: docker/build-push-action@v5
  with:
    context: .
    push: true
    tags: ghcr.io/${{ github.repository }}:${{ github.sha }}
    cache-from: type=gha
    cache-to: type=gha,mode=max

GitHub Container Registry доступен бесплатно, авторизация через встроенный GITHUB_TOKEN.

Уведомления о статусе

- name: Notify Telegram on failure
  if: failure()
  uses: appleboy/telegram-action@master
  with:
    to: ${{ secrets.TELEGRAM_CHAT_ID }}
    token: ${{ secrets.TELEGRAM_TOKEN }}
    message: "❌ Deploy failed: ${{ github.repository }} @ ${{ github.sha }}"

if: failure() запускает только при сбое. Для уведомлений о начале и успехе — if: always().

Пошаговая инструкция настройки CI/CD

1. Создайте в корне репозитория папку .github/workflows.
2. Добавьте файл deploy.yml с конфигурацией (пример выше).
3. Настройте секреты в Settings → Secrets and variables → Actions.
4. Запушьте изменения в ветку main — воркфлоу запустится автоматически.
5. Проверьте статус во вкладке Actions репозитория.
6. При успехе — деплой выполнен. При ошибке — получите уведомление.

Сравнение: GitHub Actions vs другие CI/CD

GitHub Actions проще в настройке, чем Jenkins, и не требует выделенного сервера. Для большинства веб-проектов это оптимальный выбор.

Этапы настройки и сроки

Что входит в работу

Мы предоставляем полный цикл настройки CI/CD:

• Анализ текущего процесса деплоя и архитектуры проекта
• Создание YAML-воркфлоу с тестами, сборкой, деплоем
• Настройка секретов и окружений в репозитории
• Оптимизация скорости сборки (кеширование, матрицы)
• Интеграция уведомлений (Telegram, Slack, email)
• Документация по воркфлоу и инструкция для команды
• Обучение разработчиков работе с пайплайном

name: Deploy
on: [push]
jobs:
  test:
    runs-on: ubuntu-22.04
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm test
  build:
    needs: test
    runs-on: ubuntu-22.04
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run build
      - name: Build Docker image
        run: docker build -t myapp .
      - name: Push to registry
        run: docker push ghcr.io/myorg/myapp:latest
  deploy:
    needs: build
    runs-on: ubuntu-22.04
    steps:
      - name: Deploy via SSH
        uses: appleboy/[email protected]
        with:
          host: ${{ secrets.DEPLOY_HOST }}
          username: deploy
          key: ${{ secrets.DEPLOY_KEY }}
          script: |
            docker pull ghcr.io/myorg/myapp:latest
            docker-compose up -d

Наши результаты и опыт

Более 5 лет мы настраиваем CI/CD для проектов разной сложности — от лендингов до высоконагруженных SaaS. 50+ реализованных пайплайнов с гарантией стабильной работы. Каждый кейс документируем, чтобы команда заказчика могла самостоятельно поддерживать и дорабатывать пайплайн. Стоимость простоев из-за ошибок деплоя может достигать 100 000 ₽ в день — CI/CD это исключает.

Сроки и стоимость

• Базовый воркфлоу (тест + деплой по SSH) — 1–2 дня
• Полный pipeline (матрицы, Docker, уведомления, ручные одобрения) — 3–5 дней

Стоимость рассчитывается индивидуально в зависимости от сложности и стека. Свяжитесь с нами для консультации — подберем оптимальное решение для вашего проекта.

Мы регулярно сталкиваемся с ситуацией: «Сайт не открывается» в 3 часа ночи — и выясняется, что disk full на VPS, потому что логи nginx не ротировались полгода. Или сервер лёг под нагрузкой в день запуска рекламной кампании, потому что на shared хостинге стоял лимит в 50 одновременных соединений. Настройка хостинга и деплоя — это не про «где дешевле», это про то, что происходит в момент, когда что-то идёт не так. Наша команда помогает избежать таких инцидентов, проектируя инфраструктуру с учётом реальных паттернов нагрузки.

Когда выбирать Vercel и Netlify?

Vercel создан под Next.js — деплой в один push, preview deployments для каждого PR, автоматический CDN, Edge Functions, ISR без конфигурации. Для фронтенд-проектов и JAMstack это оптимальный выбор: нет операционной нагрузки, time-to-deploy измеряется минутами.

Ограничения реальные: Vercel Serverless Functions запускаются в us-east-1 по умолчанию (latency для Европы +80–100ms), Function timeout 300 секунд на Pro, Bandwidth 1TB/месяц на Pro. Для тяжёлого backend — нужны воркеры или отдельный сервер.

Netlify ближе к статике и Edge Functions на базе Deno Deploy. Build minutes — основное ограничение на бесплатном тарифе.

Почему Docker — основа предсказуемого деплоя?

«Работает на моей машине» — классика. Docker решает это через контейнеризацию окружения. Но плохой Dockerfile создаёт новые проблемы.

Типичная ошибка: копировать всё в образ без .dockerignore, получать 800MB образ вместо 80MB. node_modules внутри образа весит столько же. Правильно: multi-stage build.

FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build

FROM node:20-alpine AS runner
WORKDIR /app
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./package.json
EXPOSE 3000
CMD ["npm", "start"]

Итоговый образ: 180MB вместо 1.2GB. Время сборки CI сокращается из-за layer caching — если package.json не изменился, слой с npm ci берётся из кэша.

Docker Compose для локальной разработки и простых продакшен-сценариев: приложение + PostgreSQL + Redis в одной конфигурации. Для production на одном сервере — вполне рабочий вариант, если нет требований горизонтального масштабирования.

Подробнее о контейнеризации — Wikipedia: Docker.

Как настроить Nginx как reverse proxy?

Nginx перед приложением — стандарт для VPS и выделенных серверов. Основные функции: SSL termination, gzip, static files, rate limiting, upstream балансировка.

Конфигурация, которую часто делают неправильно: worker_processes auto — количество процессов равно числу CPU. worker_connections 1024 — это 1024 на каждый воркер-процесс. При 4 CPU и 1024 connections = 4096 одновременных соединений. Для высоконагруженного сайта нужно worker_connections 4096 и настройка keepalive_timeout 65.

Для статических ассетов с хешем в имени файла:

location ~* \.(js|css|woff2|png|webp)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}

immutable сообщает браузеру: не проверяй этот файл даже при hard refresh. Правильно работает только с content-hashed именами файлов (что делает Vite/webpack по умолчанию). Документация — Wikipedia: Nginx.

AWS: гибкость и сложность

EC2 + Auto Scaling Group — классика для горизонтального масштабирования. AMI с предустановленным приложением, Launch Template, ASG с min/desired/max instances, Application Load Balancer. При CPU > 70% на 3 минуты — scale out, при CPU < 30% на 15 минут — scale in. Health check через ALB исключает нездоровые инстансы из ротации.

ECS Fargate — контейнеры без управления EC2. Деплой Docker-образа, задаёте CPU/память (512 CPU units = 0.5 vCPU, от 512MB памяти), Fargate запускает. Дороже Lambda, но нет cold start и нет timeout-ограничений. Подходит для long-running процессов, WebSocket-серверов, тяжёлых воркеров.

RDS для PostgreSQL с Multi-AZ: автоматический failover за 1–2 минуты при падении primary. Read Replicas для масштабирования чтения. RDS Proxy для connection pooling — Lambda-функции не умеют держать долгосрочные соединения, прокси буферизует это.

Kubernetes: когда это оправдано

K8s добавляет значительную операционную сложность. Оправдан, когда: несколько команд деплоят независимые сервисы, нужна тонкая настройка ресурсов на сервис, canary deployments и blue/green без простоя — требование.

AWS EKS, GKE или managed k8s от Hetzner (дешевле). Helm charts для стандартных сервисов. Horizontal Pod Autoscaler по CPU и custom metrics (RPS через Prometheus).

Для большинства стартапов и средних проектов — Kubernetes избыточен. ECS или Fly.io дают 80% возможностей при 20% операционной сложности.

Мониторинг и alerting

Сервер без мониторинга — это ожидание инцидента. Минимальный стек: Prometheus + Grafana (или Grafana Cloud для managed), alerting на disk > 80%, memory > 85%, CPU > 90% за 5 минут, error rate > 1%. Uptime через Better Uptime или Upptime (self-hosted).

Logs: Loki + Grafana или CloudWatch Logs Insights. Структурированные JSON-логи (winston, pino) — обязательно, иначе поиск по логам превращается в боль.

Что входит в настройку хостинга

• Аудит текущей инфраструктуры и профилирование нагрузки
• Выбор целевой архитектуры (VPS, AWS, serverless, Kubernetes)
• Настройка CI/CD pipeline (GitHub Actions, GitLab CI) с автоматическим деплоем
• IaC через Terraform или Pulumi (инфраструктура как код)
• Конфигурация Nginx, SSL-сертификаты, HTTP/2, brotli
• Мониторинг и алертинг (Prometheus + Grafana, PagerDuty)
• Документация runbooks и обучение команды

Дополнительно: пишите, если нужна миграция с текущего хостинга или интеграция с внешними сервисами.

Процесс работы

1. Аудит текущей инфраструктуры (2–5 дней)
2. Выбор целевой архитектуры с обоснованием по нагрузке и бюджету (1–3 дня)
3. Настройка CI/CD pipeline (GitHub Actions, GitLab CI) (2–5 дней)
4. IaC через Terraform или Pulumi (3–10 дней)
5. Настройка мониторинга и alerting (2–5 дней)
6. Документация runbooks и обучение команды (1–3 дня)

Наш опыт — 7 лет на рынке, более 50 проектов, гарантия работоспособности после деплоя.

Сроки

• Базовый деплой на VPS с Docker + Nginx + CI/CD: 1–2 недели.
• Настройка AWS инфраструктуры с Auto Scaling, RDS, CDN: 3–6 недель.
• Миграция на EKS с нуля: 6–12 недель.
• Настройка Vercel/Netlify для JAMstack: 3–5 дней.

Стоимость рассчитывается индивидуально в зависимости от сложности и объёма работ. Получите консультацию — оценим вашу архитектуру за один день.