배포했는데 화면이 깨지면 어떻게 되돌릴까?
프리뷰에서는 잘 보이던 페이지가 운영 화면에서만 깨진다면 배포 과정을 되돌릴 방법이 있어야 합니다.
기술 이름보다 해결할 문제를 먼저 살펴보겠습니다
프리뷰에서는 잘 보이던 페이지가 운영 화면에서만 깨진다면 배포 과정을 되돌릴 방법이 있어야 합니다.
AI 개발이라고 해서 처음부터 모든 기능을 한 번에 코딩하는 것은 아닙니다. 이번 시간에는 테스트→프리뷰→프로덕션의 배포 흐름과 롤백 기준을 이해한다.를 이해하고, 화면·입력·서버가 어떤 순서로 움직이는지 작은 예제로 확인해 보겠습니다.
먼저 아래 상황을 읽어보세요. 어떤 정보가 들어오고 무엇이 정상적인 결과인지 알면 코드를 처음 봐도 이해하기 쉬워집니다. 모르는 전문용어는 아래 ‘쉬운 용어 설명’을 열어 확인하세요.
오늘 사용할 가상 상황·입력
개발 브랜치 → PR 테스트 → 프리뷰 URL → 최종 승인 → 운영 배포
코드와 자료는 교육용 축약 예시입니다. 실제 운영 적용 전 추가 보안·예외 처리·환경 설정이 필요할 수 있습니다.
이런 코드 또는 설계 규칙으로 처리합니다
아래 내용을 글자 그대로 외우기보다 어떤 정보를 입력받고, 어떤 규칙을 검사하며, 무엇이 반환되는지 먼저 살펴보세요.
교육용 CI 구성: 1) npm ci 2) npm test 3) 빌드 결과 확인 4) 프리뷰 화면 확인 5) 승인 후 운영 배포
정상일 때 기대하는 결과
테스트 실패 → 운영 반영 중단 프리뷰 화면 확인 후 승인 오류 시 이전 안정 배포로 롤백
가장 중요한 것은 외형보다 입력과 결과 사이의 규칙입니다. 빈 입력, 권한 부족, 중복 요청처럼 예외가 생겨도 문제가 없는지 확인해야 합니다. 이 예제 하나를 이해하면 다른 기능도 비슷한 방식으로 나눠 볼 수 있습니다.
실수 사례와 개선 방법을 나란히 비교합니다
테스트 없이 운영 도메인에 바로 올리고 화면 검수를 하지 않습니다.
프리뷰·테스트·승인·롤백 기준을 단계별로 기록합니다.
전문용어 두 개를 쉬운 말로 알아보기
- CI/CD
- 코드 변경 뒤 테스트·빌드·배포를 자동화하는 흐름
- 프리뷰
- 운영에 반영하기 전 변경된 화면을 시험하는 환경
세 단계의 미니 개발 실습
운영 서버가 아니라 로컬 실습 또는 별도의 연습 환경에서 수행합니다. 필요한 외부 계정이나 운영 데이터는 사용하지 않습니다.
- STEP 1배포 전 자동 검사 3개 정의
- STEP 2데스크톱·모바일 프리뷰 확인
- STEP 3실패 시 롤백 담당자와 기준 지정
실습으로 확인한 입력, 정상 결과, 오류 결과와 수정할 항목을 적어보세요.
오늘 수업의 핵심 질문
Vercel이 READY이면 모든 화면이 정상이라는 뜻일까요?
정답과 이유 펼쳐보기
아닙니다. 빌드·배포 완료와 실제 기능·화면 검증은 별개입니다.
단순히 붙여 넣은 코드보다 작동 원리와 오류 처리 방법을 자신의 말로 설명하는 것이 중요합니다.
기존 LEXID·RE:LAND 등에서 검증한 개발 구조를 학습용으로 재구성했습니다. 비공개 저장소의 실제 고객 데이터나 비밀키는 공개하지 않습니다. 예시는 운영용 완제품이 아닙니다.