Lovable.dev 마이그레이션 가이드: 개인 GitHub에서 조직으로 이동 (동기화 손상 없이)

Source: Dev.to

표준 마이그레이션이 실패하는 이유

• 저장소를 Lovable에 연결된 상태에서 이전하면 동기화가 깨집니다—대부분 영구적입니다.
• Lovable은 기존 프로젝트에 대해 “BYOR(Bring Your Own Repository)”을 지원하지 않습니다. 수동으로 이전하면 Lovable이 재연결을 거부하고 중복 저장소(예: my-org/my-app-1)를 만들도록 강요합니다.
• 대부분의 개발자 도구(Vercel, Netlify 등)는 GitHub를 진실의 원천으로 간주합니다. Lovable은 반대로 연결 과정에서 저장소를 생성합니다.

마이그레이션 전략 (Lovable‑first 접근법)

동기화를 건강하게 유지하기 위해 Git 커밋 히스토리를 포기합니다:

1. 이전 대신 기존 저장소를 아카이브합니다.
2. Lovable이 대상 조직에 새 저장소를 만들게 합니다.
3. 모든 외부 서비스를 새 저장소에 다시 연결합니다.

마이그레이션 전 백업

git clone https://github.com/your-user/your-repo.git
zip -r your-repo-backup.zip your-repo/

Note: Supabase 데이터베이스는 프로젝트 ID를 통해 연결된 느슨한 결합 구조이므로 코드를 옮겨도 데이터가 삭제되지 않습니다.

단계별 마이그레이션

1. 기존 저장소 이름 바꾸기

• 개인 GitHub 저장소로 이동해 이름을 바꿉니다(예: my-app-legacy).
• 이렇게 하면 새 조직에서 원하는 이름(my-app)을 사용할 수 있게 됩니다.

2. 외부 배포 일시 중지

• Coolify, Vercel, Netlify 등을 사용한다면 “Auto Deploy”를 일시 중지해 이전 URL에서 끌어오는 것을 방지합니다.

3. Lovable 연결 해제

1. Lovable → Project Settings → Integrations → GitHub에서 Disconnect를 클릭합니다.
2. 코드 자체는 Lovable 안에 안전하게 남아 있습니다.

4. Lovable을 조직에 다시 연결

1. Lovable → Settings → Integrations → GitHub에서 Connect Project를 클릭합니다.
2. 핵심: 대상 Organization을 목적지로 선택합니다.
   • 조직이 보이지 않으면 Add Organization을 클릭해 Lovable GitHub App을 해당 조직에 설치합니다.
3. Lovable이 저장소 생성을 요청합니다. 이름을 my-app(이제 사용 가능)으로 지정합니다.
4. 확인합니다. Lovable은 현재 앱 상태를 github.com/my-org/my-app에 Initial Commit으로 푸시합니다. 이제 동기화가 활성화됩니다.

5. 다른 도구 업데이트

호스팅 (Coolify / Vercel / Netlify)

• Git 소스 URL을 새 조직 저장소로 변경합니다.
• 호스팅 제공자의 GitHub App이 개인 계정이 아닌 새 조직에 설치되어 있는지 확인합니다.
• 파이프라인을 검증하기 위해 수동 배포를 트리거합니다.

Supabase (Branching)

• 데이터베이스 연결(URL / anon key)은 그대로 유지됩니다—변경 필요 없음.
• Supabase Branching을 사용한다면 Supabase → Integrations → GitHub에서 새 조직 저장소에 대한 통합을 다시 설치합니다.

요약

• Lovable에 연결된 저장소에 대해 GitHub의 “Transfer Ownership” 버튼을 사용하지 마세요.
• 먼저 Lovable 연결을 해제하고, 대상 조직에 새 저장소를 만들도록 합니다.
• Git 커밋 히스토리가 초기화되는 것을 감수하고(구 저장소는 읽기 전용 아카이브로 보관) 진행합니다.
• 이 “Lovable‑First” 접근법을 따르면 “Ghost Repository” 함정을 피하고 프로젝트를 원활하게 운영할 수 있습니다.

최근에 Lovable 프로젝트를 마이그레이션한 경험이 있나요? 다른 문제에 부딪혔다면 댓글로 알려주세요!