docs: CLAUDE.md MNG 운영 브랜치 master→main 통일

This commit is contained in:
김보곤
2026-02-25 15:46:03 +09:00
parent d44b99d5e4
commit 62fdc6869b

View File

@@ -111,7 +111,7 @@ cd /home/aweso/sam/react && git push origin develop
> **전제**: develop의 변경사항이 개발 서버에서 테스트 완료된 상태
1. 각 프로젝트에서 develop에 미푸시 커밋 확인 → 있으면 먼저 `git push origin develop`
2. `git checkout main` (또는 `master` — 프로젝트별 메인 브랜치명 확인)
2. `git checkout main` (모든 프로젝트 운영 브랜치: `main`)
3. `git pull origin main`**최신화 (충돌 방지 핵심 단계)**
4. `git merge develop` — develop 내용을 main에 머지
5. 충돌 발생 시 → 사용자에게 알리고 해결 지원
@@ -128,9 +128,9 @@ git push origin main
git checkout develop && git merge main
cd /home/aweso/sam/mng
git checkout master && git pull origin master && git merge develop
git push origin master
git checkout develop && git merge master
git checkout main && git pull origin main && git merge develop
git push origin main
git checkout develop && git merge main
```
> **중요**: 3번(main 최신화) 없이 머지하면 충돌 발생. 8번(develop 동기화) 없이 작업하면 다음 운영 푸시 시 충돌 누적.
@@ -276,7 +276,7 @@ Claude 역할 Jenkins (자동) 운영 서버
└───────────────────┘ └──────────────────┘ └──────────────┘
```
> **브랜치 전략**: `develop` → 개발 서버 (자동 배포), `main`/`master` → 운영 서버 (PR 머지 + 팀장 승인)
> **브랜치 전략**: `develop` → 개발 서버 (자동 배포), `main` → 운영 서버 (PR 머지 + 팀장 승인)
### 체크리스트 (서버 작업 시)
@@ -566,7 +566,7 @@ docker exec sam-mng-1 php artisan cache:clear
|--------|----------|------------|-------------|
| `feature/*` | — | — | — |
| `develop` | 개발 서버 (`dev.codebridge-x.com`) | **"개발서버 푸시"** | Push 시 자동 |
| `main`/`master` | 운영 서버 (`codebridge-x.com`) | **"운영서버 푸시"** | Push 시 자동 |
| `main` | 운영 서버 (`codebridge-x.com`) | **"운영서버 푸시"** | Push 시 자동 |
```
로컬 작업 → develop push → 개발 서버 테스트 → main merge+push → 운영 서버
@@ -633,7 +633,7 @@ php artisan config:clear
### 운영 서버 배포 (Jenkins 자동화)
> `main`/`master` 브랜치에 PR 머지 시 Jenkins가 자동으로 배포한다.
> `main` 브랜치에 PR 머지 시 Jenkins가 자동으로 배포한다.
> 수동 배포는 **비상 절차**로만 사용한다.
```bash
@@ -658,7 +658,7 @@ sudo supervisorctl restart sam-mng-worker:*
| 작업 | 로컬 (Docker) | 개발 서버 | 운영 서버 |
|------|--------------|----------|----------|
| 배포 방식 | 수동 | Jenkins 자동 (develop push) | Jenkins 자동 (main/master PR) |
| 배포 방식 | 수동 | Jenkins 자동 (develop push) | Jenkins 자동 (main push) |
| git pull | WSL에서 직접 | Jenkins 자동 | Jenkins 자동 |
| composer install | `docker exec sam-api-1 composer install` | Jenkins 자동 | `--no-dev --optimize-autoloader` |
| migrate | `docker exec sam-api-1 php artisan migrate` | Jenkins 자동 | `--force` 플래그 포함 |
@@ -668,7 +668,7 @@ sudo supervisorctl restart sam-mng-worker:*
- [ ] API: `git pull``composer install``php artisan migrate``config:clear`
- [ ] MNG: `git pull``composer install``config:clear` (마이그레이션 없음)
- [ ] 운영 배포: `main`/`master`에 PR 머지 → Jenkins 자동 처리 (수동 금지)
- [ ] 운영 배포: `main`에 PR 머지 → Jenkins 자동 처리 (수동 금지)
---