GitHub 클론 및 푸시 가이드

• 4/29/2025
• 2 minutes to read

GitHub 저장소 생성 및 로컬 클론, README.md 수정 후 푸시하기

이 절차에서는 VisualAcademy/Azunt.DepotManagement 저장소를 사용하여, GitHub에 저장소를 만들고, 로컬에 클론(clone)한 후, README.md 파일을 수정하고 원격 저장소로 다시 푸시(sync)하는 과정을 진행합니다.

1. GitHub 저장소 생성

1. GitHub에 로그인합니다.
2. 새 저장소 만들기(New Repository)로 이동합니다.
3. 아래와 같이 입력합니다:
   • Repository name: Azunt.DepotManagement
   • Description: (선택) Azunt 프로젝트의 Depot 관리 모듈
   • Public/Private: 필요에 따라 선택
   • Initialize this repository with:
     • README.md 체크 (선택) (처음부터 빈 저장소로 만들 경우 체크 해제)
4. Create repository 버튼 클릭

※ 주의: 이미 저장소가 생성되어 있다면 이 과정은 생략합니다.

2. 로컬에 클론(Clone)하기

터미널(CMD, PowerShell, Git Bash 등)이나 VS Code를 열고 다음 명령을 실행합니다.

git clone https://github.com/VisualAcademy/Azunt.DepotManagement.git

명령어 실행 후, Azunt.DepotManagement 폴더가 로컬에 생성됩니다.

cd Azunt.DepotManagement

3. README.md 파일 수정하기

로컬에서 Azunt.DepotManagement/README.md 파일을 편집기로 열어, 내용을 수정하거나 추가합니다.

예를 들어:

# Azunt.DepotManagement

Azunt 프로젝트의 Depot 관리 모듈입니다.

- Entity Framework Core 기반 CRUD
- Dapper, ADO.NET 대체 구현 포함
- Blazor Server 컴포넌트 예제 제공

수정이 끝나면 파일을 저장합니다.

4. 수정 내용을 커밋(Commit)하고 푸시(Push)하기

터미널에서 다음 명령을 실행합니다:

git add README.md
git commit -m "Update README.md"
git push origin main

※ 기본 브랜치가 main이 아닌 경우, master나 다른 브랜치명을 사용해야 합니다.

5. 완료 확인

GitHub 사이트에 접속해 VisualAcademy/Azunt.DepotManagement 저장소의 README.md가 정상적으로 수정되었는지 확인합니다.