GitHub 초보자를 위한 저장소 만들기 단계별 안내

GitHub 저장소란 무엇입니까

GitHub 저장소는 소프트웨어 프로젝트의 모든 파일과 변경 이력을 관리하는 공간입니다. 저장소에는 소스 코드, 문서, 설정 파일, 이슈, 풀 리퀘스트 등이 포함됩니다. 저장소를 공개하면 누구나 볼 수 있지만 비공개로 설정하면 지정한 사용자만 접근할 수 있습니다. GitHub는 Git 버전 관리 시스템을 기반으로 하며 저장소는 로컬 컴퓨터와 클라우드에 동시에 보관됩니다.

GitHub 저장소의 주요 특징은 다음과 같습니다.

버전 관리: 파일 변경 내역을 기록하고 필요 시 이전 상태로 되돌릴 수 있습니다.
협업: 여러 개발자가 동시에 작업하고 풀 리퀘스트를 통해 코드 리뷰를 진행합니다.
이슈 트래커: 버그, 기능 요청, 작업 일정을 관리합니다.
GitHub Actions: 자동화된 빌드, 테스트, 배포 워크플로를 설정합니다.

준비물과 필수 조건

GitHub 저장소를 만들기 전에 다음 항목을 준비합니다.

GitHub 계정: github.com에 접속하여 회원가입 후 로그인합니다.
Git 설치: 로컬 컴퓨터에서 Git 명령을 사용하려면 git-scm.com에서 Git을 설치합니다. GitHub Desktop을 사용한다면 Git 설치가 필요 없습니다.
인터넷 연결: 저장소 생성과 동기화에 인터넷이 필요합니다.

GitHub 계정은 무료 플랜과 유료 플랜으로 나뉩니다. 무료 플랜은 공개 저장소와 비공개 저장소 각각 월 1,000분까지의 GitHub Actions 사용 시간이 제공됩니다. 유료 플랜은 더 많은 리소스를 사용할 수 있습니다.

저장소 생성 방법: 웹 인터페이스 사용

웹 인터페이스를 사용하여 GitHub 저장소를 만드는 단계는 다음과 같습니다.

GitHub에 로그인합니다.
오른쪽 상단에 있는 ‘+’ 버튼을 클릭한 후 ‘New repository’를 선택합니다.
저장소 생성 화면에서 다음 항목을 입력합니다.
- Repository name: 저장소 이름을 영문 소문자, 숫자, 하이픈(-), 언더스코어(_)로 입력합니다. 예: my-first-repo
- Description: 저장소 설명을 작성합니다(선택 사항).
- Public/Private: 저장소를 공개 또는 비공개로 설정합니다.
- Initialize this repository with a README: README 파일을 자동으로 생성하려면 체크합니다.
- Add .gitignore: 특정 파일이나 디렉터리를 무시하려면 .gitignore 파일을 추가합니다(선택 사항).
- Choose a license: 프로젝트에 사용할 라이선스를 선택합니다(선택 사항).
‘Create repository’를 클릭합니다.
저장소가 생성되면 저장소 페이지로 이동합니다. README 파일이 포함된 경우 README.md 파일이 표시됩니다.

저장소 생성 방법: GitHub Desktop 사용

GitHub Desktop은 그래픽 인터페이스를 제공하여 Git 명령을 몰라도 저장소를 만들고 관리할 수 있습니다. GitHub Desktop을 사용하여 저장소를 만드는 단계는 다음과 같습니다.

GitHub Desktop 다운로드 페이지에서 운영 체제에 맞는 설치 파일을 다운로드합니다.
설치 파일을 실행하여 GitHub Desktop을 설치합니다.
GitHub Desktop을 실행하고 GitHub 계정으로 로그인합니다.
‘File’ 메뉴에서 ‘New Repository’를 선택합니다.
저장소 생성 창에서 다음 항목을 입력합니다.
- Name: 저장소 이름을 입력합니다. 예: my-first-repo-desktop
- Description: 저장소 설명을 작성합니다(선택 사항).
- Local path: 저장소를 저장할 로컬 경로를 선택합니다.
- Visibility: 공개 또는 비공개로 설정합니다.
- Initialize repository with README: README 파일을 자동으로 생성하려면 체크합니다.
‘Create Repository’를 클릭합니다.
저장소가 생성되고 로컬 폴더가 생성됩니다. GitHub Desktop의 ‘Repository’ 탭에서 저장소 상태를 확인할 수 있습니다.

