Git 3.0부터 기본 브랜치가 “main”로 바뀌는 이유와 빠른 마이그레이션 가이드

2023년 Git 3.0 릴리스와 함께 “master” 대신 “main”이 기본 브랜치 이름이 되었습니다. 이 변경은 포괄성과 접근성을 높이려는 Git 커뮤니티의 노력의 일환입니다. 하지만 기존 저장소와 CI/CD 파이프라인이 “master”에 의존하고 있다면, 즉시 대응이 필요합니다.

1. 왜 “main”이 기본이 되었을까?

Git 3.0은 포용적 언어를 지향합니다. 2021년 GitHub은 “master”가 인종 차별적 의미를 담을 수 있다는 보고를 받았습니다(원본: GitHub, 2021). 따라서 “main”이 더 중립적이며, 팀과 조직의 다양성 목표와 부합합니다.

실용 팁

• 팀 회의에서 새 브랜치 정책을 발표
• 문서에 “main” 사용을 명시
• 코드 리뷰 시 “main”이 기준인지 확인

2. 기존 저장소를 “main”로 전환하는 3단계

1. 로컬 저장소 업데이트

CODEBLOCK0

1. 리모트 저장소에 푸시

CODEBLOCK1

1. CI/CD 및 외부 링크 교정

– GitHub Actions 워크플로우 파일에서 INLINECODE0 → INLINECODE1 – 외부 문서, 웹훅 URL에 INLINECODE2를 INLINECODE3로 교체

예시

• 프로젝트 A: 2,000 커밋, 10개의 포크가 있는 저장소
• 전환 후 5분 이내에 모든 포크가 자동으로 INLINECODE4을 추적

3. 마이그레이션 후 유지보수 베스트 프랙티스

• 브랜치 보호 규칙을 “main”에 적용
• Pull Request 템플릿에 “main”을 명시
• 버전 관리: INLINECODE5 같은 태그가 자동으로 INLINECODE6에 연결

체크리스트

• [ ] 로컬과 원격 모두 INLINECODE7 사용 확인
• [ ] CI/CD 파이프라인이 정상 동작하는지 테스트
• [ ] 팀원들에게 새 브랜치 명령어 안내
• [ ] 외부 문서와 API 문서 업데이트

결론

Git 3.0의 “main” 기본 브랜치 변경은 포용성을 강화하는 긍정적 변화입니다. 위 3단계 절차를 따라 기존 저장소를 즉시 마이그레이션하고, CI/CD와 문서까지 일괄 업데이트하면 운영 리스크를 최소화할 수 있습니다. 지금 바로 로컬 저장소를 “main”로 바꾸고, 팀에 새 정책을 공유해 보세요.