remotion-render-pipeline
컴포지션을 전달 가능한 MP4로 변환합니다.
트리거
remotion-composition-builder가ready: true를 보고합니다.- 사용자가 알려진 작업과 함께 "render it" / "ship it"이라고 말합니다.
입력
jobIdcomposition—src/Root.tsx와 일치하는 ID (예:Explainer)outputPath—remotion-studio/output/기준 상대 경로props— 전체 입력 속성 (브랜드 + 스토리보드 + ...)을 JSON 형태로linear—{teamId, projectId}(티켓 라우팅용)
메서드
- 사전 타입 검사 —
cd remotion-studio && npx tsc --noEmit. 오류 발생 시, 오류와 함께remotion-composition-builder로 반환합니다. - 보이스오버 합성 —
render/voiceover.ts가 장면별 MP3를public/audio/{jobId}/scene-N.mp3에 작성합니다(public/아래에 있으므로staticFile()이 해석 가능). 캐시 키는sha1(voiceId|style|text)를 사용합니다.ELEVENLABS_API_KEY가 없으면 건너뜁니다 — 컴포지션은 화면 텍스트만으로 계속 렌더링되어야 합니다. - 렌더링 —
npx tsx render/render.ts --comp={composition} --out={outputPath} --props='{...}' --jobId={jobId}. 600초 시간 초과를 적용하며, 중단/충돌 시 한 번 재시도합니다. - 검증 — 파일 존재 여부, 예상 지속 시간 ±0.5초, 코덱
h264, 해상도가 컴포지션과 일치, 크기 <100MB를 확인합니다. - 전달:
- Supabase 버킷
remotion-renders에 업로드 — 서명된 URL, 90일 보존. app.server.telegram_video.send_telegram_video()(공유 유틸)를 통해 Telegram으로 전송. 파일이 45MB를 초과하면 인라인 업로드 대신 서명된 URL 링크를 전송합니다(Telegram 제한은 50MB).- Linear 티켓을
{teamId}/{projectId}에 생성: 렌더 URL, 소스 개요, BrandConfig 버전(src/brands/{slug}.ts의 git sha), 컴포지션 파일 경로 포함.
- Supabase 버킷
- 상태 — 요약을
.research/renders/{jobId}.json에 작성합니다.
출력
{
"jobId": "ra-nir-explainer-2026-04-28T15-30-00",
"mp4Path": "remotion-studio/output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
"supabaseUrl": "https://<project>.supabase.co/storage/v1/object/sign/remotion-renders/...",
"telegramSent": true,
"linearIssue": "RA-2049",
"validation": { "durationSec": 60.0, "codec": "h264", "resolution": "1920x1080", "sizeMB": 12.4 }
}
경계 조건
tsc --noEmit이 실패한 상태에서 절대 렌더링을 실행하지 마십시오 — 2-5분을 낭비하여 결과가 보장된 불량 출력물이 생성됩니다.- 렌더 검증이 통과하기 전에 소스 PR(컴포지션 + 브랜드 변경)을 절대 자동 병합하지 마십시오.
[DRAFT]가 포함된 렌더를 브랜드 버킷에 절대 업로드하지 마십시오 — 초안은remotion-drafts로 이동합니다.
실패 에스컬레이션
- 시간 초과 / 중단 → 종료, 한 번 재시도 → 두 번째 실패 시
priority: 2로 Linear 티켓을 열고 stderr를 첨부합니다. - 검증 실패 (잘못된 지속 시간 / 코덱) → 예상과의 차이와 함께 Linear
priority: 3티켓을 엽니다. - Telegram 실패 →
.mp4를 첨부 파일로send_telegram_document()로 대체합니다.
재사용
render/render.tsrender/voiceover.tsapp/server/telegram_video.py(공유 유틸)config/harness/projects.json(Linear 팀/프로젝트 확인용)
프로젝트별 API 키
이 스킬은 호출 프로젝트 내부에서 호출됩니다(Synthex, Pi-SEO, RestoreAssist 등 어디서든). 각 프로젝트는 자체 .env / .env.local을 통해 자체 키를 제공합니다. 이 스킬은 Pi-Dev-Ops에서 키를 읽지 않습니다.
렌더링 시 필요하거나 경고되는 환경 변수:
ELEVENLABS_API_KEY— 보이스오버 합성. 없음 = 화면 텍스트만으로 무음 렌더링(경고 로그 출력, 렌더링 계속).TELEGRAM_BOT_TOKEN,TELEGRAM_CHAT_ID— Telegram 전송. 없음 = Telegram 단계 건너뜀(MP4는 여전히 디스크에 저장되며 Supabase가 구성된 경우 업로드됨).SUPABASE_URL,SUPABASE_SERVICE_ROLE_KEY— 서명된 URL 업로드. 없음 = Supabase 단계 건너뜀.LINEAR_API_KEY— 티켓 생성. 없음 = Linear 단계 건너뜀.REMOTION_LICENSE_KEY— Remotion의 공정 소스 라이선스 하에 상업적 렌더링에 필요.
프로젝트 셸에서의 호출 패턴:
cd ~/Pi-CEO/Synthex
source .env.local # 프로젝트 자체 키
cd ~/Pi-Dev-Ops/remotion-studio
npx tsx render/render.ts \
--comp=Explainer \
--out=$OLDPWD/.remotion-renders/synthex-launch.mp4 \
--jobId=synthex-launch-$(date +%s) \
--props='{"brand":"synthex","hookSec":8,"ctaSec":8,"storyboard":[...]}'
또는 세션 생성 시 호출 프로젝트의 환경을 상속받는 Pi-Dev-Ops 오케스트레이터 API를 통해 호출합니다.
출력 규칙: 기본적으로 MP4를 <calling-project>/.remotion-renders/(gitignore 처리됨)에 작성합니다 — 각 프로젝트의 아티팩트를 자체 트리에 보관합니다. --out=...으로 재정의할 수 있습니다.