Налаштування 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.

Пришвидшення збірки кешуванням

Документація GitHub рекомендує кешувати залежності для прискорення workflow. Кешування залежностей — головний прискорювач. actions/setup-node з параметром cache: 'npm' автоматично кешує ~/.npm. Для PHP використовуйте actions/cache з ключем по composer.lock.

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

Після прогріву кешу час прогону падає з 3–5 хвилин до 60–90 секунд — це в 4 рази швидше. Матричні збірки (кілька версій Node.js) виконуються паралельно і кешуються окремо. Економія часу команди — 3 години на тиждень, що при середній ставці DevOps $50/год дає до $600 на місяць (близько 22 000 грн).

Структура воркфлоу (мінімальний приклад)

Мінімальний воркфлоу для сайту на Node.js з деплоєм на сервер по SSH. Цей приклад базується на офіційній документації GitHub Actions:

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 дні, від 3000 грн під ключ.
• Повний pipeline (матриці, Docker, сповіщення, ручні схвалення) — 3–5 днів, від 8000 грн під ключ.

Вартість розраховується індивідуально. Напишіть нам для консультації — оцінимо проект безкоштовно.

Ми регулярно стикаємося з ситуацією: «Сайт не відкривається» о 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 днів.

Вартість розраховується індивідуально залежно від складності та обсягу робіт. Отримайте консультацію — оцінимо вашу архітектуру за один день.