SpringBoot 프로젝트 Git Bash로 Commit & Push 하는 방법

SpringBoot 프로젝트 Git Bash로 Commit & Push 하는 방법

 

현대 소프트웨어 개발은 속도, 협업 그리고 안정성이 핵심입니다. 특히 Java 생태계에서 압도적인 위치를 차지하고 있는 Spring Boot는 개발자가 비즈니스 로직에 집중할 수 있도록 설정과 배포 과정을 극도로 단순화시켜 줍니다. Spring Boot를 통해 혁신적인 서비스를 빠르게 구축하는 것은 가능해졌지만, 해당 코드를 효과적으로 관리하고, 팀원들과 끊임없이 주고받으며, 변경 이력을 안전하게 보존하는 문제는 여전히 중요한 과제입니다. 

 

이러한 과제를 편리하게 관리할 수 있도록 등장한 도구가 Git입니다. Git은 Linus Torvalds가 개발한 분산 버전 관리 시스템(Distributed Version Control System, DVCS)으로, 프로젝트의 변경 사항을 추적하고, 여러 개발자 간의 협업을 조율하며, 필요할 때 언제든지 이전 상태로 되돌릴 수 있는 '시간 여행' 기능을 제공합니다. Git이 없다면 수 많은 개발자가 동시에 작업하는 대규모 프로젝트는 혼돈에 빠질 수 밖에 없습니다. 

 

 

 

 

 

왜 개발자에게 Git Bash 활용이 중요한가?

 

대부분의 통합 개발 환경(IDE)인 IntelliJ IDEA나 Eclipse 등은 편리한 GUI(Graphic User Interface)기반의 Git 기능을 내장하고 있습니다. 하지만 숙련된 개발자일수록, 그리고 복잡하고 정교한 버전 관리 작업을 수행하도록 CLI(Command Line Interface)기반의 Git Bash 사용은 필수적인 역량이 됩니다.

 

1. 정확한 제어와 깊은 이해
   Git Bash를 사용한다는 것은 개발자가 Git의 내부 동작 원리를 더 깊이 이해하고 있다는 것을 의미합니다. 명령어 하나하나가 Git의 어떤 기능을 직접적으로 호출하는지 알기 때문에, GUI가 제공하지 못하는 미세하고 강력한 제어가 가능해집니다.
   
   
2. 환경 독립성
   GUI 도구는 환경이나 버전에 따라 인터페이스가 달라질 수 있지만, Git Bash에서 사용하는 Git 명령어는 모든 운영체제(Windows, MacOS, Linux)에서 일관되게 작동합니다. 이는 팀 환경이 다양할 때 통일된 작업 방식을 유지하는 데 큰 도움이 됩니다. 
   
   
3. 효율적인 반복 작업
   복잡한 브랜치 전략(Git Flow), 커밋 정제(Rebase), 특정 이력만 가져오기(Cherry-pick) 등의 고급 작업은 CLI 환경에서 훨씬 빠르고 효율적으로 처리할 수 있습니다. 

 

 

 

 

 

Git Bash를 통한 Spring Boot 프로젝트 버전 관리

 

Spring Boot 프로젝트를 Git Bash 환경에서 시작부터 마무리까지 관리하는 가장 기본적인 흐름(최초 설정, 변경 사항 확인 및 스테이징(Staging), 로컬 커밋(Commit), 원격 저장소로의 푸시(Push) 과정)을 상세하게 안내하고자 합니다. 

 

🛠️ Git Bash로 Commit & Push 준비사항

1. Commit을 진행할 SpringBoot 프로젝트를 준비해주세요.
2. Git Repository를 준비해주세요.

 

 

 

 

 

Commit을 진행할 디렉토리 이동

Git Bash를 실행 후, 'cd' 명령어로 Commit을 진행하기 위한 폴더의 위치까지 직접 이동하는 방법 또는 Commit을 진행할 폴더의 위치에서 Git Bash를 실행하는 방법이 있습니다.

 

폴더 위치까지 직접 이동하는 방법

 

1.  Git Bash를 실행 후, 'cd' 명령어로 Commit을 진행할 폴더의 위치까지 이동합니다.

 

필자는 Commit할 폴더 TestProject01이 F 드라이브 이므로 드라이브로 먼저 이동 후, 폴더의 위치로 이동하였습니다.

 

 

Commit을 진행할 폴더 위치에서 Git Bash 실행 방법

 

1.  Commit을 진행할 폴더로 이동 후, 마우스 우클릭 > 'Open Git Bash Here' 메뉴를 눌러 Git Bash를 실행합니다.

 

 

 

 

 

 

Git 사용자 정보 및 초기화 설정

 

🛠️ 사용자 정보 설정 명령어

git config --global user.name "본인의 이름 혹은 닉네임"
git config --global user.email "본인의 이메일 주소"
git config --list

 

1.  ' git config --global user.name 본인의 이름 혹은 닉네임 ' 명령어를 입력해주세요. 

 

 

'git config --global user.name' 명령어는 커밋 기록에 표시할 사용자 이름을 설정합니다. 원하는 이름으로 설정해도 되지만, 원격 저장소 서비스에서 사용하는 이름과 일치 시키는것이 관리하기 편리합니다.

 

 

 

 

 

