본문으로 건너뛰기
배포와 운영 기초집LESSON 17

장애 대응 기초: 배포 실패, 404, 빌드 오류를 순서대로 진단하기

난이도입문 → 초급
예상 시간30분
선수지식이전 강의

17강. 장애 대응 기초: 배포 실패, 404, 빌드 오류를 순서대로 진단하기

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

장애 중 여러 설정을 동시에 바꾸면 원인이 가려지고 복구가 늦어집니다. 증거를 보존하고 한 단계씩 확인하는 절차가 필요합니다.

2. 학습 목표​

3. 핵심 개념​

첫 대응은 새 변경과 반복 배포를 멈추고 영향 URL·시작 시간·마지막 정상 SHA를 기록하는 것입니다. 다음으로 같은 SHA를 로컬 build하고 Actions의 최초 실패를 확인합니다. 빌드 성공 뒤 404라면 Pages source, baseUrl, artifact 경로와 실제 URL을 확인합니다. 수정 또는 롤백은 증거에 맞춰 한 번에 하나만 수행합니다.

4. 단계별 실습​

1. PowerShell​

실행 위치: 저장소 루트

실행 전 확인: 작업 파일을 삭제하거나 reset하지 않고 상태를 기록합니다.

대상: 현재·마지막 정상 후보 커밋과 로컬 build

PowerShell
git status --short --branch
git log -5 --oneline --decorate
git show --stat --oneline HEAD
npm.cmd run build

예상 결과: 현재 변경, 최근 커밋과 재현 가능한 빌드 성공·실패 증거가 남습니다.

2. 진단 체크리스트​

실행 위치: 운영 기록

실행 전 확인: 동시에 여러 설정을 바꾸지 않습니다.

대상: 배포 실패 또는 404 한 사건

진단 체크리스트
1. 영향 URL·시작 시간·마지막 정상 SHA 기록
2. 새 배포 중지
3. 로컬 build 재현
4. Actions 최초 실패 step 확인
5. Pages source·artifact·baseUrl 확인
6. 최소 수정 또는 롤백 선택
7. 복구 후 사용자 경로 재점검

예상 결과: 증거와 결정이 시간순으로 남고 한 번의 변경으로 복구를 시도합니다.

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

변경을 멈추면 비교 기준이 고정되고 로컬 재현이 소스·의존성 문제를 분리합니다. Actions와 Pages 설정은 빌드 이후 계층을 보여 줍니다. 계층별 분기는 불필요한 설정 변경을 줄입니다.

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

7. 직접 실습​

8. 이해 점검 질문 3개​

9. 핵심 요약​

MINI QUIZ

장애 대응 기초: 배포 실패, 404, 빌드 오류를 순서대로 진단하기 미니 퀴즈

선택 즉시 정답과 해설을 확인할 수 있습니다. 결과는 이 브라우저에만 저장됩니다.

0 / 2
  1. 문제 1“장애 대응 기초: 배포 실패, 404, 빌드 오류를 순서대로 진단하기”에서 오류나 데이터 손실을 줄이는 선택은 무엇인가요?
  2. 문제 2“장애 대응 기초: 배포 실패, 404, 빌드 오류를 순서대로 진단하기”에서 ‘장애 중 force push와 reset으로 이력 변경’ 문제가 생겼습니다. 가장 알맞은 진단 또는 대응은 무엇인가요?

답을 선택하면 진행 결과가 자동으로 저장됩니다.

LESSON STATUS

학습을 마쳤나요?

직접 실습과 점검 질문까지 확인한 뒤 완료로 표시하세요.

17강. 장애 대응 기초: 배포 실패, 404, 빌드 오류를 순서대로 진단하기 미완료 상태