GitHub에 프로젝트 동기화하기

Lovable 프로젝트 코드를 github.com, GitHub Enterprise Cloud, GitHub Enterprise Server에 내보내고 양방향 동기화하여 코드 백업, 협업, 배포에 활용하는 방법을 알아보세요.

Lovable로 빌드하면 프로젝트 코드가 Lovable 플랫폼 안에 저장·관리됩니다.

GitHub는 코드를 호스팅·관리하고 협업하는 플랫폼으로 버전 관리, pull request와 코드 리뷰, GitHub Actions를 통한 CI/CD를 제공합니다.

자체 복사본이 필요하거나 개발자와 협업할 계획이거나 프로젝트를 다른 곳으로 옮기려면 프로젝트를 GitHub에 내보내고 동기화할 수 있습니다. 코드를 백업하고, pull request에서 변경 사항을 검토하고, IDE에서 로컬로 작업하고, branch에서 기능을 테스트하고, Lovable 외부에 배포하세요. Enterprise 플랜에서는 GitHub Enterprise로 자체 인프라 안에 코드 사본을 보관할 수도 있습니다.

Git 동기화가 무엇인지, 공급자 전반에서 양방향 동기화 모델이 어떻게 작동하는지, GitHub와 GitLab 중 무엇을 선택할지에 대한 전체 그림은 Git 동기화 개요를 참조하세요.

GitHub Git 동기화 작동 방식

Lovable의 GitHub 통합은 두 계층으로 구성됩니다.

1. 워크스페이스 연결
2. 프로젝트 저장소 링크

워크스페이스 연결

워크스페이스 연결은 Lovable GitHub 앱을 통해 Lovable이 GitHub 계정 또는 조직에 접근하도록 인가합니다. 이 인가는 선택한 계정 또는 조직에서 Lovable이 저장소를 생성·업데이트할 권한을 부여합니다.

워크스페이스 연결은 워크스페이스 전체에서 공유되며 여러 프로젝트가 재사용할 수 있습니다.

하나의 워크스페이스에는 다음이 포함될 수 있습니다.

• 여러 GitHub 연결
• 여러 GitHub 계정과 조직
• 여러 GitHub 연결 유형

팀이 개인 계정, 고객사 계정, 여러 조직에 걸쳐 작업할 때 유용합니다.

프로젝트 저장소 링크

프로젝트 저장소 링크는 하나의 Lovable 프로젝트를 하나의 GitHub 저장소에 연결합니다.

연결되면 다음이 이루어집니다.

• Lovable에서 변경한 내용이 GitHub에 동기화됩니다.
• 활성 GitHub branch에 푸시된 변경 사항이 Lovable로 다시 동기화됩니다.
• Lovable은 한 번에 하나의 branch만 편집하고 동기화합니다.

GitHub Git 동기화 연결 유형

Lovable은 세 가지 GitHub 연결 유형을 지원합니다.

• github.com(모든 플랜에서 사용 가능)
  대부분의 팀이 사용하는 표준 호스팅 GitHub 플랫폼입니다. Lovable이 GitHub 앱 설치를 대신 관리합니다.
• GitHub Enterprise Cloud - Data residency(Enterprise 플랜에서 사용 가능)
  *.ghe.com 호스트네임을 사용하는 GitHub Enterprise Cloud로 저장소 데이터가 특정 리전에 머무릅니다. Lovable이 GitHub 앱 설치를 대신 관리합니다.
• GitHub Enterprise Server(Enterprise 플랜에서 사용 가능)
  조직이 통제하는 인프라에서 실행되는 셀프 호스팅 GitHub입니다. 이 구성에서는 GitHub 조직 안에 Lovable GitHub 앱의 자체 사본을 직접 만들므로 자격 증명이 조직의 통제 아래 유지됩니다.

새 연결을 추가할 때 설정할 유형을 선택합니다. 세 유형 모두 Lovable과 GitHub 저장소 사이에서 동일한 양방향 동기화, branch 작업, pull request 생성을 지원합니다.

GitHub 통합의 역할 기반 접근 권한

워크스페이스 GitHub 연결 만들기

워크스페이스 관리자와 소유자는 다음 경로에서 워크스페이스 연결을 만들 수 있습니다.

• Workspace settings → Git → GitHub → Add connection
• Project settings → Git → GitHub → Add connection(프로젝트가 아직 연결되지 않은 경우)

기존 GitHub 설치를 사용하려면 사용할 계정 또는 조직 옆의 Connect를 클릭하세요. 목록에는 GitHub 신원으로 접근할 수 있는 계정과 조직의 설치가 표시됩니다.

새 연결을 설정하려면 연결 유형에 맞는 단계를 따르세요.

• github.com
• GitHub Enterprise Cloud (data residency)
• GitHub Enterprise Server

프로젝트를 GitHub 저장소에 연결하기

활성 워크스페이스 GitHub 연결이 있으면 워크스페이스 또는 프로젝트 관리자와 소유자가 Lovable 프로젝트를 GitHub 저장소에 연결할 수 있습니다.

• 프로젝트를 연결하면 새 GitHub 저장소가 생성됩니다. 저장소는 기본적으로 비공개이므로 GitHub에서 공개 설정을 변경하지 않는 한 아무도 코드를 볼 수 없습니다.
• 각 Lovable 프로젝트는 하나의 저장소에 연결할 수 있습니다.

프로젝트 저장소 동기화 관리

프로젝트를 GitHub 저장소에 연결한 뒤 프로젝트의 GitHub 설정에서 다음을 볼 수 있습니다.

• Connected로 표시되는 저장소 상태
• 활성 branch 이름이 있는 branch 선택기(Lovable과 동기화된 GitHub branch)
• Clone URL(HTTPS, SSH, GitHub CLI)
• View on GitHub 옵션(드롭다운에서 제공)
• Disconnect 옵션(드롭다운에서 제공)

