저장소 생성과 Collaborator 초대

저장소 생성 시 체크포인트

GitHub에서 새 저장소를 만들 때 확인해야 할 설정 항목들을 정리합니다.

1. Repository name

프로젝트 이름을 입력합니다. 팀원 모두가 이해할 수 있는 명확한 이름이 좋습니다.

  
    
  
  
    
  

좋은 예: sprint-teamN-rolling, sprint-teamN-taskify
나쁜 예: project1, asdf, my-thing

2. Visibility - Public vs Private

3. 초기 상태 그대로 두기

모두 추가하지 마세요. 프로젝트 생성 도구가 이미 README.md와 .gitignore를 만들어 주기 때문에, GitHub에서도 이를 추가하면 서로 다른 초기 커밋이 생깁니다. 이로 인해 push를 하면 충돌이 발생하거나, 불필요한 병합이 발생할 수 있습니다.

빈 저장소를 만든 뒤, 로컬에서 프로젝트를 생성하고 push하는 흐름이 가장 깔끔합니다.

  
    
  
  
    
  

# 로컬에서 프로젝트 생성 (예: Vite)
npm create vite@latest sprint-team{N}-{프로젝트명}

cd sprint-team{N}-{프로젝트명}
git init
git add .
git commit -m "프로젝트 초기 설정"
git remote add origin https://github.com/{owner}/sprint-team{N}-{프로젝트명}.git
git branch -M main
git push -u origin main

Collaborator 초대하기

저장소가 생성되면 팀원을 초대합니다.

초대하는 방법 (Owner)

1. 저장소 페이지에서 Settings 탭 클릭
2. 왼쪽 메뉴에서 Collaborators 클릭
3. Add people 버튼 클릭

4. 팀원의 GitHub 사용자명 또는 이메일 입력
5. 초대 전송

초대 수락 흐름 (팀원)

1. GitHub에 등록된 이메일로 초대 알림 수신
2. 또는 GitHub 알림(벨 아이콘)에서 초대 확인
3. Accept invitation 클릭
4. 이제 저장소에 push할 수 있음

1. 이메일 확인

스팸함을 포함해 GitHub 초대 메일이 왔는지 확인합니다.

2. GitHub에서 직접 확인

github.com/[owner]/[repo]/invitations 주소로 접속하면 초대를 직접 확인할 수 있습니다.

3. 초대 링크 재전달

Owner가 초대 링크를 복사해 전달하면, 해당 링크로 바로 수락할 수 있습니다.

브랜치 보호 규칙(Ruleset) 설정

팀 프로젝트에서 가장 중요한 설정 중 하나입니다. main 브랜치에 아무나 직접 push하면 코드 리뷰 없이 변경사항이 합쳐지거나, 여러 명이 동시에 push하면서 충돌이 빈번해지는 문제가 생깁니다. 이를 방지하기 위해 PR을 통해서만 코드를 합칠 수 있도록 보호 규칙을 설정합니다.

설정 방법

1. Settings → Branches
2. Add branch ruleset 클릭

3. Ruleset name 입력 (예: main-protection)
4. Enforcement status를 Active로 설정
5. Targets → Add target → Include default branch 선택

6. Rules에서 Restrict deletions, Block force pushes, Require a pull request before merging 체크
7. Require a pull request before merging의 하위 옵션에서 Required approvals: 1, Require conversation resolution before merging 설정
8. Allowed merge methods를 Squash만 선택
9. Create 클릭

Rules 상세 옵션

다음 세션에서는 이 설정을 기반으로 한 브랜치 전략과 PR 워크플로우를 알아봅니다.