배포와 운영 기초집LESSON 01

배포와 운영의 역할, 개발 환경과 서비스 환경의 차이

난이도입문 → 초급

예상 시간30분

선수지식Git · GitHub와 웹 또는 FastAPI 기초

1강. 배포와 운영의 역할, 개발 환경과 서비스 환경의 차이

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

내 컴퓨터에서 보이는 사이트가 곧 서비스는 아닙니다. 다른 사용자가 안정적으로 접근하려면 재현 가능한 빌드, 공개 위치, 상태 점검과 복구 절차가 필요합니다.

2. 학습 목표

3. 핵심 개념

배포는 검증한 결과물을 사용자가 접근할 환경에 전달하는 과정이고, 운영은 배포 이후 상태·오류·비용·보안·복구를 지속적으로 관리하는 활동입니다. Docusaurus는 빌드 결과가 HTML·CSS·JavaScript 정적 파일이므로 GitHub Pages가 파일을 제공할 수 있습니다. FastAPI는 요청을 처리할 실행 프로세스와 네트워크·비밀·로그가 계속 필요해 같은 방식으로 Pages에 올릴 수 없습니다.

4. 단계별 실습

1. PowerShell

실행 위치: C:\dev\dev-foundations

실행 전 확인: 저장소 루트인지 Get-Location으로 확인합니다.

대상: 현재 Git 브랜치와 배포 관련 파일

PowerShell
Set-Location C:\dev\dev-foundations
Get-Location
git status --short --branch
Get-Item package.json, docusaurus.config.js, .github\workflows\deploy-pages.yml

예상 결과: 현재 브랜치와 세 배포 입력 파일의 경로가 표시됩니다.

2. 문서 설계

실행 위치: 과정 노트

실행 전 확인: 실제 계정·토큰·URL을 적지 않습니다.

대상: 환경별 책임 표

문서 설계
개발: 빠른 수정과 로컬 미리보기
테스트: 동일 명령으로 오류 검출
배포: 검증된 정적 결과물 게시
운영: URL·오류·비용·보안·복구 점검

예상 결과: 각 단계의 입력, 결과와 담당 작업을 한 문장씩 설명할 수 있습니다.

5. 배포·운영 흐름이 동작하는 이유

소스 코드는 빌드 도구가 정적 결과물로 바꾸고 호스팅 서비스가 그 파일을 HTTP로 제공합니다. 운영자는 배포 성공 여부뿐 아니라 사용자가 실제 경로에서 같은 파일을 받는지 확인하고 문제가 생기면 이전 정상 상태로 복구합니다.

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

7. 직접 실습

8. 이해 점검 질문 3개

9. 핵심 요약

MINI QUIZ