Lovable은 한 번에 하나의 branch만 편집하고 동기화합니다. 기본값은 저장소의 default branch(보통 main)입니다. 현재 활성 branch에 푸시된 변경 사항이 Lovable로 다시 동기화됩니다.

브랜치 전환

1. branch 선택기를 클릭합니다.
2. branch를 검색하거나 선택합니다.
3. branch를 클릭해 전환합니다.

Lovable이 즉시 전환한 branch를 편집하고 동기화하기 시작합니다.

언제든지 default branch로 다시 전환할 수 있습니다.

새 브랜치 만들기

1. branch 선택기를 클릭합니다.
2. 목록 하단의 + Create branch를 클릭합니다.
3. branch 이름을 입력합니다. Lovable이 빈 이름, 잘못된 문자, 중복 여부를 검증합니다.

   branch 이름은 Git 이름 규칙을 따라야 합니다(공백, .., 앞뒤 점이나 대시, ~ ^ : ? * [ ] \ 같은 특수문자 금지).

새 branch는 현재 활성 branch를 소스로 하여 생성됩니다(대화상자에 Source: <active branch>로 표시됨). Lovable이 자동으로 새 branch로 전환하여 편집하고 동기화하기 시작합니다.

저장소 로컬 clone

프로젝트를 연결한 뒤 Lovable은 다음에 대한 clone URL을 제공합니다.

• HTTPS
• SSH
• GitHub CLI

저장소를 로컬에 clone하여 선호하는 IDE에서 작업을 이어갈 수 있습니다.

GitHub에서 저장소 보기

Project settings → Git → GitHub에서 동기화된 저장소를 GitHub에서 바로 열 수 있습니다.

저장소 연결 드롭다운의 View on GitHub를 사용하세요. GitHub가 새 탭에서 열립니다.

Commit 저작자 표시

Lovable이 만든 commit은 Lovable GitHub 앱 신원으로 작성됩니다.

• github.com과 GitHub Enterprise Cloud는 lovable-dev[bot]
• GitHub Enterprise Server는 <your-app-name>[bot]

commit은 GitHub의 noreply 이메일 형식을 사용하여 commit을 유발한 Lovable 사용자에게도 공동 저작자로 표시됩니다.

GitHub 저장소에서 프로젝트 연결 해제

연결 해제는 Lovable 프로젝트와 GitHub 저장소 사이의 동기화 관계를 제거합니다.

연결을 해제하면 다음과 같습니다.

• 동기화가 중지됩니다. Lovable과 GitHub 사이의 양방향 연결이 종료됩니다.
• 저장소는 GitHub에 유지됩니다. 모든 기록과 파일이 그대로 남습니다.
• 프로젝트와 코드는 Lovable에 유지됩니다. 이후 변경 사항은 Lovable 안에만 저장됩니다.

프로젝트를 연결 해제해도 워크스페이스 연결 자체는 제거되지 않습니다.

저장소 연결을 해제하는 방법은 두 가지입니다.

• 프로젝트 GitHub 설정에서 연결 해제
• 워크스페이스 GitHub 설정에서 연결 해제

프로젝트에 GitHub가 다시 필요하면 사용 가능한 연결 중 하나에 링크할 수 있습니다. 나중에 재연결하면 다음과 같습니다.

• Lovable이 현재 버전의 프로젝트로 새 저장소를 만듭니다.
• 원래 저장소는 GitHub에 그대로 남지만 더 이상 Lovable에 링크되지 않습니다.

워크스페이스 GitHub Git 동기화 연결 삭제

워크스페이스 관리자와 소유자가 GitHub 연결을 삭제할 수 있습니다.

워크스페이스 GitHub 연결을 삭제하면 다음과 같습니다.

• 모든 프로젝트에서 연결이 제거됩니다.
• 링크된 프로젝트의 동기화가 중지됩니다.
• GitHub의 저장소는 삭제되지 않습니다.
• 저장된 자격 증명이 삭제됩니다.
• GitHub Enterprise Server의 경우 연결을 삭제하면 저장된 GitHub 앱 서명 키의 파기도 예약됩니다.

제한 사항

GitHub Git 동기화 통합은 현재 다음을 지원하지 않습니다.

• 기존 GitHub 저장소를 Lovable로 가져오기. Lovable에서 GitHub로 내보내는 것만 가능합니다.
• 연결 해제 후 동일한 저장소에 재연결하기. 재연결 시 새 저장소가 생성됩니다.
• 동일한 계정 또는 조직에 Lovable GitHub 앱을 여러 번 설치하기.

문제 해결

문제가 발생하면 Lovable이 해당 프로젝트의 GitHub 설정에 Reconnect 안내를 표시합니다.

워크스페이스 연결 문제

이 문제는 워크스페이스 수준의 GitHub 연결 자체에 영향을 주므로 해결책은 보통 해당 연결에 링크된 모든 프로젝트에 적용됩니다.

워크스페이스 소유자나 관리자가 영향을 받는 프로젝트 중 하나에서 한 번만 해결하면 같은 연결의 다른 프로젝트도 자동으로 재개됩니다.

프로젝트 저장소 문제

이 문제는 단일 프로젝트와 저장소의 링크에 영향을 줍니다.

워크스페이스 또는 프로젝트 관리자와 소유자가 프로젝트의 GitHub 설정에서 해결할 수 있습니다.

FAQ

관련 주제

• Lovable 프로젝트 코드를 GitHub 또는 GitLab에 동기화하기
• GitHub API에 앱 연결하기
• GitLab에 앱 연결하기
• Lovable Cloud 외부 배포·호스팅 가이드
• FAQ