로컬 저장소와 GitHub 저장소 연결하기

로컬 컴퓨터에서 작업한 프로젝트를 GitHub 저장소와 연결하려면 다음 단계를 따릅니다. 이 과정은 Git 명령을 사용하거나 GitHub Desktop을 사용할 수 있습니다.

Git 명령을 사용하여 연결하기

로컬 프로젝트 폴더로 이동합니다.
터미널 또는 명령 프롬프트에서 다음 명령을 실행하여 Git 저장소를 초기화합니다.
```
git init
```
원격 저장소 URL을 복사합니다. GitHub 저장소 페이지에서 ‘Code’ 버튼을 클릭한 후 ‘HTTPS’ 또는 ‘SSH’를 선택하고 URL을 복사합니다.
로컬 저장소를 원격 저장소와 연결합니다.
```
git remote add origin [원격 저장소 URL]
```
예: git remote add origin https://github.com/username/my-first-repo.git

로컬 변경 사항을 커밋합니다.

git add .
git commit -m "Initial commit"

변경 사항을 원격 저장소로 푸시합니다.
```
git push -u origin main
```

GitHub Desktop을 사용하여 연결하기

GitHub Desktop에서 ‘File’ 메뉴에서 ‘Clone Repository’를 선택합니다.
‘URL’ 탭에서 원격 저장소 URL을 입력하거나 ‘GitHub.com’를 선택하여 저장소를 선택합니다.
로컬 경로를 선택하고 ‘Clone’을 클릭합니다.
GitHub Desktop의 ‘Changes’ 탭에서 변경 사항을 확인하고 커밋 메시지를 작성합니다.
‘Commit to main’을 클릭한 후 ‘Push origin’을 클릭하여 변경 사항을 원격 저장소로 푸시합니다.

저장소 관리와 기본 워크플로

저장소를 생성한 후에는 다음 기본 워크플로를 따라 프로젝트를 관리합니다.

로컬에서 코드 수정하기
- 로컬 폴더에서 파일을 수정하거나 새 파일을 추가합니다.
변경 사항 커밋하기
- GitHub Desktop에서 ‘Changes’ 탭에서 수정된 파일을 확인하고 커밋 메시지를 작성합니다.
- Git 명령을 사용한다면 git add .과 git commit -m "메시지" 명령을 실행합니다.
원격 저장소로 푸시하기
- GitHub Desktop에서 ‘Push origin’을 클릭합니다.
- Git 명령을 사용한다면 git push 명령을 실행합니다.
풀 리퀘스트 생성하기(협업 시)
- GitHub 저장소 페이지에서 ‘Pull requests’ 탭을 클릭합니다.
- ‘New pull request’를 클릭하고 브랜치와 비교 대상을 선택합니다.
- 변경 사항을 설명하고 리뷰어를 지정합니다.
코드 리뷰와 머지
- 리뷰어가 코드 리뷰를 진행합니다.
- 리뷰가 완료되면 ‘Merge pull request’를 클릭하여 변경 사항을 메인 브랜치에 병합합니다.

자주 묻는 질문

GitHub 저장소 이름은 영문만 사용해야 합니까

아니요. 저장소 이름은 영문 소문자, 숫자, 하이픈(-), 언더스코어(_)를 사용할 수 있습니다. 한글이나 공백은 사용할 수 없습니다. 저장소 이름은 나중에 변경할 수 없으므로 신중히 결정합니다.

README 파일을 만들지 않아도 됩니까

README 파일을 만들지 않아도 저장소를 생성할 수 있습니다. 그러나 README 파일을 포함하면 프로젝트에 대한 설명, 설치 방법, 사용법 등을 문서화할 수 있어 협업 시 유용합니다. GitHub는 저장소를 생성할 때 README 파일을 자동으로 생성하는 옵션을 제공합니다.

GitHub 저장소를 비공개로 설정할 수 있습니까

네. 무료 플랜에서도 비공개 저장소를 생성할 수 있습니다. 비공개 저장소는 지정한 사용자만 접근할 수 있으며, 공개 저장소는 누구나 볼 수 있습니다. 비공개 저장소는 유료 플랜으로 전환하지 않아도 무료로 사용할 수 있습니다.