db:check-migrations job

머지 리퀘스트 파이프라인의 테스트 Stage에서 실행되는 db:check-migrations job의 동작 방식과 문제 해결 방법을 설명합니다.

이 job은 머지 리퀘스트 파이프라인의 test Stage에서 실행됩니다. 다음을 확인합니다: 새 마이그레이션을 롤백한 후, 작성자의 작업 브랜치와 타깃 브랜치 간의 스키마 덤프 비교. 이 확인은 스키마가 새 마이그레이션 실행 이전 상태로 올바르게 재설정되는지 검증합니다. 작성자의 작업 브랜치와 작성자가 커밋한 db/structure.sql 파일 간의 스키마 덤프 비교. 이 확인은 마이그레이션의 모든 예상 변경 사항이 포함되어 있는지 검증합니다. 작성자가 커밋한 db/schema_migrations 와 마이그레이션 실행 후 스크립트가 생성한 것 간의 Git diff. 이 확인은 모든 내용이 올바르게 커밋되었는지 검증합니다. 문제 해결 # 거짓 양성(False positives) # 이 job은 실패가 허용되지 않지만, 거짓 양성이 발생할 수 있습니다. 예시: 칼럼을 삭제한 후 롤백하면, 해당 칼럼은 항상 칼럼 목록의 끝에 다시 추가됩니다. 칼럼이 이전에 마지막 칼럼이 아니었다면, 롤백이 스키마를 이전 상태로 정확히 되돌릴 수 없습니다. 참조: job 실패 . 때때로 pg_dump는 마이너 PostgreSQL 버전 업그레이드 시 제약 조건 및 기타 데이터베이스 오브젝트의 정렬 방식을 변경할 수 있습니다. 이로 인해 MR과 관련 없는 스키마의 문(statement) 순서에 대한 불일치로 job이 실패합니다. 참조: job 실패 . 아직 다른 사람이 보고하지 않았다면 #database Slack 채널에 보고하거나 이슈를 생성하세요. 이 문제는 모든 기능 MR에 영향을 미칩니다. 이러한 경우, MR에 pipeline:skip-check-migrations 라벨을 추가하여 이 job을 건너뛰는 것이 더 안전합니다. 롤백 후 스키마 덤프 비교 실패 # 이 실패는 작업 브랜치가 타깃 브랜치보다 뒤처져 있을 때 자주 발생합니다. 실제 시나리오: %%{init: { "fontFamily": "GitLab Sans" }}%% graph LR accTitle: Schema dump comparison fails after rollback accDescr: Diagram showing how schema dump comparison failures occur if a working branch is behind the target branch Main((main commit A)) ===> |remove constraint fk_rails_dbebdaa8fe| MainB((main commit B)) Main((main commit A)) --> |checkout dev| DevA((dev commit A)):::dev DevA((dev commit A)) --> |add column dependency_proxy_size| DevC((dev commit C)):::dev DevC -.-> |CI pipeline ex