[#eGovFrame] XX. 프로젝트 버전 관리 및 GitHub 연동 가이드

 

🤔 왜 Git을 사용해야 할까요?

우선 지금 개발하고 있는 환경은 맥북 m2 air입니다. 하지만 저는 윈도우 데스크탑을 함께 쓰고 특히 장시간 개발을 진행할 경우에는 window를 중심으로 사용합니다. 그래서 일일이 프로젝트를 export해서 가지고 다니는 것 보다 git을 활용하는 것이 더 효율적입니다.

하지만 로컬에서 혼자 개발을 진행하더라도 Git은 반드시 필요합니다.

• 버전 관리: 코드 수정 이력을 저장하여 언제든 이전 상태로 복구 가능
• 협업 대비: 다수의 작업자가 동시에 작업할 때 발생하는 충돌 방지 및 관리
• 백업 및 공유: 로컬 환경의 문제를 대비해 온라인 원격 저장소에 안전하게 저장

---

1단계: 로컬 Git 저장소 생성 (Share Project)

프로젝트를 Git 관리 대상으로 지정하는 첫 단계입니다.

1. Project Explorer에서 프로젝트 우클릭 > Team > Share Project... 선택
2. Git 선택 후 Next
3. Use or create repository in parent folder... 체크 또는 Create... 버튼으로 새 저장소 생성
4. Finish 클릭 시 프로젝트 아이콘 옆에 [?] 표시가 생기며 관리 대상이 됩니다.

00. Project Explorer에서 프로젝트 우클릭 > Team > Share Project... 선택

 

01. Git 선택 후 Next

02. Use or create repository in parent folder... 체크 또는 Create... 버튼으로 새 저장소 생성

02-1. Use or create repository in parent folder 체크

2단계: 변경 사항 커밋 (Staging & Commit)

수정된 코드를 로컬 저장소에 스냅샷 형태로 저장하는 단계입니다.

1. 프로젝트 우클릭 > Team > Add to Index 클릭 (아이콘이 * 또는 +로 변경됨)
2. 다시 우클릭 > Team > Commit... 선택
3. Git Staging 뷰에서 파일들을 Staged Changes 영역으로 드래그
4. Commit Message 작성 (예: "Initial commit") 후 Commit 버튼 클릭

03. 프로젝트 우클릭 > Team > Add to Index 클릭 (아이콘이 * 또는 +로 변경됨)

 

04. 다시 우클릭 > Team > Commit... 선택

 

05. Git Staging 뷰 구조

---

⚠️ 중요: GitHub 토큰(PAT) 발급받기

GitHub은 보안을 위해 비밀번호 대신 Personal Access Token 사용을 의무화하고 있습니다.

1. GitHub 웹사이트 접속 > Settings > Developer settings
2. Personal access tokens > Tokens (classic) 선택
3. Generate new token (classic) 클릭
4. Note 작성 및 Expiration 설정 후, repo 항목 권한 체크
5. 생성된 토큰(ghp_...)을 반드시 따로 복사해두세요! (재확인 불가)

06. GitHub 웹사이트 접속 > Settings > Developer settings

07. Personal access tokens > Tokens (classic) 선택

08. Personal access tokens > Tokens (classic) 선택

09. Note 작성 및 Expiration 설정 후, repo 항목 권한 체크

10. 토큰 생성완료

3단계: 원격 저장소 연결 및 Push

로컬의 내용을 GitHub 온라인 서버로 업로드합니다.

1. GitHub에서 생성한 저장소의 URL(.git)을 복사
2. 이클립스 프로젝트 우클릭 > Team > Push Branch 'master'... 선택
3. URI란에 복사한 주소 붙여넣기
4. Authentication:
   • User: GitHub 계정명 입력
   • Password: 복사해둔 토큰(ghp_...) 붙여넣기
5. Store in Secure Store 체크 후 Next 및 Finish 진행

11. 이클립스 프로젝트 우클릭 > Team > Push Branch 'master'... 선택

 

12. git repository 및 계정 정보 입력

 

13. 연동정보 확인

14. 연동 진행

 

15. 연동 확인

 

이렇게 Git을 연동해봤습니다. 이런 환경을 구성해놓으면 협업, 환경변경, 버전관리등 다양한 이점이 있습니다.

다음에는 본격적으로 전자정부프레임워크에 대한 테스트를 진행하겠습니다.