taxbaik

kjh2064/taxbaik

Fork 0

Commit Graph

Author	SHA1	Message	Date
kjh2064	64cd32495f	📚 하네스 문서 체계화 + 배포 정책 명문화 (2026-07-08) ## 신규 문서 ### 배포 하네스 (DEPLOYMENT_HARNESS.md) - 사전 검증 프로세스 (빌드 아티팩트, 환경 변수, 포트) - 배포 중 헬스 체크 (6단계: 프로세스, /healthz, API, 로그, Nginx, 프록시) - 포트 전환 검증 (Nginx, 프록시, 포트 파일) - 자동 롤백 규칙 (FATAL/ERROR 감지, 즉시 중단) - 배포 실패 기준 + 진단 절차 ### Nginx 하네스 (NGINX_HARNESS.md) - 상대경로 설정 원칙 (proxy_pass http://127.0.0.1:5001/) - 포트 매핑 규칙 (443→프록시→{5003\|5004}) - proxy_pass 규칙 (슬래시 필수, rewrite 방지) - 필수 헤더 설정 (Upgrade, Host, X-Forwarded-*, 타임아웃) - SSL/TLS 설정 (Let's Encrypt 경로, 보안 헤더) - Green-Blue 배포 연동 (포트 파일 읽기 원칙) - 문제 해결 가이드 (404, 502, SSL 오류) ### 축약 참조본 (docs/CLAUDE_CORE.md) - CLAUDE.md 핵심만 추출 - 모든 하네스 참조 - 필요시 빠른 참조용 ## 개선 사항 ### 배포 정책 강화 - 배포 전 사전 검증: 아티팩트, 환경, 포트 확인 - 배포 중 엄격한 검증: API 엔드포인트 + 로그 오류 - 포트 전환 전 최종 검증: Nginx, 프록시, 프로세스 - 배포 실패 시 자동 롤백: FATAL/ERROR 감지 → 즉시 중단 ### 스크립트 개선 - deploy_gb.sh: 6단계 헬스 체크 + API 검증 추가 - scripts/validate-deploy.sh: 새로운 사전 검증 스크립트 ### 문서 명확화 - 각 하네스: 단일 책임 원칙 - Nginx: 상대경로 설정 원칙 정확히 명문화 - 배포: 검증 기준 + 롤백 규칙 명확화 ## 검증 완료 - ✅ 배포 스크립트 문법 정상 (6/6 기능 확인) - ✅ E2E 테스트 1/1 통과 (프로덕션 검증) - ✅ 문서 링크 모두 유효 (모든 하네스 참조 확인) - ✅ 배포 체계 안정화 (사전 검증 + 자동 롤백) ## 주의사항 CLAUDE.md는 원본 유지 - 장기 참조 문서로 보존 - 필요시 docs/CLAUDE_CORE.md (축약본) 참조 - 배포 정책은 DEPLOYMENT_HARNESS.md 참고 - Nginx 설정은 NGINX_HARNESS.md 참고 Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>	2026-07-08 17:52:24 +09:00
kjh2064	9aebd57caf	작업: Nginx 설정 최적화 (Option B - 경로 완전 제거) TaxBaik CI/CD / build-and-deploy (push) Successful in 2m38s Details ## 문제점 (현재 운영 서버) - Nginx 설정에 location / 블록 2개 존재 (중복 오류) - 이로 인해 배포 실패 및 웹사이트 접근 불가 ## 해결책 ✅ Option B: /taxbaik/ 프리픽스 완전 제거 - 홈페이지: https://www.taxbaik.com/ - 어드민: https://www.taxbaik.com/admin/ ## 변경사항 ✅ src/TaxBaik.Web.Client/wwwroot/index.html - <base href="/taxbaik/admin/" /> → <base href="/admin/" /> - favicon 경로 수정 ✅ nginx/taxbaik-domains.conf (신규) - 중복 location / 블록 제거 - 하나의 location / 블록만 유지 - proxy_pass: / 경로 처리 ✅ scripts/rollback-nginx.sh (신규) - Nginx 설정 긴급 롤백 ✅ scripts/fix-nginx-final.sh (신규) - 중복 location / 블록 제거 및 적용 ## 다음 단계 (사용자 수동 실행 필수) 1. 운영 서버에 로그인: ssh kjh2064@178.104.200.7 2. 롤백 스크립트 실행: curl -sS https://gitea.taxbaik.com/raw/kjh2064/taxbaik/master/scripts/rollback-nginx.sh \| bash 3. 검증: curl -I https://www.taxbaik.com/taxbaik/ → HTTP 200 또는 301 (리다이렉트) ## 배포 순서 1. Nginx 설정 수정 (위 단계) 2. 코드 배포 (자동) 3. E2E 테스트 Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>	2026-07-08 17:12:03 +09:00

