통합관리자 한 명이 Git Bash 터미널에서 a_branch, b_branch, c_branch를 순서대로 새시작에 통합하는 방법을 실제 명령어로 설명하겠습니다.
핵심은 a_branch, b_branch, c_branch를 한 번에 무조건 병합하는 것이 아니라, 새시작에 하나씩 병합하고 각 결과를 검증하는 것입니다. 이 방식이면 어느 단계에서 충돌이나 빌드 오류가 발생했는지 쉽게 추적할 수 있습니다.
가장 권장하는 방법은 통합관리자가 새시작을 최신 상태로 만든 후, A → B → C 순서로 병합하고, 각 단계에서 충돌 해결과 빌드 검증을 수행하는 것입니다.
여기서는 현재 사용 중인 APM Client 저장소와 원격 저장소 origin을 기준으로 하겠습니다.
원격 저장소 URL은 기존 로그에 나온 다음 주소를 예로 사용합니다.
http://10.143.114.112:7443/APMClient/APMKoreaClient.git
실제 origin 주소가 다르다면 아래 명령어를 실행하기 전에 확인해야 합니다.
1. 전체 병합 흐름
2. 1단계 — 저장소와 브랜치 상태 확인
통합관리자의 PC에서 Git Bash를 열고 프로젝트 저장소로 이동합니다.
cd ~/source/APMKoreaClient/APMKoreaClient
현재 위치와 저장소를 확인합니다.
pwd
git rev-parse --show-toplevel
git remote -v
git branch -a
git status
정상적인 상태라면 다음과 같은 원격 브랜치가 보여야 합니다.
remotes/origin/새시작
remotes/origin/a_branch
remotes/origin/b_branch
remotes/origin/c_branch
실제 브랜치명이 정확히 일치하는지 확인하세요. Git 브랜치명은 대소문자와 문자 차이를 구분합니다.
주의: git status에 커밋하지 않은 변경 사항이 표시되면 먼저 처리해야 합니다. 통합관리자가 직접 수정한 파일이 있다면 내용을 확인하고 커밋하거나 안전하게 보관하세요. 다른 사람의 변경 사항을 무조건 버리는 git reset --hard나 git clean은 실행하지 마세요.
3. 2단계 — GitLab의 최신 브랜치 정보 가져오기
이 명령은 원격 브랜치 정보를 갱신합니다. 현재 로컬 소스가 자동으로 바뀌지는 않습니다.
원격 브랜치별 최신 커밋을 확인합니다.
git log -1 --oneline origin/새시작
git log -1 --oneline origin/a_branch
git log -1 --oneline origin/b_branch
git log -1 --oneline origin/c_branch
브랜치별 차이도 확인할 수 있습니다.
git log --oneline --graph --decorate --all -30
이 명령은 각 브랜치의 커밋 관계를 그래프로 보여줍니다.
4. 3단계 — 새시작을 통합 기준으로 준비
먼저 통합관리자가 로컬 새시작 브랜치로 이동합니다.
로컬 브랜치가 아직 없다면 다음 명령을 사용합니다.
git switch --track -c 새시작 origin/새시작
이미 로컬 브랜치가 있는 경우에는 두 번째 명령을 실행하지 않습니다.
이제 원격의 최신 새시작을 반영합니다.
git pull --ff-only origin 새시작
--ff-only는 단순히 앞으로 이동할 수 있을 때만 업데이트하므로, 로컬과 원격의 이력이 갈라져 있으면 임의로 병합하지 않고 중단합니다. 오류가 발생하면 원인을 확인한 뒤 진행하세요.
현재 브랜치를 확인합니다.
git branch --show-current
git status
결과가 새시작이고 작업 트리가 깨끗한 상태여야 합니다.
통합 전 백업 브랜치 생성
기존 통합 기준으로 돌아갈 수 있도록 백업 브랜치를 만듭니다.
git branch backup/새시작-before-integration-20261029
이 명령은 현재 커밋을 가리키는 백업 브랜치를 생성합니다. 이미 같은 이름이 있다면 다른 날짜나 이름을 사용하세요.
5. 4단계 — a_branch를 새시작에 병합
먼저 병합 대상인 A의 최신 커밋을 확인합니다.
git fetch origin
git log --oneline 새시작..origin/a_branch
두 번째 명령은 현재 새시작에는 없고 origin/a_branch에 있는 커밋을 보여줍니다.
이제 병합합니다.
git merge --no-ff origin/a_branch -m "Merge a_branch into 새시작"
--no-ff는 가능하면 병합 커밋을 남겨서 A의 작업이 언제 통합되었는지 추적하기 쉽게 합니다.
병합 결과 확인
git status
git log --oneline --graph --decorate -15
충돌이 없다면 다음을 수행합니다.
-
Visual Studio에서 APM.sln을 엽니다.
-
-
-
이제 GitLab의 새시작에 A의 변경 사항이 반영됩니다.
중요: 병합 후 빌드가 실패했다면 B와 C의 작업을 계속 병합하기 전에 원인을 해결하는 것이 좋습니다.
6. 5단계 — b_branch를 새시작에 병합
A의 병합과 테스트가 완료되었다고 가정합니다.
먼저 최신 원격 정보를 다시 가져옵니다.
B의 작업 내역을 확인합니다.
git log --oneline 새시작..origin/b_branch
B의 변경 사항을 통합합니다.
git merge --no-ff origin/b_branch -m "Merge b_branch into 새시작"
이때 Git은 현재 새시작에 이미 반영된 A의 변경 사항과 B의 변경 사항을 비교합니다.
충돌이 발생하지 않은 경우
git status
git log --oneline --graph --decorate -15
Visual Studio에서 전체 솔루션을 빌드하고 B의 기능을 검증합니다.
정상이라면 Push합니다.
충돌이 발생한 경우
예를 들어 MainForm.cs에서 충돌이 발생했다면 다음과 같이 확인합니다.
결과 예시:
On branch 새시작
You have unmerged paths.
Unmerged paths:
both modified: MainForm.cs
Git은 충돌한 파일의 어떤 코드를 최종적으로 사용해야 하는지 판단할 수 없습니다.
1. 충돌 파일을 직접 수정합니다.
public void LoadData()
{
Console.WriteLine("데이터 조회");
Console.WriteLine("A의 조회 진행률 표시");
Console.WriteLine("B의 조회 오류 로그 기록");
}
위 코드는 두 기능을 모두 유지하는 것이 요구 사항에 맞는 경우의 예시입니다. 실제 코드에서는 기존 함수의 흐름과 변수, 예외 처리, 호출 순서를 검토해야 합니다.
2. 충돌 표시가 남아 있는지 확인합니다.
git diff --check
git diff
충돌 표시인 <<<<<<<, =======, >>>>>>>가 코드에 남아 있지 않은지 확인합니다.
3. 해결한 파일을 스테이징합니다.
충돌한 파일이 여러 개라면 모든 파일을 확인한 후 각각 git add합니다.
4. 병합을 완료합니다.
git status
git commit -m "Merge b_branch into 새시작 - resolve conflicts"
이 명령은 충돌 해결 후 병합 커밋을 생성합니다. 이 시점에 빌드와 기능 테스트를 반드시 수행하세요.
5. 검증에 성공한 경우에만 Push합니다.
다른 파일에서도 충돌이 발생했다면 동일한 방식으로 해결합니다. Git은 충돌이 모두 해결되고 병합이 완료되기 전까지 정상적인 병합 상태로 전환되지 않습니다.
7. 6단계 — c_branch를 새시작에 병합
C도 B와 같은 방식으로 진행합니다. 다만 C를 병합하는 시점에는 A와 B의 변경 사항이 이미 새시작에 반영되어 있어야 합니다.
git fetch origin
git log --oneline 새시작..origin/c_branch
git merge --no-ff origin/c_branch -m "Merge c_branch into 새시작"
충돌이 없다면 다음 순서로 진행합니다.
git status
git log --oneline --graph --decorate -15
전체 솔루션 빌드와 C의 기능을 테스트한 후 Push합니다.
충돌이 발생했다면 B에서 설명한 절차와 같이 충돌 파일을 수정하고 git add, git commit으로 병합을 완료한 다음 테스트하고 Push합니다.
8. 7단계 — 최종 통합 결과 확인
A, B, C 세 브랜치의 병합이 끝났다면 다음 명령으로 최종 상태를 확인합니다.
git status
git branch --show-current
git log --oneline --graph --decorate -20
정상 상태의 기준은 다음과 같습니다.
-
-
작업 트리에 미커밋 변경이나 미해결 충돌이 없습니다.
-
로그에서 A, B, C의 변경 사항과 병합 이력을 확인할 수 있습니다.
-
GitLab의 새시작에 최종 커밋이 Push되어 있습니다.
원격 저장소의 최신 상태도 확인합니다.
git fetch origin
git status -sb
로컬 새시작과 origin/새시작이 동일하다면 일반적으로 다음과 같이 표시됩니다.
마지막으로 Visual Studio에서 APM.sln 전체 빌드와 주요 기능 테스트를 수행합니다.
9. 전체 명령어 모음
아래는 충돌이 발생하지 않고 각 단계의 빌드와 테스트가 성공한 경우의 전체 명령어입니다. 한꺼번에 붙여 넣기보다는 각 단계의 결과를 확인하면서 실행하세요.
# 1. 저장소로 이동
cd ~/source/APMKoreaClient/APMKoreaClient
# 2. 현재 상태 및 원격 저장소 확인
git status
git remote -v
git branch -a
# 3. 최신 원격 정보 가져오기
git fetch origin --prune
# 4. 통합 브랜치로 이동
git switch 새시작
# 5. 최신 통합 브랜치 반영
git pull --ff-only origin 새시작
# 6. 통합 전 백업
git branch backup/새시작-before-integration-20261029
# 7. A 병합
git fetch origin
git merge --no-ff origin/a_branch -m "Merge a_branch into 새시작"
# 빌드 및 테스트 후
git push origin 새시작
# 8. B 병합
git fetch origin
git merge --no-ff origin/b_branch -m "Merge b_branch into 새시작"
# 빌드 및 테스트 후
git push origin 새시작
# 9. C 병합
git fetch origin
git merge --no-ff origin/c_branch -m "Merge c_branch into 새시작"
# 빌드 및 테스트 후
git push origin 새시작
# 10. 최종 확인
git fetch origin
git status -sb
git log --oneline --graph --decorate -20
충돌이 발생하면 해당 git merge 명령이 완료되지 않은 상태에서 다음 브랜치로 넘어가지 말고, 충돌 해결 → 커밋 → 빌드 및 테스트 → Push 순으로 처리해야 합니다.
10. Push가 거부되는 경우
다른 개발자가 통합관리자의 작업 도중 새시작에 커밋을 추가했거나 GitLab에서 직접 변경 사항이 들어오면 Push가 거부될 수 있습니다.
이 경우 무조건 강제 Push하지 마세요.
git fetch origin
git status
로컬과 원격의 이력을 비교한 뒤, 원격에만 있는 변경 사항을 검토합니다. 원격 새시작이 단순히 앞으로 진행된 경우에는 다음과 같이 반영할 수 있습니다.
git merge --ff-only origin/새시작
이 명령이 실패한다면 이력이 갈라진 것이므로 상황을 확인하고 별도로 조정해야 합니다. git push --force로 다른 사람의 커밋을 덮어쓰는 것은 피하세요.
또한 GitLab에서 새시작을 Protected Branch로 설정했다면 직접 Push가 거부될 수 있습니다. 그 경우에는 통합 브랜치에 대한 권한 정책에 따라 Merge Request로 반영해야 합니다.
최종 권장 운영 방식
구분통합관리자 운영 원칙
| 새시작 |
공통 통합 기준으로 유지 |
| a_branch |
A의 작업을 검토 후 병합 |
| b_branch |
A의 병합 이후 변경 사항과 충돌 여부를 검토 |
| c_branch |
A와 B의 병합 이후 변경 사항과 충돌 여부를 검토 |
| 병합 시점 |
한 브랜치씩 병합하고 각 단계에서 검증 |
| 최종 확인 |
전체 솔루션 빌드, 기능 테스트, 원격 Push 확인 |
핵심은 a_branch, b_branch, c_branch를 한 번에 무조건 병합하는 것이 아니라, 새시작에 하나씩 병합하고 각 결과를 검증하는 것입니다. 이 방식이면 어느 단계에서 충돌이나 빌드 오류가 발생했는지 쉽게 추적할 수 있습니다.