VS Code 로 GitHub 연동 및 자동 배포 시스템 구축

작성일: 2026-03-20

목적: 로컬 코드를 GitHub에 안전하게 보관하고, 인증 에러 발생 시 우회하여 배포를 완수함.

1. 환경 설정 (최초 1회)

Git의 커밋 기록을 위한 사용자 식별 정보를 등록한다.

1) git config --global user.email "이메일"

2) git config --global user.name "이름"

2. 로컬 저장소 초기화 및 커밋

작업 내역을 로컬 데이터베이스에 기록한다.

1) git init (저장소 초기화)

2) git add . (변경 사항 스테이징)

3) git commit -m "메시지" (기록 확정)

3. 원격 저장소 연결 및 표준화

GitHub와 연결하고 브랜치 명칭을 글로벌 표준인 main으로 통일한다.

1) git remote add origin https://github.com/... <-- GitHub에서 복사해오기

2) git branch -M main (기본 브랜치 명칭 변경 : 강력추천 - 추후 충돌 방지)

4. 장애 발생 및 대응 (Troubleshooting)

터미널에서 git push 시 인증 단계에서 무한 대기(먹통) 현상이 발생할 경우의 대응책이다.

원인: Git Credential Manager의 팝업 창이 백그라운드에서 고립되거나 통신 지연 발생.

해결: VS Code 내장 GUI 기능을 이용해 인증 세션을 강제 연결한다.

VS Code 좌측 [Source Control] 탭 진입.

[Publish Branch] 또는 [Sync Changes] 버튼 클릭.

상단 알림창에서 [Allow] 선택 후 브라우저 인증 승인.

인증 완료 후 VS Code로 복귀하여 동기화 확인.

5. 최초 전송 및 운영 루틴

설정 완료 후 아래 3단계 명령으로 배포를 완료한다.

[중요 : 최초 전송]

git push -u origin main

[일상 배포]

1) git add .

2) git commit -m "변경한 내용"

3) git push