2.  ' git config --global user.email 본인의 이메일 ' 명령어를 입력해주세요.

 

 

'git config --global user.email' 명령어는 커밋 기록에 표시될 이메일 주소를 설정합니다. 입력한 주소를 기반으로 커밋이 해당 계정에 연결됩니다.

 

 

 

 

3.  ' git config --list ' 명령어를 입력해주세요.

 

 

'git config --list' 명령어는 현재 설정중인 git의 모든 설정을 리스트로 확인할 수 있습니다. 위 1,2번에 설정한 사용자 이름과 이메일이 잘 설정되었는지 list 명령어로 출력된 내용에서 확인할 수 있습니다.

 

‼️ 특정 프로젝트에서만 다른 이름과 이메일 설정을 하고 싶다면?

'--global' 옵션은 모든 프로젝트에서 사용할 전 방위적인 옵션이므로, 특정 프로젝트 폴더로 이동하여 '--global' 옵션을 빼고 위 명령어를 실행하면 해당 로컬 저장소에만 적용되므로 특정 프로젝트에서만 사용할 수 있도록 설정할 수 있습니다.

 

 

 

 

 

4.  ' echo 내용 >> README.md ' 명령어를 입력해주세요.

 

 

'echo {내용} >> README.md' 명령어는 필수 항목은 아닙니다. 해당 repository 설명을 작성하기 위한 파일이라고 생각하면 됩니다. README 파일을 생성하고자 한다면 위 명령어를 통해서 파일을 생성할 수 있습니다.

 

 

'README.md' 파일 작성을위한  명령어를 실행하면 Commit을 진행할 폴더 내, README 파일이 생성된걸 확인할 수 있습니다.

 

 

 

 

 

5.  ' git init ' 명령어를 입력해주세요.

 

 

'git init' 명령어는 버전 관리를 시작하기 위한 가장 첫번째로 실행해야 하는 핵심적인 명령어입니다. 현재 Commit을 진행하기 위한 폴더는 Git 저장소로 활용할 수 없는 일반적인 폴더와 같습니다. 'git init' 명령어를 실행해야만 .git 폴더가 만들어지면서 비로소 Git이 관리할 수 있는 저장소의 폴더로 설정됩니다. 

 

 

명령어를 실행 후, 해당 폴더를 확인해보면 .git 폴더가 생성되어 있는걸 확인할 수 있습니다.

 

 

 

 

 

6.  ' git add README.md ' 명령어를 입력해주세요.

 

 

'git add README.md' 명령어는 README 파일을 Git의 스테이징 영역에 추가하겠다는 의미입니다. 

 

🎈 Git 버전 관리 과정 3단계

1. 작업 디렉토리(Working Directory) : 코드를 수정하는 실제 공간입니다.
2. 스테이징 영역(Staging Area / Index) : 커밋할 변경 사항들을 임시로 모아두는 곳입니다.
3. 로컬 저장소(Local Repository) : 최종적으로 변경 이력(커밋)이 기록되는 곳입니다.

 

'git add' 명령어는 작업 디렉토리에서 파일의 변경 사항을 골라 스테이징 영역으로 올려주는 역할을 합니다. 최초 환경에서 README.md 파일을 만들었기 때문에 수정 사항에 해당됩니다. 그렇기 때문에 다음 커밋에 포함될 준비가 되었다는 뜻이 됩니다. 그래서 'git add' 명령어로 스테이징 영역에 추가합니다.

 

 

 

 

 

7.  ' git commit -m 주석 내용 ' 명령어를 입력해주세요.

 

 

'git commit -m {주석 내용}' 명령어는 로컬 저장소에 변경 이력을 기록(커밋)하면서, 해당 기록에 대한 설명을 함께 넣을 수 있습니다. 큰 따옴표 사이에 들어갈 내용이 기록에 사용된 주석 내용입니다. ' -m ' 옵션은 메세지(Message)를 바로 이어서 작성하겠다는 옵션 설정입니다. 

 

‼️Commit시, 주석 내용이 왜 중요할까?

언제, 누가, 어떤 내용을과 같은 메시지는 자신 또는 팀원들에게 프로젝트의 역사를 이해하는데 가장 중요한 요소가 될것입니다. 오랜 시간이 지난 후 해당 프로젝트를 다시 들여다봤을 때, 무슨 내용인지 모르는 경우 주석을 확인해보면 기억이 나거나 내용을 이해하는데 수월할 것입니다. 그렇기 때문에 Commit 시, 작성하는 메시지는 그만큼의 중요한 의미가 있습니다. 

 

 

 

 

 

8.  ' git branch -M main ' 명령어를 입력해주세요.

 

 

'git branch -M main' 명령어는 브런치 이름을 'master' 에서 'main' 으로 변경하는 역할을 합니다. ' -M ' 옵션은 'move' 또는 'rename'의 의미를 가지고 있습니다. 해당 플래그를 사용하면 현재 브런치의 이름을 뒤에 지정한 이름으로 바꿉니다. 위 명령어를 입력하면 master로 설정되어 있던 브런치명이 main으로 변경된 것을 확인할 수 있습니다.

 