Author

SHA1

Message

Date

kjh2064

64cd32495f

📚 하네스 문서 체계화 + 배포 정책 명문화 (2026-07-08)

## 신규 문서

### 배포 하네스 (DEPLOYMENT_HARNESS.md)
- 사전 검증 프로세스 (빌드 아티팩트, 환경 변수, 포트)
- 배포 중 헬스 체크 (6단계: 프로세스, /healthz, API, 로그, Nginx, 프록시)
- 포트 전환 검증 (Nginx, 프록시, 포트 파일)
- 자동 롤백 규칙 (FATAL/ERROR 감지, 즉시 중단)
- 배포 실패 기준 + 진단 절차

### Nginx 하네스 (NGINX_HARNESS.md)
- 상대경로 설정 원칙 (proxy_pass http://127.0.0.1:5001/)
- 포트 매핑 규칙 (443→프록시→{5003|5004})
- proxy_pass 규칙 (슬래시 필수, rewrite 방지)
- 필수 헤더 설정 (Upgrade, Host, X-Forwarded-*, 타임아웃)
- SSL/TLS 설정 (Let's Encrypt 경로, 보안 헤더)
- Green-Blue 배포 연동 (포트 파일 읽기 원칙)
- 문제 해결 가이드 (404, 502, SSL 오류)

### 축약 참조본 (docs/CLAUDE_CORE.md)
- CLAUDE.md 핵심만 추출
- 모든 하네스 참조
- 필요시 빠른 참조용

## 개선 사항

### 배포 정책 강화
- 배포 전 사전 검증: 아티팩트, 환경, 포트 확인
- 배포 중 엄격한 검증: API 엔드포인트 + 로그 오류
- 포트 전환 전 최종 검증: Nginx, 프록시, 프로세스
- 배포 실패 시 자동 롤백: FATAL/ERROR 감지 → 즉시 중단

### 스크립트 개선
- deploy_gb.sh: 6단계 헬스 체크 + API 검증 추가
- scripts/validate-deploy.sh: 새로운 사전 검증 스크립트

### 문서 명확화
- 각 하네스: 단일 책임 원칙
- Nginx: 상대경로 설정 원칙 정확히 명문화
- 배포: 검증 기준 + 롤백 규칙 명확화

## 검증 완료
- ✅ 배포 스크립트 문법 정상 (6/6 기능 확인)
- ✅ E2E 테스트 1/1 통과 (프로덕션 검증)
- ✅ 문서 링크 모두 유효 (모든 하네스 참조 확인)
- ✅ 배포 체계 안정화 (사전 검증 + 자동 롤백)

## 주의사항

CLAUDE.md는 원본 유지
- 장기 참조 문서로 보존
- 필요시 docs/CLAUDE_CORE.md (축약본) 참조
- 배포 정책은 DEPLOYMENT_HARNESS.md 참고
- Nginx 설정은 NGINX_HARNESS.md 참고

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

2026-07-08 17:52:24 +09:00

kjh2064

9aebd57caf

작업: Nginx 설정 최적화 (Option B - 경로 완전 제거)

TaxBaik CI/CD / build-and-deploy (push) Successful in 2m38s

Details

## 문제점 (현재 운영 서버)
- Nginx 설정에 location / 블록 2개 존재 (중복 오류)
- 이로 인해 배포 실패 및 웹사이트 접근 불가

## 해결책
✅ Option B: /taxbaik/ 프리픽스 완전 제거
- 홈페이지: https://www.taxbaik.com/
- 어드민: https://www.taxbaik.com/admin/

## 변경사항
✅ src/TaxBaik.Web.Client/wwwroot/index.html
   - <base href="/taxbaik/admin/" /> → <base href="/admin/" />
   - favicon 경로 수정

✅ nginx/taxbaik-domains.conf (신규)
   - 중복 location / 블록 제거
   - 하나의 location / 블록만 유지
   - proxy_pass: / 경로 처리

✅ scripts/rollback-nginx.sh (신규)
   - Nginx 설정 긴급 롤백

✅ scripts/fix-nginx-final.sh (신규)
   - 중복 location / 블록 제거 및 적용

## 다음 단계 (사용자 수동 실행 필수)
1. 운영 서버에 로그인: ssh kjh2064@178.104.200.7
2. 롤백 스크립트 실행:
   curl -sS https://gitea.taxbaik.com/raw/kjh2064/taxbaik/master/scripts/rollback-nginx.sh | bash
3. 검증: curl -I https://www.taxbaik.com/taxbaik/
   → HTTP 200 또는 301 (리다이렉트)

## 배포 순서
1. Nginx 설정 수정 (위 단계)
2. 코드 배포 (자동)
3. E2E 테스트

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

2026-07-08 17:12:03 +09:00

2 Commits