Docker 기반 웹 푸시 알림 시스템 - 4.5

소스 형상관리 및 사내 Git 서버(Gitea) 연동

이번 단계에서는 프로젝트 소스 형상관리를 위해 Git을 도입하고,
초기 GitHub 연동 이후 사내 Git 서버(Gitea) 로 이전한 과정을 정리한다.

---

1. Git 도입 배경

Spring Boot 기반 웹 푸시 알림 서버를 개발하면서 다음과 같은 필요성이 있었다.

• 코드 변경 이력 관리
• 기능 단위 버전 관리
• 협업 및 추후 확장 대비
• 회사 내부 정책에 맞는 형상관리 체계 구축

초기에는 사이드 프로젝트 개념으로 GitHub Private Repository로 관리했으나,
추후 내부적으로 활용이 가능할 것으로 판단되어 사내 보안 정책에 따라 내부 Git 서버(Gitea)로 이전하게 되었다.

---

2. gitignore 구성

기존 연동했던 Github에선 IDE 설정 파일, 빌드 산출물, 민감 정보가 Git에 포함되지 않도록 구성했다.

내부 Git 서버로 이관 했을 때도 동일하게 유지했다. (민감 정보는 형상관리를 통해서가 아닌 내부적으로 관리 및 공유)

# IDE
.idea/
*.iml

# Build
.gradle/
build/

# Logs
logs/

# Spring Profile
application-local.properties        #개발 환경 설정
application-prod.properties         #운영 서버 설정

# Env
.env
*.key

---

3. Git 이관 과정

생각보다 매우 간단해서 어이가 없었다..

#기존 Remote 확인
git remote -v

#Gitea 저장소로 Remote 변경
git remote set-url origin http://사내Gitea주소/team/knunotify.git

#Push
git push -u origin main

 

기존 커밋 히스토리를 유지한 상태로 원격 저장소만 사내 Gitea 서버로 변경했다.

---

4. Gitea 사용 이유

Gitea는 경량 Git 서버로 다음과 같은 장점이 있다.

• 자체 서버 운영 가능
• 낮은 리소스 사용량
• 간단한 설치 (Docker 지원)
• GitHub와 유사한 UI
• 내부망 운영 가능

특히 사내 보안 요구사항을 충족하면서도 GitHub와 유사한 사용 경험을 제공한다는 점이 장점이었다.

---

5. 마무리

이번 단계에서 프로젝트는 단순한 코드 저장 수준을 넘어 사내 정책에 맞는 형상관리 체계를 갖추게 되었다.

작게 시작했던 프로젝트가 어딘가에 쓰여진다는 기대감과 무게감으로 더욱 동기부여가 되었다.

---