← 전체 글로 돌아가기

웹 개발

배포 전 데이터베이스 마이그레이션 확인하기

Prisma로 데이터베이스 마이그레이션을 할 때 배포 전에 확인해야 할 것들입니다.

데이터를 다루는 배포는 신중해야 한다

문제를 크게 잡으면 모든 파일이 의심스러워져서 손대기 어려워진다. 데이터베이스 마이그레이션은 더 그렇다. 스키마를 잘못 바꾸면 데이터가 손상될 수 있으니까.

먼저 현재 상태를 정확히 파악해야 한다. 로컬 데이터베이스가 정상 상태인지 확인하고, 마이그레이션이 안전하게 실행되는지 테스트해야 한다.

배포 전 확인할 것들

마이그레이션을 하기 전에 몇 가지 확인해야 할 것들이 있다.

먼저 봐야 할 것:

  • 데이터베이스 스키마
  • 정상일 때의 상태와 비교
  • 마이그레이션 명령 출력과 로그

Prisma 마이그레이션 검증하기

npx prisma validate
npx prisma migrate status

마이그레이션 전에 반드시 검증하고 상태를 확인한다. 로컬에서 테스트한 후에 배포 환경에 적용하는 게 안전하다.

안전한 배포 순서

  1. 로컬에서 같은 조건으로 마이그레이션을 테스트한다
  2. 로그에서 에러나 경고를 확인한다
  3. 배포 후 실제 데이터로 확인한다

다음 마이그레이션을 위한 기록

이번 마이그레이션이 완료되면 어떤 변경을 했고 어떻게 검증했는지 기록해두자. 다음 마이그레이션 때 같은 실수를 반복하지 않을 수 있다.