[GitHub 100일 챌린지] Day 12 - 첫 Repository 생성하기
100일 챌린지 Day 12 - 나만의 첫 Repository를 만들어봅니다
배울 내용
- Repository 생성 단계별 가이드
- 초기 설정 옵션 이해하기
- 첫 파일 추가하기
Topic1. Repository 생성하기
GitHub에서 새 Repository를 만드는 과정은 매우 간단합니다.
하지만 저장소는 한 번 만들고 끝나는 폴더가 아닙니다. 이름, 공개 범위, README, .gitignore, License를 처음에 잘 정하면 이후 관리가 훨씬 쉬워집니다.
만들기 전에 아래를 먼저 정해보세요.
| 질문 | 예시 답 |
|---|---|
| 무엇을 만들 저장소인가요? | GitHub 100일 챌린지 연습 |
| 공개해도 되나요? | 학습용이므로 Public 가능 |
| 어떤 언어를 쓰나요? | 아직 없음 또는 Python |
| README에 무엇을 쓸까요? | 목표, 진행 기록, 참고 링크 |
| 비밀 값이 들어갈 예정인가요? | 아니오. 들어간다면 Private부터 시작 |
생성 시작하기
해보기:
1
2
3
1. GitHub 로그인
2. 우측 상단 '+' 버튼 클릭
3. "New repository" 선택
또는:
1
2
1. 프로필 페이지에서 "Repositories" 탭 클릭
2. 초록색 "New" 버튼 클릭
필수 정보 입력
Repository 이름 규칙:
1
2
3
4
5
6
7
8
9
10
11
✅ 좋은 이름:
- my-first-project
- todo-app
- python-study-notes
- awesome-resources
❌ 피해야 할 이름:
- test (너무 일반적)
- asdfgh (의미 없음)
- 내프로젝트 (한글, 띄어쓰기)
- My Project (띄어쓰기)
이름 작성 팁:
1
2
3
4
1. 소문자 사용
2. 단어 구분은 하이픈(-) 또는 언더스코어(_)
3. 의미있고 기억하기 쉬운 이름
4. 프로젝트 내용 반영
Description (설명):
1
2
3
4
선택사항이지만 권장:
"할 일 관리 웹 애플리케이션"
"Python 기초 학습 자료 모음"
"개인 포트폴리오 웹사이트"
해보기: 첫 Repository 만들기
1
2
이름: my-first-repo
설명: GitHub 100일 챌린지 연습용 저장소
결과: Repository 생성 페이지에서 기본 정보를 입력했습니다
저장소 이름은 나중에 바꿀 수 있지만, URL이 바뀌므로 이미 공유한 링크가 깨질 수 있습니다. 처음부터 너무 임시적인 이름은 피하고, 학습용이라도 의미가 보이는 이름을 고르세요.
Topic2. 초기 설정 옵션
Repository 생성 시 여러 옵션을 설정할 수 있습니다.
Public vs Private 선택
1
2
3
4
5
6
7
8
9
🌍 Public
- 누구나 볼 수 있음
- 포트폴리오용으로 좋음
- 첫 연습용은 Public 권장
🔒 Private
- 나만 보거나 초대한 사람만
- 나중에 Public으로 변경 가능
- 민감한 정보 포함 시
README 추가
✅ “Add a README file” 체크 (권장):
1
2
3
4
5
6
7
8
9
README.md 파일 자동 생성:
- Repository 설명 페이지
- Markdown 형식
- 첫 화면에 표시됨
- 나중에 수정 가능
체크 안 하면:
- 빈 Repository 생성
- 수동으로 파일 추가 필요
.gitignore 템플릿
1
2
3
4
5
6
7
8
9
10
11
12
.gitignore = Git이 무시할 파일 목록
선택 가능한 템플릿:
- None: .gitignore 없음
- Python: Python 프로젝트용
- Node: JavaScript/Node.js용
- Java: Java 프로젝트용
- ... 기타 다양한 언어
언제 선택?
- 프로젝트 언어 정해진 경우: 해당 템플릿
- 아직 모르는 경우: None (나중에 추가)
LICENSE 선택
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
오픈소스 라이선스:
MIT License (가장 인기):
- 자유롭게 사용, 수정, 배포
- 상업적 이용 가능
- 저작권 표시만 필요
Apache License 2.0:
- MIT + 특허 보호
- 기업용 프로젝트에 적합
GNU GPLv3:
- 수정 시 소스 공개 필수
- 오픈소스 유지 강제
None:
- 라이선스 없음
- 나중에 추가 가능
- 학습용은 None도 OK
권장 초기 설정:
1
2
3
4
5
처음 만드는 경우:
✅ Public
✅ Add a README file
✅ .gitignore: None (또는 사용 언어)
✅ License: None (또는 MIT)
조금 더 현실적인 기준은 아래와 같습니다.
| 옵션 | 처음 선택 기준 |
|---|---|
| Public | 학습 기록, 포트폴리오, 오픈소스 후보 |
| Private | 회사/개인정보/비밀 키/미완성 실험 포함 |
| README | 거의 항상 체크 |
| .gitignore | 언어가 정해졌다면 템플릿 선택 |
| License | 공개해서 재사용을 허용하려면 선택 |
특히 Public 저장소를 만들 때는 .env, API 키, 개인 메모가 들어가지 않도록 주의하세요. 실수로 올렸다면 파일 삭제만으로 끝나지 않고, 해당 키를 폐기하고 새로 발급해야 합니다.
해보기: 설정 선택하기
1
2
3
4
5
1. Public 선택
2. "Add a README file" 체크
3. .gitignore: None
4. License: None
5. "Create repository" 버튼 클릭!
결과: 새 Repository가 생성되고 README.md가 있는 첫 화면이 표시됩니다
Topic3. 첫 파일 추가하기
Repository가 생성되었으니 파일을 추가해봅시다.
웹에서 파일 만들기
방법 1: Add file 메뉴 사용
해보기:
1
2
3
4
5
6
7
8
9
10
11
12
1. "Add file" 버튼 클릭 (우측 상단)
2. "Create new file" 선택
3. 파일 이름 입력: hello.txt
4. 파일 내용 입력:
Hello, GitHub!
This is my first file.
5. 하단 "Commit new file" 섹션:
- Commit message: Add hello.txt
- Extended description: (비워도 됨)
6. "Commit new file" 버튼 클릭
결과:
1
2
3
✅ hello.txt 파일 생성됨
✅ 첫 번째 Commit 완료
✅ Repository에 파일 1개 추가
웹에서 파일을 만들 때도 commit message는 의미 있게 적는 연습을 하세요.
1
2
3
나쁜 예: update
좋은 예: Add hello practice file
좋은 예: Update README with learning goals
작은 저장소에서도 좋은 습관을 들이면, 나중에 로컬 Git을 배울 때 훨씬 자연스럽습니다.
README.md 편집하기
방법 2: 기존 파일 수정
해보기:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
1. README.md 파일 클릭
2. 연필 아이콘(Edit) 클릭
3. 내용 수정:
# My First Repository
안녕하세요! GitHub 100일 챌린지 중입니다.
## 목표
- GitHub 마스터하기
- 매일 꾸준히 학습하기
4. 하단으로 스크롤
5. Commit message: Update README
6. "Commit changes" 클릭
결과:
1
2
3
✅ README.md 수정됨
✅ 두 번째 Commit 완료
✅ 변경 이력에 기록됨
파일 업로드하기
방법 3: 로컬 파일 올리기
해보기:
1
2
3
4
5
6
1. "Add file" → "Upload files" 선택
2. 파일 드래그 앤 드롭
또는 "choose your files" 클릭
3. 파일 선택 (이미지, 문서 등)
4. Commit message 입력
5. "Commit changes" 클릭
활용 예:
1
2
3
4
- 이미지 파일 (.png, .jpg)
- 문서 (.pdf, .docx)
- 데이터 (.csv, .json)
- 압축 파일 (.zip)
Commit 히스토리 확인
해보기:
1
2
3
4
1. Repository 메인 화면
2. "X commits" 링크 클릭 (파일 목록 위)
3. 모든 변경 이력 확인
4. 각 Commit 클릭하면 변경 내용 상세 보기
결과:
1
2
3
4
5
Commit 히스토리:
📸 Commit 3: Upload image.png
📸 Commit 2: Update README
📸 Commit 1: Add hello.txt
📸 Initial commit (README.md 생성)
커밋 히스토리를 확인할 때는 “몇 개가 생겼는지”보다 “각 변경이 이해되는지”를 보세요. 나중에 협업할 때는 커밋 메시지만 보고도 변경 의도를 짐작할 수 있어야 합니다.
생성 후 점검
Repository를 만든 직후에는 아래 항목을 확인합니다.
| 위치 | 확인할 것 |
|---|---|
| About | Description, Website, Topics |
| Code | README가 첫 화면에서 잘 보이는지 |
| Settings | Issues/Wiki/Discussions 필요 여부 |
| Security | Secret scanning, Dependabot alerts 확인 |
| Commit history | 초기 커밋 메시지가 이해되는지 |
처음에는 모든 기능을 켤 필요가 없습니다. 실제로 쓸 기능만 켜고, 설명과 README를 먼저 정리하는 것이 좋습니다.
정리
완료 체크:
- 첫 Repository를 성공적으로 만들었다
- Public/Private, README, .gitignore 옵션을 이해했다
- 웹에서 파일을 추가/수정/업로드 할 수 있다
- About 영역과 Topics를 설정했다
- 초기 커밋 메시지를 확인했다
축하합니다! 🎉
1
2
3
4
5
6
✅ Repository 생성 완료
✅ 파일 3개 이상 추가
✅ Commit 히스토리 생성
이제 여러분은 Repository를 만들고
관리할 수 있습니다!
다음 단계:
1
2
Day 13에서는 README.md를
더 멋지게 작성하는 방법을 배웁니다.