프로젝트를 GitLab에 연결하기
Lovable 프로젝트를 GitLab.com 또는 셀프 매니지드 GitLab 인스턴스에 연결하여 코드 백업, 협업 및 배포하세요.
GitLab은 코드를 저장, 관리 및 공유하기 위한 플랫폼입니다. 버전 관리, CI/CD 파이프라인, Merge Request를 통한 코드 리뷰, 인기 있는 배포 도구와의 통합을 제공합니다.
GitLab 커넥터를 사용하면 앱에서 다음을 수행할 수 있습니다
- 코드 백업: Lovable 외부에서 프로젝트를 안전하게 저장합니다.
- 쉬운 협업: 개발자를 초대하고, Merge Request, 브랜치 및 코드 리뷰를 사용합니다.
- 자동 동기화: Lovable의 편집이 GitLab에 나타나고, GitLab의 변경 사항이 기본 브랜치(보통
main)에서 다시 동기화됩니다. - 로컬 작업: 프로젝트를 동기화 상태로 유지하면서 IDE에서 클론, 편집 및 커밋합니다.
- 어디서나 배포: 셀프 호스팅하거나 대체 플랫폼에 배포합니다. Lovable Cloud 배포/호스팅/소유권 옵션을 참조하세요.
- 회사 인프라 사용: GitLab Self-Managed를 사용하면 코드를 조직의 자체 서버 내에 완전히 보관할 수 있습니다.
Lovable을 사용하는 데 GitLab이 필요하지 않습니다. 많은 사용자가 Lovable 내에서 완전히 빌드하고 출시합니다.
GitLab 연결 방식
Lovable은 단일 통합 커넥터를 통해 두 가지 GitLab 연결 유형을 지원합니다
- GitLab.com은 GitLab Inc.에서 관리하는 호스팅 서비스입니다.
- GitLab Self-Managed는 조직이 자체 서버에서 운영하는 GitLab 인스턴스에 연결할 수 있습니다.
GitLab 커넥터를 열면 설정할 유형을 선택합니다. 두 유형 모두 Lovable과 GitLab 저장소 간의 동일한 양방향 동기화를 지원합니다.
Lovable 워크스페이스 내에서
- 여러 GitLab 연결을 생성할 수 있습니다.
- 각 연결은 GitLab 인스턴스의 네임스페이스(개인 계정 또는 그룹)에 연결됩니다.
- 동일한 GitLab 계정 또는 인스턴스에서 여러 네임스페이스를 연결할 수 있습니다.
- 각 Lovable 프로젝트는 해당 네임스페이스 중 하나의 저장소에 연결할 수 있습니다.
GitLab 연결 방법
워크스페이스 관리자 및 소유자가 GitLab 커넥터를 관리할 수 있으며, 여기에는 연결 추가, 프로젝트 연결 또는 연결 해제가 포함됩니다. 편집자 역할의 사용자는 프로젝트를 연결하거나 연결 해제할 수 있습니다.
사전 요구 사항
- gitlab.com 또는 셀프 매니지드 인스턴스의 GitLab 계정.
- Lovable 워크스페이스 관리자 또는 소유자 역할.
- GitLab Self-Managed의 경우: OAuth 애플리케이션을 생성할 수 있는 GitLab 인스턴스 관리자 접근 권한과 Lovable의 IP 범위에서의 네트워크 접근.
연결하기 전에
- 단일 진실 소스: 연결되면 코드는 Lovable이 아닌 GitLab에 있습니다.
- 양방향 동기화: Lovable의 편집이 GitLab에 나타나고, 그 반대도 마찬가지입니다.
- 안정적인 저장소 경로: 연결은 정확한 GitLab 프로젝트 이름, 네임스페이스 및 인스턴스 URL에 따라 달라집니다.
연결 후 GitLab 프로젝트의 이름을 바꾸거나, 이동하거나, 삭제하지 마세요. 그렇게 하면 동기화가 중단되고 Lovable이 프로젝트를 업데이트할 수 없게 됩니다.
단계 1: GitLab 연결 설정
GitLab.com은 GitLab Inc.에서 관리하는 호스팅 서비스입니다.
GitLab 커넥터로 이동
설정 → 커넥터 → 공유 커넥터로 이동하여 GitLab을 선택합니다.
새 연결 추가
Add connection을 클릭하고 GitLab.com을 선택합니다.
GitLab 계정 인가
GitLab의 인가 페이지로 팝업이 열립니다. 로그인하고 Lovable을 인가하여 GitLab 계정에 접근을 허용합니다.
Lovable은 api 스코프를 요청하며, 이는 프로젝트 생성, 웹훅 구성, 브랜치 관리 및 Merge Request 열기에 필요합니다.
네임스페이스 선택
프로젝트 저장소가 위치할 곳을 선택합니다
- 개인 계정 또는 GitLab 그룹 중 하나를 선택합니다.
- 사용하려는 네임스페이스 옆의 Connect를 클릭합니다.
동일한 GitLab 계정에서 여러 네임스페이스(개인 계정 및 그룹)를 연결할 수 있습니다.
동일한 개인 계정 또는 그룹을 두 번 이상 연결할 수 없습니다.
GitLab Self-Managed는 자체 GitLab 서버를 운영하고 코드를 내부 인프라 내에 보관해야 하는 조직을 위한 것입니다.
GitLab 커넥터로 이동
설정 → 커넥터 → 공유 커넥터로 이동하여 GitLab을 선택합니다.
새 연결 추가
Add connection을 클릭하고 GitLab Self-Managed를 선택합니다.
Lovable의 IP 범위 허용
Lovable이 코드를 동기화하고 웹훅 이벤트를 수신하려면 GitLab 인스턴스에 접근해야 합니다. 설정 마법사에 인스턴스가 방화벽으로 보호되는 경우 허용 목록에 추가해야 하는 IP CIDR 범위가 표시됩니다. 각 범위를 복사하여 네트워크 방화벽 또는 GitLab의 IP 허용 목록 설정에 추가하세요.
GitLab 인스턴스에서 OAuth 애플리케이션 생성
GitLab 인스턴스에서 관리자 영역 → 애플리케이션 (또는 사용자 수준 앱의 경우 설정 → 애플리케이션)으로 이동하여 새 애플리케이션을 생성합니다
- 이름: Lovable (또는 설명이 포함된 이름)
- 리다이렉트 URI: Lovable 설정 마법사에 표시된 URI를 사용합니다 (예:
https://lovable.dev/gitlab/callback) - 스코프:
api - 기밀: 예
애플리케이션을 저장하고 Application ID와 Secret을 기록합니다.
Application Secret을 기밀로 유지하세요. 이 시크릿은 사용자를 대신하여 GitLab 인스턴스에 접근할 수 있는 권한을 부여합니다.
Lovable에서 연결 구성
Lovable 설정 마법사로 돌아가서 다음을 입력합니다
- GitLab URL: 인스턴스 URL (예:
https://gitlab.yourcompany.com) - Application ID: 생성한 OAuth 앱의 클라이언트 ID
- Application secret: OAuth 앱의 클라이언트 시크릿
- 그룹 경로 (선택 사항): 특정 그룹에 접근을 제한하려면 그룹 경로를 입력합니다 (예:
my-org/my-team)
Continue를 클릭합니다.
GitLab 계정 인가
셀프 매니지드 GitLab 인스턴스의 인가 페이지로 팝업이 열립니다. 로그인하고 Lovable을 인가합니다. Lovable은 api 스코프를 요청합니다.
네임스페이스 선택
인스턴스 내에서 개인 계정 또는 GitLab 그룹 중 하나를 선택한 다음 Connect를 클릭합니다.
단계 2: 프로젝트를 GitLab에 연결
활성 GitLab 연결이 있으면 편집자 이상이 Lovable 프로젝트를 GitLab 저장소에 연결할 수 있습니다. 각 Lovable 프로젝트는 하나의 연결된 저장소를 가질 수 있습니다.
프로젝트 설정 열기
설정 → 커넥터 → GitLab으로 이동하여 Connect project를 클릭하거나, 프로젝트 오른쪽 상단의 GitLab 아이콘을 클릭합니다.
네임스페이스 선택
저장소를 생성할 네임스페이스(개인 계정 또는 그룹)를 선택합니다.
전송 확인
전송을 확인합니다. 새 GitLab 프로젝트가 생성되고 양방향 동기화가 자동으로 시작됩니다.
GitLab에서 프로젝트 연결 해제
워크스페이스 관리자와 소유자는 프로젝트의 GitLab 설정에서 언제든지 모든 프로젝트의 GitLab 연결을 해제할 수 있습니다.
연결을 해제하면
- 동기화 중지: Lovable과 GitLab 간의 양방향 연결이 종료됩니다.
- 저장소는 GitLab에 유지: 모든 기록과 파일이 그대로 유지됩니다.
- 코드는 Lovable에 유지: 향후 변경 사항은 Lovable 내에만 저장됩니다.
나중에 다시 연결하면
- 최신 Lovable 코드를 사용하여 새 GitLab 저장소가 생성됩니다.
- 원래 저장소는 GitLab에 남아 있지만 더 이상 Lovable에 연결되지 않습니다.
Lovable이 GitLab 저장소에 연결할 수 없는 경우 (예: 이름이 바뀌거나, 이동되거나, 삭제된 경우) 프로젝트 연결을 해제할 수 없습니다.
제한 사항
GitLab 커넥터는 현재 다음을 지원하지 않습니다
- 기존 GitLab 저장소를 Lovable로 가져오기. Lovable에서 GitLab으로만 내보낼 수 있습니다.
- 기본 브랜치(보통
main) 이외의 브랜치 동기화. - 연결 해제 후 동일한 저장소에 다시 연결. 다시 연결 시 새 저장소가 생성됩니다.
GitLab 연결에서 프로젝트 연결 해제 방법
편집자 이상은 연결 자체를 삭제하지 않고 연결에서 특정 프로젝트를 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
프로젝트 연결을 해제하려면
커넥터로 이동
설정 → 커넥터 → 공유 커넥터로 이동하여 GitLab을 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
연결된 프로젝트 아래에서 연결을 해제할 프로젝트를 선택합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결이 해제되면 해당 프로젝트는 이 연결을 통해 더 이상 GitLab에 접근할 수 없습니다. 프로젝트에 다시 GitLab이 필요한 경우 사용 가능한 연결에 연결할 수 있습니다.
GitLab 연결 삭제 방법
워크스페이스 관리자와 소유자가 GitLab 연결을 삭제할 수 있습니다.
연결 삭제는 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 자격 증명이 제거되며, 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동이 중지됩니다.
삭제하기 전에 연결된 프로젝트 섹션을 검토하여 현재 이 연결을 사용 중인 프로젝트를 확인하세요.
연결을 삭제하려면
커넥터로 이동
설정 → 커넥터 → 공유 커넥터로 이동하여 GitLab을 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토
연결된 프로젝트 섹션을 검토합니다.
삭제
이 연결 삭제 아래에서 Delete를 클릭하고 확인합니다.