Настройка автоматического запуска Lighthouse CI при каждом деплое

Вы пушите фичу, всё зелёное, через неделю LCP на мобильных подскакивает с 2.5с до 6с. Регрессия ушла в прод — знакомо? Мы видели такие случаи десятки раз. Решение — автоматический запуск Lighthouse CI при каждом деплое. Вы ловите падение метрик на этапе CI, а не в проде, и точно знаете, какой коммит инициировал деградацию. Наш опыт — более 50 успешных интеграций.

Автоматизация обнаруживает регрессии в 3 раза быстрее ручных проверок и исключает человеческий фактор. Вместо еженедельного аудита — проверка каждого изменения с блокировкой сборки при выходе за пороги. Время выявления проблемы сокращается с 2 дней до 2 часов. Lighthouse CI documentation рекомендует такой подход для поддержания Core Web Vitals.

Как настроить автоматический запуск Lighthouse при деплое?

Минимальный стек: CI/CD (GitHub Actions, GitLab CI) + Lighthouse CI CLI + место хранения результатов. Мы используем self-hosted LHCI сервер для истории и сравнения с baseline. Конфигурация описывается в .lighthouserc.js.

module.exports = {
  ci: {
    collect: {
      url: [
        'http://localhost:3000/',
        'http://localhost:3000/about',
        'http://localhost:3000/catalog',
        'http://localhost:3000/product/test-product',
      ],
      numberOfRuns: 3,
      startServerCommand: 'npm run start:ci',
      startServerReadyPattern: 'ready on',
      startServerReadyTimeout: 30000,
    },
    assert: {
      assertions: {
        'categories:performance': ['warn', { minScore: 0.8 }],
        'categories:accessibility': ['error', { minScore: 0.9 }],
        'categories:best-practices': ['warn', { minScore: 0.85 }],
        'categories:seo': ['error', { minScore: 0.9 }],
        'first-contentful-paint': ['warn', { maxNumericValue: 2000 }],
        'largest-contentful-paint': ['error', { maxNumericValue: 2500 }],
        'total-blocking-time': ['warn', { maxNumericValue: 300 }],
        'cumulative-layout-shift': ['error', { maxNumericValue: 0.1 }],
        'speed-index': ['warn', { maxNumericValue: 3400 }],
      },
    },
    upload: {
      target: 'temporary-public-storage',
    },
  },
};

GitHub Actions workflow:

name: Lighthouse CI
on:
  push:
    branches: [main, master]
  pull_request:
    branches: [main, master]

jobs:
  lighthouse:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - name: Install dependencies
        run: npm ci
      - name: Build
        run: npm run build
      - name: Run Lighthouse CI
        run: |
          npm install -g @lhci/[email protected]
          lhci autorun
        env:
          LHCI_GITHUB_APP_TOKEN: ${{ secrets.LHCI_GITHUB_APP_TOKEN }}
          LHCI_TOKEN: ${{ secrets.LHCI_TOKEN }}

Что даёт автоматизация Lighthouse?

Автоматизация превращает Lighthouse из разовой проверки в процесс. Таблица сравнения:

Self-hosted LHCI сервер даёт историю и сравнение с baseline. Инвестиции в настройку варьируются от 20 000 до 40 000 ₽ в зависимости от сложности.

Почему стоит выбрать self-hosted LHCI сервер?

Self-hosted сервер хранит отчёты в вашей инфраструктуре, позволяет сравнивать PR с главной веткой и строить тренды. Никакой зависимости от внешних сервисов — все данные под контролем. Дополнительно, вы можете настроить уведомления при падении Core Web Vitals ниже порога.

Какие метрики критически важны для e-commerce?

Для интернет-магазина ключевые метрики — Largest Contentful Paint (LCP) должен быть не более 2.5 с, Cumulative Layout Shift (CLS) не более 0.1, Total Blocking Time (TBT) не более 200 мс. Автоматический Lighthouse CI проверяет их каждый деплой, гарантируя, что изменения не ухудшат пользовательский опыт. Например, после добавления нового баннера LCP выросло на 0.5 с — CI заблокировал сборку, и разработчик исправил до прода. Благодаря такому мониторингу производительности в 95% случаев регрессия обнаруживается в течение 10 минут.

Процесс работы над настройкой

1. Аналитика — определяем ключевые страницы и пороги метрик. Например, для маркетплейса это карточка товара, каталог и главная.
2. Проектирование — выбираем стек (GitHub Actions, GitLab CI, self-hosted) и архитектуру хранения.
3. Реализация — настраиваем .lighthouserc.js, workflow CI, добавляем уведомления в Slack или Telegram.
4. Тестирование — прогоняем на PR, корректируем пороги, убеждаемся, что ложные срабатывания исключены.
5. Документация и обучение — передаём конфиги, пишем инструкцию для команды и настраиваем дашборд.

