GitLab

GitLab은 GitLab에서 개발한 DevOps 도구입니다. GitLab 서버에서 프로젝트를 복제하고 Git을 사용하여 로컬 및 원격 저장소를 관리할 수 있습니다.

GitLab을 사용하려면 GitLab 서버에 연결을 설정하고 작업할 프로젝트를 복제하십시오. 이전에 복제한 프로젝트를 프로젝트 설정에서 GitLab에 연결하면 ‘버전 관리’ 보기에서 이벤트 알림을 받을 수 있습니다.

GitLab 서버에 연결하기

GitLab 서버에 연결하려면 서버 호스트 이름과 포트 번호, 그리고 GitLab에서 Qt Creator 용으로 생성한 액세스 토큰을 지정해야 합니다. 토큰의 권한 범위는 최소한 read_api 또는 api 이어야 합니다.

GitLab 서버 연결을 지정하려면 Preferences > Version Control > GitLab 로 이동하십시오:

GitLab 서버를 추가하려면:

1. Add 를 선택하여 Add Server 대화 상자를 엽니다.

   

2. ' Host'에서 GitLab 서버의 호스트 이름을 입력합니다.
3. ' Description'에서 연결된 프로젝트의 GitLab 설정에 표시될 자유 형식 텍스트를 입력합니다.
4. ' Access token'에서 GitLab 서버의 ' Preferences ' > ' Access Tokens'에서 Qt Creator 용으로 생성한 액세스 토큰을 입력합니다.
5. Port 에서 포트 번호를 입력합니다.
6. 보안 연결 대신 HTTP 연결을 사용하려면 ‘ HTTPS ’을 비워 둡니다.
7. Add 을 선택하여 연결을 생성합니다.

GitLab 탭에서, curl 는 HTTP 연결에 사용되는 curl 도구의 경로를 표시합니다. Qt Creator 가 찾은 것 이외의 도구 인스턴스를 사용하려면 다른 경로를 지정하십시오.

선택한 연결을 편집하려면 [ Edit]을 선택하십시오.

선택한 연결을 제거하려면 ‘ Remove ’을 선택하십시오.

프로젝트 복제

연결된 GitLab 서버에서 프로젝트를 복제할 수 있습니다. Qt Creator 은 액세스 토큰에서 사용자 이름과 ID를 읽어와 각 서버에서 사용 가능한 프로젝트를 표시합니다. 특정 프로젝트를 검색하거나 목록에서 프로젝트를 찾아볼 수 있습니다.

GitLab에서 프로젝트를 복제하려면:

1. Tools > GitLab 로 이동하여 연결된 GitLab 서버 목록과 각 서버에서 사용 가능한 프로젝트 목록을 확인합니다.

   

2. Remote 에서 GitLab 서버를 선택합니다.
3. Projects 에서 복제할 프로젝트를 선택합니다.
4. Clone 를 선택하여 Clone Repository 대화 상자를 엽니다.

   

5. Repository 에서 저장소의 URL을 지정합니다.
6. Path 에서 저장소를 복제할 경로를 지정합니다.
7. Directory 에서 복제된 저장소의 디렉터리 이름을 지정합니다.
8. Recursive 을 선택하면 저장소의 하위 모듈도 함께 복제할 수 있습니다.
9. Clone 을 선택하여 프로젝트를 지정된 디렉터리에 복제합니다.

Qt Creator 프로젝트가 자동으로 열립니다. 복제된 프로젝트에 여러 프로젝트 파일(예: CMakeList.txt, .pro, .qbs)이 있는 경우, Qt Creator 에서 열 파일을 선택하라는 메시지가 표시됩니다. Qt Creator 에서 열 수 있는 프로젝트 파일이 없는 경우, File > New Project > Import Project > Import Existing Project 로 이동하여 프로젝트를 일반 프로젝트로 가져오십시오.