피드로 돌아가기
Dev.toInfrastructure
원문 읽기
Upstream 기반의 다중 Variant 관리 체계를 통한 Laravel 스타터 킷 동기화 최적화
Contributing to Laravel Maestro Starter Kits Without Losing Your Changes
AI 요약
Context
다양한 프론트엔드 스택(React, Vue, Svelte)과 인증 옵션(Fortify, WorkOS)을 지원하는 스타터 킷의 중복 수정 및 파편화 문제 발생. 단순 수정 시 Downstream 저장소에만 반영되어 Upstream으로의 변경 사항 전파가 불가능한 구조적 한계 존재.
Technical Solution
- kits/ 디렉토리를 Source of Truth로 설정하여 모든 영구적 변경 사항을 중앙 관리하는 아키텍처 설계
- build/ 디렉토리를 일회성 Generated Output으로 정의하여 런타임 검증 및 임시 테스트 환경으로 분리
php artisan build명령어를 통한 Variant Matrix 기반의 동적 애플리케이션 생성 로직 구현- watcher 레이어를 통한 build/에서 kits/로의 변경 사항 역전파 및 동기화 메커니즘 적용
composer kit:run을 통한 Setup, Dev Server, Watcher의 통합 실행으로 개발 사이클 단순화- Variant 전환 시 기존 build/를 완전히 폐기하고 재빌드하는 Stateless 배포 전략 채택
실천 포인트
- 변경 사항 반영 시 'kits/ 수정 → Rebuild → Verify' 순서의 워크플로우 준수 - build/ 디렉토리 내의 diff가 Git Stage에 포함되지 않도록 명시적 파일 추가(`git add`) 수행 - Variant 전환 후 Watcher에 의한 stale 파일 삭제 여부를 확인하여 불필요한 diff 제거 - 단순 UI 텍스트 수정 시 WorkOS보다 검증 비용이 낮은 Fortify variant 우선 검증