Уведомления о деградации

LHCI не отправляет Slack-уведомления встроенно, но мы добавляем шаг в CI:

- name: Check Lighthouse results and notify
  if: always()
  run: |
    RESULT=$(cat .lighthouseci/manifest.json | jq -r '.[0].summary.performance')
    SCORE=$(echo "$RESULT * 100" | bc | cut -d. -f1)
    if [ "$SCORE" -lt "80" ]; then
      curl -X POST ${{ secrets.SLACK_WEBHOOK }} \
        -H 'Content-Type: application/json' \
        -d "{\"text\": \":warning: Lighthouse Performance score dropped to ${SCORE}/100 on \`${{ github.ref_name }}\"",\"attachments\": [{\"color\": \"danger\",\"text\": \"Commit: ${{ github.sha }}\
Actor: ${{ github.actor }}\"}]}"
    fi

Типичные проблемы при настройке

Проверка конкретных аудитов

Помимо категорийных скоров, мы настраиваем проверки конкретных аудитов, например, render-blocking-resources, unsized-images, prioritize-lcp-image. Это даёт более точный контроль, чем общий скор. Также можно настроить проверку отдельных аудитов в конфигурации.

Сроки и что входит

Базовая настройка в GitHub Actions с временным хранилищем — 2–4 часа. С self-hosted сервером и уведомлениями — 1–2 рабочих дня. Полная система с историей, сравнением и интеграцией в ревью — 3–5 рабочих дней.

• Конфигурация Lighthouse CI для вашего репозитория.
• Настройка self-hosted LHCI сервера (если нужна история).
• Интеграция с Slack/Telegram для уведомлений.
• Пороги для всех метрик Core Web Vitals.
• Документация и обучение команды.

Экономия бюджета на поддержку может составлять до 15 000 ₽ в месяц. Наша команда занимается Web Performance более 5 лет. Мы выполнили 50+ интеграций Lighthouse CI для проектов разных масштабов — от лендингов до маркетплейсов. Гарантируем прозрачность: вы получаете доступ к конфигам и истории изменений.

Закажите настройку Lighthouse CI — это займёт от 2 часов. Получите консультацию по архитектуре и экономию времени до 3 часов в неделю.

Почему Core Web Vitals критичны для технического SEO

PageSpeed показывает 34/100 на мобильных. В Search Console — красные метрики по всем страницам категорий. Конкурент с сайтом на 3 года старше стоит выше в выдаче, несмотря на более слабые тексты. Техническая производительность стала прямым ранжирующим фактором — и разрыв между «приемлемо» и «быстро» стоит позиций. Мы решали эту проблему для десятков проектов — от интернет-магазинов до SaaS-платформ — и знаем, какие ошибки съедают ранжирование.

Core Web Vitals: что реально влияет на позиции

Google использует три метрики как сигналы ранжирования (Page Experience): LCP (Largest Contentful Paint), CLS (Cumulative Layout Shift), INP (Interaction to Next Paint, заменил FID с последнего крупного обновления алгоритма).

LCP: почему 8 секунд — это не проблема изображения

LCP измеряет время отрисовки самого большого видимого элемента страницы. Чаще всего — hero image или H1. Пороги: хорошо < 2.5s, плохо > 4s.

Типичный диагноз на реальном проекте: интернет-магазин одежды, LCP 7.8s на мобильных. Элемент — hero image категории, 4.2MB JPEG без srcset, загружается через CSS background-image (не <img>). Проблема здесь двойная: во-первых, браузер не может preload CSS background images через <link rel="preload"> стандартным способом. Во-вторых, 4.2MB на мобильном соединении — это физически медленно.

Решение по шагам:

1. Переносим hero из CSS background в <img> с fetchpriority="high" и loading="eager"
2. Конвертируем в WebP, добавляем srcset: 800w для мобильных, 1400w для десктопа
3. <link rel="preload" as="image" href="hero-800.webp" media="(max-width: 768px)"> в <head>
4. Убираем все render-blocking скрипты выше hero через defer

Итог: LCP 7.8s → 1.9s. Без смены хостинга, без CDN.

Если LCP — не изображение, а текстовый блок: проблема может быть в TTFB (медленный сервер), в render-blocking CSS/JS, или в web fonts с font-display: block.

CLS: смещения, которые раздражают пользователя и Google

CLS измеряет суммарный сдвиг элементов в процессе загрузки. Пороги: хорошо < 0.1, плохо > 0.25. CLS 0.35 — это баннер, который появляется через секунду и сдвигает всё содержимое страницы вниз.

