프로젝트를 GitHub에 연결하기

Lovable 프로젝트를 GitHub에 연결, 동기화 및 연결 해제하여 코드 백업, 협업 및 배포하는 방법을 알아보세요.

Lovable로 빌드하면 코드가 Lovable 플랫폼 내에 저장됩니다 — 대부분의 크리에이터에게 완벽합니다.

자체 복사본을 원하거나, 개발자와 협업하거나, 프로젝트를 다른 곳으로 이동하려면 몇 번의 클릭만으로 모든 것을 GitHub로 내보내고 동기화할 수 있습니다.

GitHub 소개

GitHub는 코드를 저장, 관리 및 공유하기 위한 클라우드 기반 플랫폼입니다. 모든 변경 사항을 추적하고, 협업을 지원하며, Vercel 및 Netlify와 같은 인기 있는 배포 도구와 통합됩니다. 개발자를 위해 만들어진 코드용 Google Drive라고 생각하세요.

Lovable을 GitHub에 연결하는 이유

Lovable 프로젝트를 GitHub에 연결하면:

• 코드 백업: Lovable 외부에서 프로젝트를 안전하게 저장합니다.
• 쉬운 협업: 개발자를 초대하고, pull request, 브랜치 및 코드 리뷰를 사용합니다.
• 자동 동기화: Lovable의 편집이 GitHub에 나타나고, GitHub의 변경 사항이 기본 브랜치 (main)에서 다시 동기화됩니다.
• 로컬 작업: 프로젝트를 동기화 상태로 유지하면서 IDE에서 클론, 편집 및 커밋합니다.
• 어디서나 배포: 셀프 호스팅하거나 대체 플랫폼에 배포합니다. 셀프 호스팅: Lovable Cloud 프로젝트를 어디서나 실행하기를 참조하세요.
• 안전하게 테스트: 설정 → 계정 → Labs에서 실험적인 GitHub 브랜치 전환을 활성화하여 라이브 프로젝트에 변경 사항을 병합하기 전에 기능을 개발합니다. 자세한 내용은 Labs를 참조하세요.

연결하기 전에

통합이 어떻게 작동하는지 이해하세요:

• GitHub 계정 필요: github.com에서 무료로 생성하세요.
• 단일 진실 소스: 연결되면 코드는 Lovable이 아닌 GitHub에 있습니다.
• 양방향 동기화: Lovable의 편집이 GitHub에 나타나고, 그 반대도 마찬가지입니다.
• 안정적인 저장소 경로: 연결은 정확한 GitHub 저장소 이름, 위치, 조직 및 계정에 따라 달라집니다.

GitHub 통합 설정

워크스페이스 관리자 및 소유자만 GitHub 통합을 관리할 수 있으며, 여기에는 계정 및 조직 추가, 프로젝트 연결 또는 연결 해제가 포함됩니다.

GitHub 연결은 세 단계로 진행됩니다:

1. GitHub 계정 연결 (OAuth 인가)
2. 계정 또는 조직에 Lovable GitHub App 설치
3. 저장소에 개별 프로젝트 연결

단계 1: GitHub 계정 연결

이 단계는 OAuth 인가를 통해 GitHub 신원을 Lovable에 연결합니다.

1. 설정 → 커넥터 → GitHub로 이동합니다.
2. Connect GitHub를 클릭합니다.
3. GitHub 계정에 로그인하거나 lovable.dev를 인가하여 GitHub 신원을 확인합니다.
   그러면 프로젝트를 연결하는 옵션이 표시됩니다.

단계 2: Lovable GitHub 앱 설치

이 단계는 GitHub 계정 또는 조직에 Lovable GitHub App을 설치하고 Lovable이 해당 위치에서 저장소를 생성하고 업데이트할 수 있는 권한을 부여합니다.

개인 GitHub 계정이나 관리자 권한이 있는 조직에 앱을 설치할 수 있습니다.

1. 설정 → 커넥터 → GitHub로 이동합니다.
2. Connect project를 클릭합니다.
3. Add organizations를 클릭하고 lovable.dev를 설치하고 인가할 위치를 선택합니다 — 개인 계정 또는 조직 중 하나.
4. 모든 저장소 또는 선택된 저장소만에 접근 권한을 부여할지 선택합니다.
5. Install & Authorize를 클릭하여 Lovable에 선택한 계정 또는 조직에서 저장소를 생성하고 업데이트할 수 있는 권한을 부여합니다.

단계 3: 프로젝트를 GitHub에 연결

이 단계는 특정 Lovable 프로젝트를 GitHub 저장소에 연결합니다. 각 Lovable 프로젝트는 하나의 연결된 저장소를 가질 수 있습니다.

1. 설정 → 커넥터 → GitHub로 이동하여 Connect project를 클릭하거나, 프로젝트 오른쪽 상단의 GitHub 아이콘을 클릭한 다음 Connect GitHub를 클릭합니다.
2. 코드가 저장될 GitHub 조직 또는 계정을 선택합니다.
3. Transfer anyway를 클릭하여 전송을 확인하고 양방향 동기화를 설정합니다.
   프로젝트에 대한 새 GitHub 저장소가 생성되고 동기화가 자동으로 시작됩니다.

GitHub에서 프로젝트 연결 해제

워크스페이스 관리자와 소유자는 프로젝트의 GitHub 설정에서 언제든지 GitHub에서 프로젝트 연결을 해제할 수 있습니다.

연결을 해제하면:

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

나중에 다시 연결하면:

• 최신 Lovable 코드를 사용하여 새 GitHub 저장소가 생성됩니다.
• 원래 저장소는 GitHub에 남아 있지만 더 이상 Lovable에 연결되지 않습니다.

FAQ