Git 동기화는 Lovable 프로젝트 코드를 자체 GitHub 또는 GitLab 저장소에 자동 양방향 동기화로 보관하여 코드 백업, 개발자 협업, IDE 작업, 어디에나 배포를 가능하게 합니다.
Lovable 프로젝트 코드를 GitHub 또는 GitLab에 동기화하기
Git 동기화는 Lovable 프로젝트 코드를 자체 GitHub 또는 GitLab 저장소에 자동 양방향 동기화로 보관하여 코드 백업, 개발자 협업, IDE 작업, 어디에나 배포를 가능하게 합니다.
Lovable로 빌드하면 프로젝트 코드가 Lovable 플랫폼 안에 저장·관리됩니다. Git 동기화는 Lovable 프로젝트를 본인이 소유한 GitHub 또는 GitLab 저장소에 연결하고 둘을 자동으로 동기화합니다. Lovable에서 변경한 내용이 저장소에 commit되고 동기화된 branch에 푸시된 commit이 Lovable 프로젝트로 다시 반영됩니다.
Lovable을 사용하는 데 Git이 필요하지는 않습니다. 많은 사용자가 Lovable 내에서 완전히 빌드하고 출시합니다. 코드 사본만 필요하다면 코드 에디터를 열고 파일 트리 사이드바 하단의 Download codebase를 클릭하세요(유료 플랜).
이 페이지는 Git 동기화가 제공자 전반에서 어떻게 작동하는지 설명합니다. 설정 단계는 제공자별 페이지를 참고하세요.
- GitHub(github.com, data residency를 갖춘 GitHub Enterprise Cloud, 또는 GitHub Enterprise Server)
- GitLab(GitLab.com 또는 self-managed GitLab 인스턴스)
앱이 GitHub REST API를 호출해 저장소, 이슈, pull request를 읽게 하고 싶다면 GitHub API 커넥터를 사용하세요.
프로젝트를 Git 저장소에 동기화하는 이유
- 코드 백업. 본인이 통제하는 계정에서 프로젝트를 Lovable 외부에 안전하게 저장합니다.
- 개발자와 협업. Lovable에서 빌드하면서 branch, pull 또는 merge request, 코드 리뷰를 활용합니다.
- IDE에서 로컬 작업. 저장소를 clone하여 로컬에서 편집·commit하고 푸시합니다. 변경 사항이 Lovable로 다시 동기화됩니다.
- Lovable 외부에 배포. 셀프 호스팅하거나 다른 플랫폼에 배포합니다. 배포·호스팅·소유권 옵션을 참고하세요.
- 자체 인프라에 코드 사본 보관. data residency를 갖춘 GitHub Enterprise Cloud, GitHub Enterprise Server(둘 다 Enterprise 플랜), 또는 self-managed GitLab 인스턴스에 동기화합니다.
Git 동기화 작동 방식
Git 동기화는 GitHub와 GitLab 모두에서 두 계층으로 구성됩니다.
- 워크스페이스 연결은 Lovable이 Git 계정, 조직, 그룹, 인스턴스에 접근하도록 인가합니다. 연결은 워크스페이스에 속하며 그 안의 어떤 프로젝트에서도 재사용할 수 있습니다. 하나의 워크스페이스는 GitHub와 GitLab 연결을 동시에 포함해 여러 연결을 가질 수 있습니다.
- 프로젝트 저장소 링크는 하나의 Lovable 프로젝트를 그 연결 중 하나 아래의 하나의 저장소에 연결합니다. 프로젝트를 링크하면 새 저장소가 생성되고 양방향 동기화가 자동으로 시작됩니다.
링크되면 다음과 같습니다.
- Lovable에서 편집한 내용이 저장소에 commit·푸시됩니다.
- 동기화된 branch에 푸시된 commit이 Lovable 프로젝트로 다시 반영됩니다.
- Lovable은 한 번에 하나의 branch만 편집하고 동기화합니다. 다른 branch의 commit은 동기화된 branch에 병합하거나 동기화 branch를 전환하기 전까지 Lovable에 나타나지 않습니다. 두 제공자 모두 Lovable에서 branch를 전환하고 새 branch를 만들 수 있습니다.
역할별 권한
- 워크스페이스 owner와 admin은 워크스페이스 연결을 추가·업데이트·삭제합니다.
- 워크스페이스 또는 프로젝트 owner와 admin은 프로젝트를 연결·연결 해제합니다.
- Editor 이상은 동기화 상태를 보고 동기화된 저장소로 작업합니다.
각 작업의 정확한 역할 요구사항은 제공자별 페이지에 나열되어 있습니다.
제공자 선택
각 프로젝트는 하나의 제공자에 있는 하나의 저장소에 링크됩니다. 두 제공자 모두 동일한 핵심 양방향 동기화를 지원합니다.
| GitHub | GitLab | |
|---|---|---|
| 호스팅 서비스 | github.com(모든 플랜) | GitLab.com(모든 플랜) |
| 자체 인프라 | data residency를 갖춘 GitHub Enterprise Cloud, 또는 GitHub Enterprise Server(둘 다 Enterprise 플랜) | self-managed GitLab 인스턴스(모든 플랜) |
| 연결 방식 | Lovable GitHub 앱(Enterprise Server에서는 자체 사본) | GitLab 계정으로 OAuth |
| 동기화 branch | 활성 branch: Lovable에서 branch 전환·생성 | 활성 branch: Lovable에서 branch 전환·생성 |
| 저장소 이름 변경 | 자동으로 따라감 | 동기화 중단 |
팀이 이미 이 플랫폼 중 하나를 사용한다면 그 플랫폼을 사용하세요.
연결 해제와 재연결
프로젝트 연결을 해제하면 동기화만 중지되고 그 밖에는 아무 일도 없습니다.
- 저장소는 모든 기록·파일과 함께 GitHub나 GitLab에 그대로 남습니다.
- 프로젝트와 코드는 Lovable에 유지됩니다. 이후 변경 사항은 Lovable 안에만 저장됩니다.
나중에 프로젝트를 재연결하면 Lovable이 현재 버전의 프로젝트로 새 저장소를 만듭니다. 원래 저장소는 계정에 그대로 남지만 더 이상 링크되지 않습니다.
제한 사항
다음은 두 제공자 모두에 적용됩니다.
- 내보내기만 가능. 기존 저장소를 Lovable로 가져올 수 없습니다. 프로젝트를 연결하면 항상 새 저장소가 생성됩니다.
- 프로젝트당 하나의 저장소. 각 Lovable 프로젝트는 정확히 하나의 저장소에 링크됩니다.
- 한 번에 하나의 branch. 동기화된 branch만 Lovable로 다시 반영됩니다.
- 저장소를 그 자리에 유지. 연결된 저장소(또는 그것이 속한 계정, 조직, 그룹)의 이름을 바꾸거나 이동하거나 삭제하지 마세요. 그렇게 하면 동기화가 중단됩니다.
- 재연결 시 새 저장소 생성. 이전에 연결 해제한 저장소를 다시 링크할 수 없습니다.