빌드 프로세스에 성능 예산 통합

성능 예산을 정의했다면 이를 추적할 빌드 프로세스를 설정해야 합니다. 선택한 성능 측정항목의 기준을 정의하고 예산을 초과하면 경고를 표시할 수 있는 여러 도구가 있습니다. 요구사항과 현재 설정에 가장 적합한 방법을 선택하는 방법을 알아보세요. 🕵️ ️

Lighthouse 성능 예산

Lighthouse는 성능, 접근성, 권장사항, 프로그레시브 웹 애플리케이션으로서의 사이트 성능 등 몇 가지 주요 영역에서 사이트를 테스트하는 감사 도구입니다.

Lighthouse의 명령줄 버전 (v5 이상)은 다음을 기반으로 성능 예산 설정을 지원합니다.

  • 리소스 크기
  • 리소스 수

다음 리소스 유형에 대해 예산을 설정할 수 있습니다.

  • document
  • font
  • image
  • media
  • other
  • script
  • stylesheet
  • third-party
  • total

예산은 JSON 파일로 설정되며, 예산을 정의하고 나면 새로운 '예산 초과' 열을 통해 한도 초과 여부를 알 수 있습니다.

Lighthouse 보고서의 예산 섹션
Lighthouse 보고서의 '예산' 섹션

Webpack 성능 힌트

Webpack은 코드가 사용자에게 전달되는 방식을 최적화하는 강력한 빌드 도구입니다. 또한 애셋 크기를 기반으로 실적 예산을 설정할 수 있습니다.

번들 크기가 한도를 초과할 때 명령줄 경고 또는 오류를 받으려면 webpack.config.js에서 성능 힌트를 사용 설정하세요. 개발 과정에서 애셋 크기에 신경을 쓰는 데 적합한 방법입니다.

빌드 단계 후 webpack은 색상으로 구분된 애셋 및 크기 목록을 출력합니다. 예산을 초과하는 항목은 노란색으로 강조표시됩니다.

bundle.js를 강조 표시하는 Webpack 출력
강조 표시된 bundle.js가 예산보다 큽니다.

애셋과 진입점의 기본 한도는 250KB입니다. 구성 파일에서 자체 대상을 설정할 수 있습니다.

Webpack 번들 크기 경고
Webpack 번들 크기 경고 ⚠️

예산은 압축되지 않은 애셋 크기와 비교됩니다. 압축되지 않은 자바스크립트 크기는 실행 시간과 관련이 있습니다. 특히 휴대기기에서 큰 파일은 실행하는 데 시간이 오래 걸릴 수 있습니다.

Webpack 성능 최적화 권장사항
보너스 기능: webpack에서 경고를 표시할 뿐만 아니라 번들 크기를 줄이는 방법에 관한 권장사항을 제공합니다. 💁

번들 크기

Bundlesize는 설정한 기준에 따라 애셋 크기를 테스트하는 간단한 npm 패키지입니다. 로컬에서 실행하고 CI와 통합할 수 있습니다.

번들 크기 CLI

테스트하려는 임곗값과 파일을 지정하여 번들 크기 CLI를 실행합니다.

bundlesize -f "dist/bundle.js" -s 170kB

Bundlesize는 색상으로 구분된 테스트 결과를 한 줄로 출력합니다.

번들 크기 CLI 테스트 실패
실패한 번들 크기 CLI 테스트 ❌
번들 크기의 CLI 테스트 통과
번들 크기 CLI 테스트 통과 ✔️

CI용 번들 크기

pull 요청에 크기 제한을 자동으로 적용하기 위해 CI와 통합하면 bundlesize를 최대한 활용할 수 있습니다. bundlesize 테스트가 실패하면 pull 요청이 병합되지 않습니다. GitHub의 Travis CI, CircleCI, Wercker, Drone에서 pull 요청에 사용할 수 있습니다.

GitHub의 번들 크기 확인 상태
GitHub에서 번들 크기 확인

현재 빠른 앱이 있을 수 있지만 새 코드를 추가하면 종종 속도가 달라질 수 있습니다. bundlesize로 pull 요청을 확인하면 성능 회귀를 방지할 수 있습니다. 부트스트랩, Tinder, Trivago 및 기타 회사에서 예산을 관리하는 데 이 도구를 사용합니다.

bundlesize를 사용하면 각 파일의 기준점을 개별적으로 설정할 수 있습니다. 이는 애플리케이션에서 번들을 분할하는 경우에 특히 유용합니다.

기본적으로 gzip으로 압축된 애셋 크기를 테스트합니다. 압축 옵션을 사용하여 brotli 압축으로 전환하거나 완전히 사용 중지할 수 있습니다.

등대 봇

등대 봇

Lighthouse Bot는 Travis CI와 통합되며 다섯 가지 Lighthouse 감사 카테고리를 기반으로 예산을 적용합니다. 예를 들어 Lighthouse 성능 점수의 예산은 100입니다. 개별 애셋 예산과 Lighthouse 점수에는 여러 요소를 고려하는 것보다 하나의 숫자를 살펴보는 것이 더 간단할 때가 있습니다.

Lighthouse 점수 💯
Lighthouse 점수 💯

사이트를 스테이징 서버에 배포하면 Lighthouse Bot이 감사를 실행합니다. .travis.yml에서 --perf, --a11y, --bp, --seo 또는 --pwa 옵션을 사용하여 특정 Lighthouse 카테고리의 예산을 설정합니다. 90점 이상의 그린존에 머무르는 것을 목표로 하세요.

after_success:
  - ./deploy.sh # Deploy the PR changes to staging server
  - npm run lh -- --perf=96 https://staging.example.com # Run Lighthouse test

GitHub의 pull 요청에 대한 점수가 설정된 임계값에 미치지 못하면 Lighthouse Bot으로 인해 pull 요청이 병합되지 않을 수 있습니다. ⛔

GitHub의 Lighthouse Bot 확인 상태
GitHub에서 Lighthouse 봇 확인 상태

그러면 Lighthouse Bot이 업데이트된 점수로 pull 요청에 댓글을 작성합니다. 이는 코드 변경이 발생할 때 성능에 관한 대화를 장려하는 깔끔한 기능입니다.

Lighthouse Pull 요청 점수 보고
pull 요청에 대한 Lighthouse 점수 보고 💬

낮은 Lighthouse 점수로 인해 pull 요청이 차단된 경우 Lighthouse CLI 또는 Dev Tools를 사용하여 감사를 실행합니다. 병목 현상에 관한 세부정보와 간단한 최적화를 위한 힌트가 포함된 보고서를 생성합니다.

요약

도구 CLI CI 요약
등대 ✔️
  • 리소스 크기 또는 개수를 기준으로 다양한 유형의 리소스 예산을 책정합니다.
웹팩 ✔️
  • 예산은 웹팩에서 생성된 애셋 크기를 기준으로 합니다.
  • 압축되지 않은 크기를 확인합니다.
번들 크기 ✔️ ✔️
  • 예산은 특정 리소스의 크기를 기반으로 합니다.
  • 압축된 크기 또는 압축되지 않은 크기를 확인합니다.
등대 봇 ✔️
  • 예산은 Lighthouse 점수를 기준으로 합니다.