‼️왜 브런치명을 main으로 변경하나요?

소프트웨어 업계 전반에서 포용성(Inclusivity)을 높이기 위한 노력의 일환으로, 'master / slave'와 같은 용어가 연상되는 'master' 대신 'main' 브런치 이름을 기본으로 사용하는 것이 권장되기 시작했습니다. 그래서 GitHub, GitLab 등 주요 Git 호스팅 서비스들이 기본 브런치 이름을 master 대신 main으로 권장하고 표준화하고 있기 때문입니다. 

 

 

 

 

 

9.  ' git remote add origin https://githup.com/JoeHyoenjune/GitPushTest01.git '  명령어를 입력해주세요.

 

 

'git remote add origin {주소}' 명령어는 GitHub에 있는 해당 Repository 주소의 원격 저장소 이름을 'origin' 이라는 별칭(Alias) 또는 이름으로 설정합니다. 'origin' 이라는 이름은 Git에서 '주요 원격 저장소'를 의미하는 관습적인 이름입니다. 이렇게 짧은 이름으로 설정한다면 긴 주소의 repository 를 짧게 사용할 수 있는 편리성을 제공합니다. 

 

 

 

 

 

10.  ' git push -u origin main ' 명령어를 입력해주세요.

 

 

'git push -u origin main' 명령어는 로컬 저장소에 완료된 커밋들을 원격 저장소로 전송하는 역할을 합니다. ' -u ' 옵션은 최초 푸시 시에만 활용하며, 로컬 main 브런치가 원격 저장소의 origin/main 브런치를 추적하도록 설정합니다. 

 

 

 

 

 

11.  명령어를 입력 후, GitHub 로그인창이 나타납니다. 'Sign in with your browser' 버튼을 눌러 로그인을 진행해주세요.

 

 

Git은 로컬 커밋 내용을 원격 저장소로 전송하기 전에, 사용자가 해당 저장소에 코드를 쓸 권한이 있는 사람인지를 확인하기 위해 로그인을 진행할 수 있도록 로그인 window 창을 제공합니다. 권한을 확인할 수 있도록 로그인을 진행합니다.

 

 

 

 

12.  Authorize Git Credential Manager창이 나타납니다. 'Authorize git-ecosystem' 버튼을 눌러 마저 로그인을 진행합니다. 

 

 

 

 

 

 

13.  비밀번호를 입력 후, 로그인을 진행합니다.

 

 

 

비밀번호 입력 후, 로그인에 성공하면 'Authentication Succeeded' 메세지가 출력된 화면을 확인합니다.

 

 

 

 

 

14.  로그인 후, Git Bash로 돌아와보면 원격 저장소로 커밋된 파일들이 Push된걸 확인할 수 있습니다.

 

 

 

 

 

 

15.  Git Repository를 확인해보면, README 파일이 정상적으로 원격저장소로 Push 된걸 확인할 수 있습니다.

 

 

 

 

 

 

변경 사항 스테이징 및 커밋

 

1.  ' git status ' 명령어를 입력해주세요.

 

 

'git status' 명령어는 현재 Git 저장소의 상태를 확인하는 명령어입니다. 버전 관리 작업 흐름에서 현재 어느 위치에서 무엇을 해야하는지를 확인할 수 있는 역할을 합니다. 'On branch main'으로 main 브런치에 있다는걸 확인할 수 있고, 'your branch is up to date with origin/main'으로 푸시해야 할 새로운 커밋이 없음을 의미합니다. 즉, 아직 스테이징 영역에 커밋 하지 않았으니 커밋할게 있다는 뜻이 되는것이죠. 빨간색으로 표시되고 있는 파일들이 커밋해야할 파일들을 나타냅니다.

 

 

 

 

 

2.  ' git add . ' 명령어를 입력해주세요.

 

 

'git add .' 명령어는 현재 폴더의 커밋 해야할 파일들을 스테이징 영역으로 옮기는 명령어입니다. 그래야 스테이징으로 옮겨진 파일들을 커밋할 수 있습니다. 명령어 출력 후 나타나는 warning 메시지는 무시 가능한 메세지로, 사용 OS에 따라서 줄바꿈 처리가 다른데 현재 파일들은 LF 스타일의 줄바꿈을 가지고 있지만 Windows 환경에서 줄 바꿈 충돌을 막기 위해 Git이 파일들 다룰 때 CRLF로 자동 변환되면서 출력하는 메시지입니다. 

 

 

 

 

 

3.  ' git commit -m {주석 내용}' 명령어를 입력해주세요.

 

 

커밋 시, 히스토리를 남겨줄 수 있도록 메시지를 작성합니다.

 

 

 

 

 

4.  ' git push -u origin main ' 명령어를 입력해주세요.

 

 

스테이징 영역에서 커밋을 진행했으니, 원격 저장소로의 push를 진행합니다.

 

 

 

 

 

5.  Push한 Repository를 확인해보면 정상적으로 Push 된 프로젝트 파일을 확인할 수 있습니다.

 

 

 

 

 

 

@Junesker

---