# 배포 워크플로
배포는 에이전트가 안전하게 처리합니다. 원장님은 “배포해줘”라고 말하면 되고, 에이전트가 모든 점검과 실행을 담당합니다.
> **사전 조건**: 배포는 Cloudflare 계정과 API Token이 셋업되어 있어야 가능합니다. 처음 배포한다면 먼저 [Cloudflare 셋업 가이드](/guide#cloudflare-setup)를 완료하세요.
---
## “배포해줘”라고 말하면 일어나는 일
에이전트는 배포 요청을 받으면 다음 단계를 자동으로 진행합니다.
1. **상태 진단** — 현재 설치본이 정상인지, 배포 가능한 상태인지 확인합니다
2. **안전 스냅샷** — 문제가 생기면 되돌릴 수 있도록 현재 상태를 저장합니다
3. **로컬 검증** — 변경사항이 정상적으로 동작하는지 빌드하고 확인합니다
4. **데이터베이스 점검** — 프로덕션 DB가 최신 구조인지 자동으로 맞춥니다
5. **프로덕션 배포** — 모든 점검을 통과하면 실제 서비스에 반영합니다
6. **결과 보고** — 배포 결과와 확인해야 할 페이지를 알려줍니다
---
## 로컬과 프로덕션
| 환경 | 역할 |
|------|------|
| **로컬** | 내 컴퓨터에서 변경사항을 미리 확인하는 공간 |
| **프로덕션** | 환자와 방문자가 실제로 보는 서비스 |
로컬에서 먼저 확인하고, 만족스러우면 프로덕션에 반영하는 구조입니다. 에이전트는 항상 이 순서를 지킵니다.
---
## 언제 배포가 필요한가
| 상황 | 예시 |
|------|------|
| 홈페이지 내용을 변경했을 때 | 인사말 수정, 프로그램 추가, 사진 교체 |
| 새 기능을 설정했을 때 | 예약 시스템 활성화, 블로그 추가 |
| 코어 업데이트를 받았을 때 | 새 버전의 기능을 실서비스에 반영 |
| 디자인을 바꿨을 때 | 스킨 변경, 색상 조정, 레이아웃 수정 |
---
## 원장님의 역할
원장님은 명령어를 외울 필요 없이, 다음만 판단하시면 됩니다.
- **지금 배포해도 되는 시점인가** — 진료 중이 아닌 시간을 권장합니다
- **로컬에서 확인이 됐는가** — 변경사항이 의도대로 보이는지
- **최종 승인** — 에이전트가 준비가 됐다고 보고하면 “진행해”라고 말하면 됩니다
즉, 원장님은 **기술 실행자**가 아니라 **의사결정자**입니다.
---
## 배포 후 확인할 것
배포가 완료되면 에이전트가 확인 목록을 안내합니다. 보통 아래를 확인합니다.
- 메인 홈페이지가 정상인지
- 최근 변경한 페이지가 반영됐는지
- 예약 등 핵심 기능이 동작하는지
- 모바일에서도 잘 보이는지
문제가 발견되면 에이전트에게 바로 말하세요. 원인을 파악하고 조치합니다.
---
## 이런 상황에서 에이전트에게 말하세요
> “로컬에서 수정한 거 확인했어. 배포해줘.”
> “배포 후에 예약 페이지가 이상해. 확인해줘.”
> “오래된 버전인 것 같은데, 바로 배포해도 되는지 먼저 확인해줘.”
에이전트는 상황을 판단해서, 바로 배포할지 또는 업데이트가 먼저 필요한지 안내합니다.
---
## 함께 읽으면 좋은 문서
- [설치와 시작 가이드](/guide#getting-started)
- [Cloudflare 셋업 가이드](/guide#cloudflare-setup)
- [업데이트와 데이터 이관](/guide#migrations-guide)
- [문제가 생겼을 때](/guide#agent-troubleshooting)
---
## 관련 콘텐츠
- 📹 **관련 영상**: 커리큘럼 1-8. 1차 배포하기!
- 📋 **커리큘럼**: Stage 1 M1에서 다룸
- 🎯 **직원 투어**: 관리자 패널에서 **설정** 투어를 시작하세요