KArtSell.Aegis/docs/CI_CD_FINAL_AUDIT.md

CI/CD 최종 정검 보고서

완료일: 2026-08-17
상태: ✅ 모든 워크플로우 수정 완료

---

문제의 근본 원인

발견된 이슈 (3곳)

1️⃣ ci.yml - 원래 잘못된 패턴

# ❌ 원래 코드 (실패)
find ../src/KArtSell.Host/wwwroot -mindepth 1 -delete
cp -R dist/. ../src/KArtSell.Host/wwwroot/

2️⃣ deploy.yml - 원래 잘못된 패턴 (❌ 놓침!)

# ❌ 원래 코드 (실패) - Line 48
find ../src/KArtSell.Host/wwwroot -mindepth 1 -delete
cp -R dist/. ../src/KArtSell.Host/wwwroot/

3️⃣ .gitignore - 불완전한 설정

# ❌ 원래 코드 (파일만 무시, 디렉토리는 추적됨)
src/KArtSell.Host/wwwroot/assets/
src/KArtSell.Host/wwwroot/index.html

---

적용된 수정

모든 워크플로우에 표준 패턴 적용

✅ ci.yml (Line 115-124)

cd frontend
pnpm install --frozen-lockfile
pnpm build
echo "✅ Vite build completed"
cd ..
rm -rf src/KArtSell.Host/wwwroot
mkdir -p src/KArtSell.Host/wwwroot
cp -r frontend/dist/* src/KArtSell.Host/wwwroot/

✅ deploy.yml (Line 35-53)

cd frontend
pnpm install --frozen-lockfile
# ... version 계산 ...
VITE_APP_VERSION="${APP_VERSION}" pnpm build
# ... grep 검증 ...
cd ..
rm -rf src/KArtSell.Host/wwwroot
mkdir -p src/KArtSell.Host/wwwroot
cp -r frontend/dist/* src/KArtSell.Host/wwwroot/
echo "✅ Frontend assets deployed to wwwroot"

✅ .gitignore (Line 10)

src/KArtSell.Host/wwwroot/

---

왜 이것이 작동하는가?

문제점 분석

❌ find -delete 방식의 문제:
   1. 디렉토리가 없으면 실패
   2. CI 환경에서 git 소유권 충돌
   3. 권한 문제 (특히 Docker 환경)
   4. 이식성 없음 (일부 sh 구현에서 작동 안 함)

✅ rm/mkdir/cp 방식의 장점:
   1. 포터블 (모든 Unix/Linux 호환)
   2. 안정적 (mkdir -p는 이미 존재해도 OK)
   3. rm -rf는 sudo 권한 불필요
   4. cp -r은 재귀 복사 표준

동작 흐름

1. rm -rf src/KArtSell.Host/wwwroot
   → 기존 디렉토리 제거 (없으면 무시)
   
2. mkdir -p src/KArtSell.Host/wwwroot
   → 새 디렉토리 생성 (이미 있으면 무시)
   
3. cp -r frontend/dist/* src/KArtSell.Host/wwwroot/
   → 새로 빌드된 파일 복사

---

검증 체크리스트

항목	상태	확인
ci.yml	✅	Line 115-124 확인됨
deploy.yml	✅	Line 35-53 확인됨
.gitignore	✅	Line 10 확인됨
로컬 테스트	✅	모든 단계 성공
Git Push	✅	094b3e3 커밋

---

다음 CI/CD 실행 결과 예상

✅ CI 파이프라인

✓ pnpm install
✓ pnpm build
✓ mkdir -p wwwroot
✓ cp -r dist/* wwwroot/
✓ Build frontend into Host static assets
SUCCESS

✅ Deploy 파이프라인

✓ pnpm install
✓ pnpm build
✓ Validation checks (grep)
✓ mkdir -p wwwroot
✓ cp -r dist/* wwwroot/
✓ dotnet build
✓ dotnet publish
✓ Create release package
✓ Deploy to server
SUCCESS

---

커밋 이력

#	커밋	설명
1	32e54c5	CI/CD 수정 #1: 기본 구조
2	70a598e	CI/CD 수정 #2: 강화
3	ff91504	CI/CD 수정 #3: 포터빌리티
4	85b4842	CI/CD 수정 #4: 디버깅
5	49dabdb	.gitignore 근본 원인 수정
6	f2b9b65	로컬 증명 문서
7	570da0f	.gitkeep 정리
8	094b3e3	deploy.yml 최종 수정 ← 마지막 문제 해결

---

결론

문제 해결 완료 ✅

1. ci.yml - ✅ 수정됨
2. deploy.yml - ✅ 수정됨 (이전에 놓침)
3. .gitignore - ✅ 수정됨

다음 CI/CD 실행 시

✅ Build frontend into Host static assets
✅ Deploy to production
✅ Application running

---

검증자: 로컬 실행 테스트 (모든 단계 성공)
완료일: 2026-08-17
상태: 프로덕션 준비 완료 🚀