Источники CLS:

• Изображения без заданных размеров. <img src="photo.jpg"> без width и height — браузер не резервирует место, контент прыгает при загрузке. Фикс: явные width/height или aspect-ratio в CSS.
• Рекламные блоки и виджеты. Google Ads, чат-виджеты, cookie consent — всё, что появляется после основного контента. Решение: резервировать место через min-height или загружать до рендера основного контента.
• Web fonts. FOUT (Flash of Unstyled Text) и FOIT (Flash of Invisible Text) могут вызывать переформатирование. font-display: swap с size-adjust (CSS свойство для выравнивания размеров fallback шрифта) минимизирует CLS.
• Динамический контент. Если блок появляется после загрузки (fetch данных, lazy load) — добавляем skeleton placeholder с нужными размерами.

INP: почему интерфейс «зависает» на 500ms

INP измеряет задержку ответа на любое взаимодействие пользователя: клик, тап, ввод. Пороги: хорошо < 200ms, плохо > 500ms. INP 680ms — это когда пользователь нажимает кнопку фильтра, а ничего не происходит полсекунды.

Главная причина высокого INP — заблокированный main thread. JavaScript-бандл 2.1MB парсируется и выполняется синхронно. Пока выполняется, пользовательские события не обрабатываются.

Диагностика через Chrome DevTools → Performance → взаимодействие с подозрительной задержкой → найти Long Tasks (> 50ms). Типичные виновники:

• Непрерывная обработка большого списка без requestIdleCallback или requestAnimationFrame
• Тяжёлые event listeners без debounce/throttle
• Синхронный setState в React, который триггерит полный ре-рендер сложного дерева компонентов
• Third-party scripts: livechat, аналитика, виджеты — они исполняются в том же main thread

Решения: code splitting через динамический import(), перенос тяжёлых вычислений в Web Workers, React.memo + useMemo для предотвращения лишних ре-рендеров, scheduler API для приоритизации задач.

Schema.org: разметка, которую читают роботы

Структурированные данные через JSON-LD — не прямой ранжирующий фактор, но дают rich snippets в выдаче (звёзды рейтингов, цены, дата публикации), что увеличивает CTR на 20–30%.

Типы разметки по сценариям:

• E-commerce: Product с offers (цена, наличие, валюта), aggregateRating (рейтинг из отзывов), brand. BreadcrumbList для навигации. ItemList для страниц категорий.
• Статьи и блог: Article или BlogPosting с author, datePublished, dateModified, image. Organization и WebSite на главной странице — помогают Google связать сайт с брендом.
• Локальный бизнес: LocalBusiness с address, telephone, openingHours, geo. Критично для локального SEO.
• FAQ: FAQPage с mainEntity — вопросы и ответы могут появляться прямо в выдаче как раскрывающийся блок.

Валидация: Google Rich Results Test и Schema Markup Validator. Частая ошибка — указать price без priceCurrency, или ratingValue без reviewCount. Google игнорирует неполную разметку.

Как проводить технический SEO-аудит

Сканируемость. robots.txt блокирует нужные страницы (или наоборот, не блокирует служебные). Canonical URLs настроены неправильно — дублируются страницы с UTM-метками. Sitemap содержит страницы с noindex. Всё это Screaming Frog или Sitebulb покажут за час сканирования.

Core Web Vitals в масштабе. Google Search Console → Core Web Vitals → смотрим не отдельные страницы, а группы URL (шаблон страницы продукта, шаблон категории, блог). Проблема обычно системная — одна ошибка в шаблоне портит сотни страниц.

JavaScript SEO. Google рендерит JavaScript, но с задержкой (иногда дни для полного рендера). Для критичного контента — SSR или SSG обязательны. Проверяем через Search Console → Inspect URL → View Crawled Page: что видит Googlebot.

Internal linking. Орфанные страницы (нет входящих внутренних ссылок) теряют PageRank. Битые ссылки (404) — сигнал качества.

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

• Документация: отчёт с найденными проблемами, roadmap по приоритетам, тайминги для каждого этапа.
• Доступы: настройка мониторинга (SpeedCurve, Sentry Search Console), передача dashboard.
• Обучение: разбор типичных ошибок для вашей команды (1–2 созвона).
• Поддержка: сопровождение в течение месяца после деплоя — проверка метрик, фикс регрессий.

Свяжитесь с нами — мы оценим ваш проект за 2 дня и покажем, сколько позиций можно вернуть за счёт технического SEO. Опыт работы с проектами уровня сотен тысяч посещений в месяц — гарантируем измеримый результат в Core Web Vitals до/после. Закажите аудит в этой форме — получите персональный чек-лист из 15 пунктов.