[GitHub 100일 챌린지] Day 98 - 배포 및 운영
[GitHub 100일 챌린지] Day 98 - 배포 및 운영
100일 챌린지 Day 98 - 최종 프로젝트를 배포하고, 배포 후에도 안정적으로 운영할 수 있는 기본 점검을 합니다.
배울 내용
- 배포 전 체크리스트 만들기
- GitHub Actions로 배포 검증 흐름 구성하기
- 배포 후 모니터링과 롤백 기준 정하기
1. 배포 전 체크리스트
배포는 “사이트가 올라갔다”에서 끝나지 않습니다. 사용자가 볼 수 있는 상태인지 확인해야 합니다.
1
2
3
4
5
6
7
8
9
## 배포 전 체크리스트
- [ ] main 브랜치가 최신이다
- [ ] 테스트가 통과한다
- [ ] 빌드가 성공한다
- [ ] 환경 변수가 배포 플랫폼에 등록되어 있다
- [ ] README의 배포 링크가 최신이다
- [ ] 모바일 화면에서 핵심 기능이 동작한다
- [ ] 404 페이지 또는 빈 상태가 어색하지 않다
체크리스트를 PR 본문이나 Release 노트에 남기면 배포 과정이 반복 가능해집니다.
2. GitHub Actions로 배포 전 검증하기
자동 배포를 쓰지 않더라도 PR마다 테스트와 빌드를 실행하는 것이 좋습니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
name: Validate
on:
pull_request:
push:
branches: [main]
jobs:
validate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- run: npm ci
- run: npm test
- run: npm run build
프로젝트가 Python, Ruby, Go라면 각 언어에 맞는 setup action으로 바꾸면 됩니다. 핵심은 “내 컴퓨터에서는 됐는데요”를 줄이는 것입니다.
3. 배포 플랫폼 연결하기
정적 사이트나 프론트엔드 앱은 GitHub Pages, Vercel, Netlify 같은 플랫폼을 많이 사용합니다. 어떤 플랫폼이든 확인할 항목은 비슷합니다.
| 항목 | 확인 내용 |
|---|---|
| Build command | npm run build 등 실제 명령어 |
| Output directory | dist, build, .next 등 결과물 위치 |
| Environment variables | 로컬 .env와 배포 설정 일치 |
| Branch | main 또는 배포용 브랜치 |
| Domain | 기본 도메인 또는 커스텀 도메인 |
배포가 끝나면 실제 URL을 열어 핵심 기능을 확인합니다.
4. 배포 후 운영 점검
배포 후에는 아래 세 가지를 봅니다.
1
2
3
4
5
6
## 배포 후 확인
- [ ] 홈 화면이 정상 로딩된다
- [ ] 주요 링크가 404로 가지 않는다
- [ ] 콘솔에 치명적인 오류가 없다
- [ ] 모바일 화면에서 핵심 UI가 깨지지 않는다
- [ ] README와 GitHub About의 배포 URL이 같다
가능하다면 브라우저 개발자 도구의 Network 탭에서 404, 500 응답도 확인하세요.
5. 롤백 기준 정하기
배포 후 문제가 생겼을 때는 빨리 되돌리는 기준이 필요합니다.
1
2
3
4
5
## 롤백 기준
- 홈 화면이 열리지 않는다
- 핵심 기능이 동작하지 않는다
- 배포 후 치명적인 보안 설정 누락을 발견했다
- 주요 브라우저에서 화면이 깨진다
GitHub에서는 이전 커밋으로 되돌리는 PR을 만들거나, 배포 플랫폼에서 이전 배포본으로 rollback할 수 있습니다. 중요한 것은 문제가 생긴 뒤 방법을 찾는 것이 아니라, 미리 기준을 정해두는 것입니다.
정리
완료 체크:
- 배포 전 체크리스트를 만들었다
- 테스트와 빌드가 자동으로 실행되도록 준비했다
- 배포 플랫폼의 빌드 명령과 출력 경로를 확인했다
- 배포 후 실제 URL에서 핵심 기능을 검증했다
- 롤백 기준을 문서화했다
핵심 요약:
1
배포는 업로드가 아니라 검증과 운영까지 포함하는 과정이다. 자동 검증과 롤백 기준을 함께 준비한다.
다음: Day 99 - 포트폴리오 정리 →
이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.