[C#] sttPlayerAgent Project3

2026.03.26 목요일

로컬 디렉토리와 git 원격 저장소 연동

1. 깃 초기화

2. 추적 파일 관리

3. 프로젝트 추가

 

- 작업은 프로젝트 루트 디렉토리, csproj파일이 있는 곳에서 명령어를 작성하도록 하겠습니다. pwd로 현재 디렉토리를 확인하고, 프로젝트 루트 디렉토리가 아닌 경우, cd로 이동한 뒤 작업하겠습니다.

- 원격 repository를 생성할 때, README.md 파일을 함께 생성한다면 첫 push때 충돌이 일어날 수 있습니다. 그럴 경우, 중간에 pull을 한 번 땡겨주고 첫 push 진행하는 흐름으로 진행해야 합니다.

- 원격 repositoryr가 empty이므로 흐름의 5번은 생략하도록 하겠습니다.

 

0. 사용할 git 명령어 흐름 정리

# 1. 로컬 초기화
git init

# 2. 파일 추가
git add .

# 3. 첫 커밋
git commit -m "Initial commit"

# 4. 원격 저장소 연결
git remote add origin <repo_url>

# 5. 원격 브랜치 가져오면서 병합 (README.md 존재 시)
git pull origin main --allow-unrelated-histories

# 6. 최종 push
git push -u origin main

 

1. git 초기화

- git을 초기화합니다.

git init	# 깃 초기화

 

- git 저장소가 초기화되면 다음과 같은 문구가 터미널에 표시되고, 디렉토리엔 .git 이라는 숨김폴더가 생깁니다. 맥북의 경우, 숨김폴더를 보는 방법은 디렉토리에서 Command+shift+.(마침표) 입니다.

Initialized empty Git repository in /Users/github_kiscezyr48/sttPlayerAgent/.git/

 

2. git ignore 파일 생성 및 작성

- 설정파일과 같이 git이 변경사항을 추적 관리하면 안 되는 파일(또는 폴더)들의 리스트를 작성하기 위해 gitignore파일을 생성합니다. 아래 터미널 명령어 실행 시, 디렉토리에 .gitignore 이라는 숨김파일이 생깁니다.

touch .gitignore	# 변경사항 추적예외 리스트 신규 생성

 

- 추적하지 않을 파일과 폴더 리스트(초기버전)입니다. 이후 프로젝트를 진행하며 늘어날수도 있습니다.

bin/
obj/
.vscode/

 

- vi 편집기로 위 리스트를 작성(Insert), 저장(:wq)합니다. 여기에 적힌 파일과 폴더들은 이후, git add . 등의 명령어를 실행해도 추가되지 않습니다.

.gitignore 파일 작성

2-1. gitignore 파일 작성 전후 비교

- git status 명령어를 사용해서 .gitignore파일 작성 전후의 결과를 비교해 봅니다.

git status

.gitignore 파일 작성 전

.gitignore 파일 작성 후

 

3. 프로젝트 추가

- 위에서 생성한 C# 프로젝트(디렉토리 내 파일들 모두)를 추가합니다.

git add .

프로젝트 git에 추가

4. git에 commit 

- 메시지와 함께 커밋 진행합니다.

git commit -m "firest commit"

commit 수행 완료

 

5. 원격 저장소 연결

- 생성해 둔 git remote repository에 연결

git remote add origin https://github.com/kiscezyr48/sttPlayerAgent.git

 

 

6. 원격 저장소로 푸시

- main branch에 push진행

git push -u origin main

git 원격에 push

github repository