Git · GitHub 기초집LESSON 24

최종 실습: 개인 학습 사이트를 브랜치·PR·Actions로 관리하기

난이도입문 → 초급

예상 시간30분

선수지식이전 강의

24강. 최종 실습: 개인 학습 사이트를 브랜치·PR·Actions로 관리하기

1. 이번 강의에서 해결할 문제

개별 명령을 알더라도 실제 프로젝트에서 실행 순서를 연결하지 못하면 main을 직접 수정하거나 검증 없이 배포하게 됩니다. 하나의 학습 콘텐츠를 계획부터 릴리스까지 운영합니다.

2. 학습 목표

3. 핵심 개념

최종 흐름은 Issue → 최신 main → 기능 브랜치 → 검토한 커밋 → PR → 자동 검사·리뷰 → 병합 → Pages → 태그·Release입니다. 각 단계는 다음 단계의 입력이 되며, 실패하면 데이터를 지우기보다 이전 검증 지점으로 돌아갑니다.

4. 단계별 명령어와 예시

프로젝트 경로: C:\dev\git-learning-site

GitHub에서 “Git 학습 회고 페이지 추가” Issue를 만들고 완료 기준을 적습니다. Issue가 #24라고 가정합니다.

PowerShell · 작업 시작
Set-Location C:\dev\git-learning-site
git status
git switch main
git fetch origin
git pull --ff-only
git switch -c issue-24-retrospective

파일 경로: docs/retrospective.md

docs/retrospective.md
# Git 학습 회고

- 가장 유용한 명령: git status
- 안전 원칙: 상태와 diff를 먼저 확인한다.
- 다음 목표: 작은 Pull Request를 유지한다.

PowerShell · 기록과 검증
git status --short
git diff -- docs/retrospective.md
git add docs/retrospective.md
git diff --staged
git commit -m "docs: add Git learning retrospective"
npm.cmd run build
git push -u origin issue-24-retrospective

PR 본문에 Closes #24, 변경 내용, npm run build 결과를 적습니다. Actions 성공과 Files changed를 확인한 뒤 병합합니다.

PowerShell · 병합 후 릴리스
git switch main
git pull --ff-only
git branch -d issue-24-retrospective
git fetch --prune
npm.cmd run build
git tag -a v1.0.0 -m "Complete Git learning site workflow"
git push origin v1.0.0

5. 명령어가 동작하는 이유

Issue가 목적과 완료 기준을 제공하고 브랜치가 작업을 격리합니다. staged diff와 로컬 build가 커밋 품질을 확인하며, PR Actions는 다른 환경에서 재검증합니다. main 병합이 Pages 배포 event를 발생시키고 태그가 검증된 릴리스 기준점을 고정합니다.

6. 자주 하는 실수와 안전한 해결법

7. 직접 실습

8. 이해 점검 질문 3개

9. 핵심 요약

MINI QUIZ