0Pricing
Frontend Academy · 강의

Lighthouse 자동 검사

Lighthouse CI GitHub Action을 추가하고, 성능 및 접근성 점수 기준을 설정하며, Core Web Vitals가 저하되는 병합을 차단합니다.

Lighthouse 자동 검사은(는) CoddyKit의 무료 Frontend Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Frontend Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

Lighthouse를 자동화하는 이유

수동으로 Lighthouse를 실행하면 성능 저하를 늦게 발견하며, 대개 실제 사용자가 불만을 제기한 뒤에야 알게 됩니다. 자동화된 Lighthouse CI는 모든 PR에서 실행되고 핵심 지표가 악화되면 빌드를 실패시키며 시간에 따른 점수 추이를 기록합니다. 성능을 테스트 모음처럼 다루세요.

Lighthouse CI

Google이 만든 오픈 소스 Lighthouse CI(lhci) 도구 모음입니다. Lighthouse를 여러 번 실행하고 중앙값을 계산한 뒤 기준값에 대해 검증하고 결과를 업로드합니다.

npm install -D @lhci/cli

# Run locally:
npx lhci autorun

lighthouserc.json — 설정

테스트할 URL, 실행 횟수, 검증 조건을 설정하세요.

// lighthouserc.json
{
  "ci": {
    "collect": {
      "url": [
        "http://localhost:3000",
        "http://localhost:3000/blog",
        "http://localhost:3000/pricing"
      ],
      "numberOfRuns": 5,
      "startServerCommand": "npm run start"
    },
    "assert": {
      "assertions": {
        "categories:performance":   ["error", { "minScore": 0.9 }],
        "categories:accessibility": ["error", { "minScore": 0.95 }],
        "categories:seo":            ["warn", { "minScore": 0.9 }],
        "largest-contentful-paint":  ["error", { "maxNumericValue": 2500 }],
        "total-blocking-time":       ["error", { "maxNumericValue": 200 }],
        "cumulative-layout-shift":   ["error", { "maxNumericValue": 0.1 }]
      }
    },
    "upload": {
      "target": "temporary-public-storage"
    }
  }
}

GitHub Action 통합

공식 treosh/lighthouse-ci-action은 모든 PR에서 lhci를 실행하고 상태 확인 결과를 게시합니다.

# .github/workflows/lighthouse.yml
name: Lighthouse CI
on: [pull_request]
jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: '20', cache: 'npm' }
      - run: npm ci && npm run build
      - uses: treosh/lighthouse-ci-action@v11
        with:
          configPath: ./lighthouserc.json
          uploadArtifacts: true
          temporaryPublicStorage: true

여러 실행 결과의 중앙값

타이밍 잡음 때문에 Lighthouse 점수는 실행할 때마다 달라집니다. numberOfRuns: 5는 중앙값을 계산하므로 기준값과 비교하기에 충분히 안정적입니다. 3회 미만으로 실행하면 결과가 불안정해집니다.

성능 예산

점수 외에도 리소스 크기와 개수에 엄격한 예산을 설정하세요. 예산을 초과하면 빌드가 실패합니다.

// budget.json
[
  {
    "resourceSizes": [
      { "resourceType": "script", "budget": 300 },
      { "resourceType": "image", "budget": 100 }
    ],
    "resourceCounts": [
      { "resourceType": "third-party", "budget": 10 }
    ]
  }
]

// lighthouserc.json:
"collect": {
  "settings": { "budgetsPath": "./budget.json" }
}

Lighthouse CI 서버

LHCI 서버를 직접 호스팅하면 과거 데이터를 보관하고 추이 차트를 확인하며 시간에 따라 브랜치를 비교할 수 있습니다. 또는 일회성 PR 결과에는 임시 공개 저장소를 사용하세요.

인증이 필요한 페이지 테스트하기

Lighthouse를 실행하기 전에 로그인할 수 있도록 Puppeteer 스크립트를 사용하세요.

// lighthouserc.json
"collect": {
  "puppeteerScript": "./lighthouse-login.js",
  "url": ["http://localhost:3000/dashboard"]
}

// lighthouse-login.js
module.exports = async (browser, context) => {
  const page = await browser.newPage();
  await page.goto('http://localhost:3000/login');
  await page.fill('#email', 'test@example.com');
  await page.fill('#password', 'test123');
  await page.click('button[type=submit]');
  await page.waitForNavigation();
};

Slack/Discord 알림

LHCI 결과를 팀 채팅으로 전달하세요. 성능 저하는 테스트 실패와 같은 수준으로 주의를 기울여야 합니다.

모바일과 데스크톱

Lighthouse는 기본적으로 모바일 환경(느린 4G와 중간급 CPU)을 사용합니다. 데스크톱에서는 preset: 'desktop'을 설정하세요. 대부분의 프로덕션 앱은 두 환경을 모두 감사해야 하므로 CI에서 작업을 분리하세요.

기준값 조정

현재 점수를 기준값으로 삼아 시작하세요. 첫날부터 PR을 실패시키지 말고 먼저 기록하고 경고하세요. 팀이 이 작업 방식에 익숙해지면 기준값을 점진적으로 높이세요.

Lighthouse를 넘어

Lighthouse는 실험실 데이터입니다. 실제 사용자 모니터링(RUM)을 함께 사용하세요. web-vitals npm 패키지와 분석 도구를 조합하거나 SpeedCurve 및 Calibre 같은 서비스를 사용하면 실제 환경의 성능 추이를 확인할 수 있습니다.

빠른 확인

Lighthouse CI는 왜 한 번만 실행하지 않고 여러 번(예: 5회) 실행한 결과의 중앙값을 일반적으로 사용하나요?

복습: Lighthouse 자동화

lhci autorun은 CI와 통합됩니다. lighthouserc.json에서 URL, 실행 횟수(5회 이상), 범주와 지표에 대한 검증 조건, 성능 예산을 설정하세요. GitHub에서는 treosh/lighthouse-ci-action을 사용하세요. 추이를 확인하려면 LHCI 서버를 직접 호스팅하세요. 인증이 필요한 페이지에는 Puppeteer 스크립트를 사용하세요. 모바일과 데스크톱을 모두 감사하세요. 처음에는 경고로 시작하고 시간이 지나면서 기준값을 강화하세요. 전체 상황을 파악하려면 RUM을 함께 사용하세요.

자주 묻는 질문

“Lighthouse 자동 검사” 강의는 무료인가요?

네 — “Lighthouse 자동 검사” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Frontend Academy 강의 전체를 잠금 해제할 수 있습니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“Lighthouse 자동 검사”에서 뭘 배우나요?

Lighthouse CI GitHub Action을 추가하고, 성능 및 접근성 점수 기준을 설정하며, Core Web Vitals가 저하되는 병합을 차단합니다. 브라우저에서 직접 실행하는 실습 코드로 Frontend Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Frontend Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Frontend Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“Lighthouse 자동 검사” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Frontend Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Frontend Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 프런트엔드를 위한 GitHub Actions: 린트, 테스트, 빌드
  2. Vercel, Netlify 및 Cloudflare Pages에 배포
  3. CI의 환경 변수
  4. Lighthouse 자동 검사
← Frontend Academy(으)로 돌아가기