Налаштування 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 грн під ключ.

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