배포 분석 · 2026.11.13

Staging · Dev 배포 시간 분석

마지막 업데이트 2026-11-17

관찰된 실행과 코드 기준 · 개선 후보, 미구현

Staging 배포 51분 중 LiveKit dependency 이미지 준비에 약 20분이 걸렸다. 테스트 설정 변경이 dependency 이미지 키를 바꿨고, 해당 키의 이미지가 없어 새로 빌드됐다. 이후 Production에서는 같은 이미지를 재사용했다.

확인한 실행

실행측정된 시간
Staging 배포전체 51분 1초 · dependency 이미지 준비 1,215초 · 웹 빌드 557초 · 웹 배포 531초
Production 배포같은 dependency 이미지 재사용 2초
Dev 배포전체 14분 43초 · 웹/소켓 병렬 빌드 434초 · 인프라 배포 118초 · 준비 확인 111초

각 수치는 개별 실행의 관찰값이다. 병렬 작업과 job 대기 시간이 있어 단순 합산할 수 없으며, 일반적인 소요 시간이나 예상 절감량은 아직 측정하지 않았다.

왜 dependency 이미지를 새로 만들었나

커밋 855bfab9는 response_overlap_guard.py를 pyproject.toml의 mutmut source_paths와 only_mutate에 추가했다. 이는 변이 테스트 대상 등록이며 Python 라이브러리 목록의 변경은 아니다.

배포 액션은 pyproject.toml 전체를 비롯한 추적 파일과 base image digest로 dependency 이미지 키를 만든다. 변경된 키의 이미지가 없으면 새로 빌드한다. 이미지 준비에는 라이브러리 설치, 모델 다운로드, 이미지 빌드와 업로드 등이 포함되며, 각 작업의 개별 시간은 확인하지 않았다.

개선 후보

  1. 테스트 전용 설정 변경의 이미지 키 영향 축소. only_mutate 등 설치와 무관한 설정을 키에서 제외하는 방안을 검토한다. 라이브러리 및 소스 설정, lock 파일, vendor와 base image 변경은 계속 반영해야 한다. 최종 이미지가 최신 프로젝트 파일을 복사한 뒤 uv run으로 실행하므로 동작과 캐시 일관성을 검증해야 한다.
  2. Staging 웹 빌드 병렬화 검토. 현재 웹 job은 LiveKit agent 배포를 기다린다. 웹 이미지 빌드를 먼저 병렬 실행하고 배포 활성화 전에 agent 검증을 유지할 수 있는지 확인한다. 설정 및 배포 순서의 안전성이 전제다.
  3. Dev 웹 빌드 캐시 조사. 웹과 소켓은 이미 병렬 빌드하고 레지스트리 캐시를 사용한다. 웹 Dockerfile의 전체 소스 복사 이후 빌드 단계가 관련 없는 변경으로 무효화될 가능성을 로그로 확인하고 복사 범위를 검토한다.
  4. 배포와 준비 대기 시간 분석. Staging 웹 배포와 Dev 준비 확인의 세부 원인을 측정한다. 헬스 확인과 롤링 배포의 안전 조건을 제거하지 않는다.

근거와 범위

코드 변경이나 성능 실험은 수행하지 않았다. 실제 절감량, 의존성 키 변경의 안전성 및 다른 실행에서의 대표성은 후속 검증이 필요하다.

로컬에서 개선 후보 실험하기

로컬 self-hosted runner로 PPI 빌드 실험하기에 전용 라벨 등록, 빌드 전용 workflow 및 캐시·아키텍처 조건을 맞춘 비교 절차를 정리했다. 이 가이드 추가로 위 분석의 실측 결과나 개선 후보가 구현된 것은 아니다.