2026 OpenClaw 웹 실전:
맥 스토리북 빌드·정적 자산 임계
릴리즈 책임자는 컴포넌트 도감 정적 산출이 배포 전에 비대해지는지 막아야 합니다. 원격 맥에서 빌드·산출 폴더 스캔·임계·경보·지속 통합 사전 검사를 한 줄로 묶는 순서와 표·자주 묻는 질문·로그 위치를 정리합니다. 블로그·도움말·요금·스모크·스크립트 점검을 함께 보세요.
01 정적 산출이 한 번에 부푸는 이유
원격 맥 공유 빌더는 캐시·동시 작업으로 체감이 흔들립니다. 무거운 미디어·다국어 묶음은 정적 자산 총합을 키웁니다. 저장소 루트를 스캔하면 거짓 양성이 납니다. 산출 폴더 고정·확장자별 경고와 실패·요약 로그가 우선입니다.
02 결정 표: 리눅스 지속 통합 대 맥 순찰
리눅스는 속도·맥은 디자인·사파리 인접에 가깝습니다.
| 축 | 리눅스 지속 통합 | 원격 맥 순찰 |
|---|---|---|
| 비용 | 저비용 반복 | 릴리즈 태그 |
| 환경 | 캐시·리전 | 맥 전용 경로 |
| 조합 | 트렁크 1차 | 스테이징 2차 |
03 확장자·지표 임계 표(팀 기준선으로 조정)
팀 기준에 맞게 조정합니다.
| 대상 | 권장 임계 | 메모 |
|---|---|---|
| 폴더 총합 | 십오 퍼센트 경고·삼십 퍼센트 실패 | 안정 태그 기준 |
| 단일 번들 | 팔백 킬로바이트 경고·일 메가 실패 | 지연 로딩 신호 |
| 미디어 | 스토리당 이백 경고·오백 실패 | 객체 저장소 |
| 소스맵 | 운영은 별도 한도·제외 | 보안·용량 |
04 재현 단계 하우투
동결 락파일로 설치하고 도구 버전을 문서와 맞춥니다. 정적 빌드 후 로그의 산출 경로를 적습니다.
pnpm install --frozen-lockfile
pnpm run build-storybook산출 폴더만 대상으로 용량을 봅니다.
du -sh storybook-static확장자별 최댓값과 폴더 총합을 검사하고 위반 상위 목록을 요약합니다. 실패 시 종료 코드와 채널 알림을 연결합니다. 린트·단위 테스트 뒤에 빌드·용량 게이트를 두고 스테이징 전 스모크와 이어집니다.
05 흔한 오류와 로그 위치
메모리 부족. 동시 빌드에 끊기면 작업 로그 종료 코드와 호스트 부하를 봅니다. 경로 불일치. 스캐너 루트와 빌드 출력 경로를 다시 맞춥니다. 설치 불일치. 락 없는 설치는 재현을 깨므로 설치 단계 로그의 버전 인쇄를 확인합니다.
node -v
pnpm -v
du -sh storybook-static단계 로그와 아티팩트 경로를 고정하면 자동 요약이 쉽습니다.
06 자주 묻는 질문
어느 폴더를 스캔하나요
정적 산출 전용 폴더만 봅니다. 루트·캐시를 섞으면 거짓 양성이 납니다.
소스맵을 운영 한도에 넣나요
배포본에서 제외하거나 별도 한도가 일반적입니다.
리눅스만으로 부족한가요
속도는 리눅스가 유리하고 맥은 디자인·맥 전용 경로 순찰에 쓰는 경우가 많습니다.