Choorai

배포 기초

코드를 인터넷에서 접근 가능한 서비스로 만드는 과정에서 필요한 개념과 점검 항목을 정리합니다.

자주 헷갈리는 구분

  • Build: 소스 코드를 실행 가능한 산출물로 변환
  • Artifact: 빌드 결과물(예: dist)
  • Hosting: 결과물을 서비스하는 인프라
  • Runtime: 코드가 실제 실행되는 환경

프론트엔드 배포 흐름

CI 예시
npm ci
npm run build
# dist/ 생성
# 정적 호스팅(Cloudflare Pages/Vercel)에 업로드

백엔드 배포 흐름

Container 예시
docker build -t my-api:latest .
# 이미지 푸시
# Cloud Run 등 런타임에 배포
# 환경변수 주입 후 헬스체크

배포 전 체크리스트

  • 빌드가 로컬/CI 모두 통과하는가
  • 환경변수가 배포 환경에 정확히 설정됐는가
  • 헬스체크 URL이 200을 반환하는가
  • 도메인/DNS 연결이 의도대로 동작하는가

60분 챌린지 연결 지점

초심자 실수 TOP 3

  • 로컬에서만 있던 환경변수에 의존
  • 빌드 산출물 경로를 잘못 설정
  • 배포 후 로그/헬스체크 확인 없이 완료 처리

마지막 업데이트: 2026년 2월 22일 · 버전: v0.0.1

피드백 보내기

입력한 내용으로 새 이슈 페이지를 엽니다.

GitHub 이슈로 보내기