database-migration

개요

database-migration이란?

database-migration은 Sequelize, TypeORM, Prisma 등 인기 ORM 전반에 걸쳐 데이터베이스 스키마와 데이터 마이그레이션을 관리할 수 있도록 설계된 백엔드 개발 스킬입니다. 제로 다운타임 배포 전략, 견고한 롤백 절차, 데이터 변환 기능을 제공하여 서비스 중단 없이 신뢰할 수 있는 데이터베이스 변경이 필요한 프로젝트에 적합합니다.

누가 이 스킬을 사용해야 하나요?

이 스킬은 다음과 같은 작업이 필요한 백엔드 개발자, 데이터베이스 엔지니어, DevOps 전문가에게 적합합니다:

• 서로 다른 ORM 간 마이그레이션
• 스키마 변환 수행
• 데이터베이스 간 데이터 이동
• 롤백 절차 구현
• 제로 다운타임 데이터베이스 변경 배포
• 데이터베이스 버전 업그레이드
• 데이터 모델 리팩토링

해결하는 문제

• 안전하고 신뢰할 수 있는 스키마 변경
• 자동화된 마이그레이션 워크플로우
• 실패한 마이그레이션에 대한 롤백 지원
• 여러 ORM 간 호환성

사용 방법

설치 단계

database-migration을 설치하려면 다음 명령어를 실행하세요:

npx skills add https://github.com/wshobson/agents --skill database-migration

시작하기

1. SKILL.md 파일에서 마이그레이션 워크플로우와 지원하는 ORM 개요를 확인하세요.
2. 자세한 지침과 배경 설명은 README.md, AGENTS.md, metadata.json을 참고하세요.
3. 마이그레이션 도우미와 예제는 rules/, resources/, references/, scripts/ 폴더에서 확인할 수 있습니다.
4. 프로젝트의 저장소, ORM, 배포 요구사항에 맞게 마이그레이션 전략을 조정하세요.

지원하는 ORM 마이그레이션 예시

Sequelize

• migrations/ 폴더에 마이그레이션 파일 생성
• npx sequelize-cli db:migrate 명령어로 마이그레이션 적용
• npx sequelize-cli db:migrate:undo 명령어로 롤백

TypeORM

• migrations/ 폴더에 마이그레이션 클래스 생성
• TypeORM CLI 명령어로 마이그레이션 실행
• TypeORM의 마이그레이션 롤백 기능 사용

Prisma

• Prisma의 마이그레이션 도구를 사용해 스키마 변경 및 롤백 수행

권장 사항

• 프로덕션 이전에 스테이징 환경에서 마이그레이션 테스트
• 마이그레이션 스크립트는 버전 관리 사용
• 중요한 변경 사항에 대해 롤백 절차 구현

자주 묻는 질문

마이그레이션 예제는 어디서 볼 수 있나요?

SKILL.md 파일과 migrations/ 폴더에서 Sequelize, TypeORM, Prisma용 샘플 마이그레이션 스크립트를 확인할 수 있습니다.

database-migration이 제로 다운타임 배포를 지원하나요?

네, 이 스킬은 스키마 변경 시 서비스 중단을 최소화하는 제로 다운타임 데이터베이스 마이그레이션 전략과 가이드를 제공합니다.

데이터 변환에도 database-migration을 사용할 수 있나요?

물론입니다. 이 스킬은 스키마뿐 아니라 복잡한 데이터 변환 워크플로우를 포함한 데이터 마이그레이션을 위해 설계되었습니다.

마이그레이션을 롤백하려면 어떻게 하나요?

지원하는 각 ORM은 롤백 명령어와 절차를 포함하고 있습니다. 마이그레이션 예제와 문서를 참고하세요.

database-migration은 프론트엔드 프로젝트에 적합한가요?

아니요, 이 스킬은 백엔드 데이터베이스 엔지니어링에 집중되어 있으며 프론트엔드나 UI 마이그레이션 용도가 아닙니다.

모든 파일과 스크립트는 어디서 확인할 수 있나요?

Files 탭을 열어 전체 파일 트리와 중첩된 참조, 도우미 스크립트를 미리 볼 수 있습니다.