프로젝트 General 설정
프로젝트의 일반 설정에서 프로젝트의 기능과 관련된 모든 것을 찾을 수 있습니다.
일반 프로젝트 설정#
프로젝트의 이름, 설명, 아바타, 기본 브랜치 및 토픽을 조정합니다.
프로젝트 설명은 부분적으로 표준 Markdown을 지원합니다. 강조, 링크 및 줄 바꿈을 사용하여 프로젝트 설명에 더 많은 컨텍스트를 추가할 수 있습니다.
Topics#
Topics를 사용하여 프로젝트를 분류하고 유사한 새 프로젝트를 찾습니다.
프로젝트에 Topic을 할당하려면:
- 상단 표시줄에서 Menu > Projects를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- Topics 아래에 프로젝트 주제를 입력합니다. 입력할 때 Existing popular topics가 제안됩니다.
- Save changes를 선택합니다.
공유 및 권한#
리포지토리의 경우 공개 액세스, 리포지토리 기능, 문서, 액세스 권한 등과 같은 기능을 설정할 수 있습니다. 프로젝트에서 그렇게 하려면, Settings > General로 이동하여 Visibility, project features, permissions 섹션을 확장합니다.
이제 프로젝트 가시성을 변경할 수 있습니다. Project visibility을 비공개로 설정하면 일부 기능에 대한 액세스를 프로젝트 구성원 전용으로 제한할 수 있습니다. 또한 사용자가 액세스를 요청하도록 허용 옵션을 선택할 수 있습니다.
스위치를 사용하여 다음 기능을 활성화 또는 비활성화합니다.
| 옵션 | 더 많은 액세스 제한 옵션 | 설명 |
|---|---|---|
| Issues | ✓ | GitLab 이슈 트래커 활성화 |
| Repository | ✓ | 리포지토리 기능 활성화 |
| Merge Requests | ✓ | 병합 요청 기능 활성화 |
| Forks | ✓ | 포킹(forking) 기능 활성화 |
| Git LFS | 대용량 파일 사용 가능 | |
| Packages | 패키지 레지스트리 기능 구성 지원 | |
| CI/CD | ✓ | CI/CD 기능 활성화 |
| Container Registry | Docker 이미지에 대한 레지스트리 활성 | |
| Analytics | ✓ | 분석 활성화 |
| Requirements | ✓ | 요구사항 관리에 대한 엑세스 제어 |
| Security & Compliance | ✓ | 보안 기능에 대한 엑세스 제어 |
| Wiki | ✓ | 문서화를 위한 별도 시스템 활성화 |
| Snippets | ✓ | 코드 및 텍스트 공유 활성화 |
| Pages | ✓ | 정적 웹사이트 게시 |
| Operations | ✓ | 운영 대시보드, 환경 및 배포, 기능 플래그를 포함한 운영 관련 기능에 대한 액세스를 제어 |
| Metrics Dashboard | ✓ | 메트릭 대시보드에 대한 액세스 제어 |
일부 기능은 다른 기능에 따라 달라집니다.
Issues 옵션을 비활성화하면, GitLab은 다음 기능도 제거합니다.
- issue boards
- Service Desk
참고
Issues 옵션이 비활성화되어도 병합 요청에서 Milestones에 계속 액세스할 수 있습니다.
또한 Issues 및 Merge Requests를 모두 비활성화하면 다음에 엑세스할 수 없습니다.
- Labels
- Milestones
Repository 기능을 활성화하면 GitLab은 프로젝트에 대해 다음 기능도 비활성화합니다.
- Merge Requests
- CI/CD
- Container Registry
- Git Large File Storage
- Packages
메트릭 대시보드에 액세스하려면 프로젝트 환경과 배포를 모두 읽어야 합니다. 메트릭 대시보드에 대한 액세스 권한이 있는 사용자는 환경 및 배포에도 액세스할 수 있습니다.
이메일 알림 비활성화#
프로젝트 Owner는 Disable email notifications 체크박스를 선택하여 프로젝트와 관련된 모든 이메일 알림을 비활성화할 수 있습니다.
병합 요청 설정#
프로젝트의 병합 요청 설정을 지정합니다.
- 병합 요청 방식(merge commit, fast-forward merge) 설정
- 병합 요청 설명 템플릿 추가
- 병합 요청 승인 활성화
- 상태 확인 활성화
- 파이프라인이 성공한 경우에만 병합 활성화
- 모든 스레드가 해결된 경우에만 병합 활성화
- 활성화하려면 Jira의 관련 이슈가 필요
- 기본적으로
delete source branch after merge옵션 활성화 - 제안된 변경사항 커밋 메시지 구성
- 병합 및 스쿼시 커밋 메시지 템플릿 구성
- 포크에서 오는 병합 요청에 대한 기본 대상 프로젝트를 구성
Advanced 설정#
여기에서 하우스키핑(housekeeping), 보관(archive), 이름 변경, 전송, 포크 관계 제거 또는 프로젝트 제거를 실행할 수 있습니다.
Housekeeping#
파일 리비전(revision) 압축 및 도달할 수 없는 개체 제거와 같은, 현재 리포지토리 내에서 여러 하우스키핑 작업을 실행합니다.
프로젝트 내보내기#
전체 프로젝트 내보내기 기능은 프로젝트 Maintainers와 Owners로 제한됩니다. 프로젝트 설정을 통해 이러한 기능을 구성할 수 있습니다.
프로젝트 및 프로젝트 데이터를 내보내려면 다음 단계를 따르십시오.
- 프로젝트 홈페이지로 이동합니다.
- 사이드 바에서 Settings을 클릭합니다.
- Advanced 섹션을 확장하고 아래로 스크롤하여 Export project 버튼을 찾습니다.
- 내보내기가 생성되면 파일을 다운로드할 수 있는 링크가 포함된 이메일을 받아야 합니다.
- 또는 프로젝트 설정으로 돌아가서 여기에서 파일을 다운로드하거나 새 내보내기를 생성할 수 있습니다. 파일을 사용할 수 있게 되면, 페이지에 Download export 버튼이 표시됩니다.
프로젝트 보관#
프로젝트를 보관하면 모든 사용자에게 읽기 전용이 되며 더 이상 적극적으로 유지 관리되지 않음을 나타냅니다. 보관된 프로젝트는 보관 취소도 할 수 있습니다. 프로젝트 소유자와 Admin만 프로젝트를 아카이브 할 수 있는 권한을 가집니다.
프로젝트가 보관되면, 리포지토리, 패키지, 이슈, 병합 요청 및 기타 모든 기능은 읽기 전용이 됩니다. 보관된 프로젝트는 프로젝트 목록에서도 숨겨집니다.
프로젝트를 보관하려면 :
- 프로젝트의 Settings > General로 이동합니다.
- Advanced 섹션에서 Expand 버튼을 클릭합니다.
- Archive project 섹션에서 Archive project 버튼을 클릭합니다.
- Confirm 창이 뜨면 확인 버튼을 클릭합니다.
프로젝트 보관 취소#
프로젝트 보관을 취소하면 프로젝트에 대한 읽기 전용 제한이 제거되고 프로젝트 목록에서 사용할 수 있습니다. 프로젝트 소유자와 관리자만 프로젝트 보관을 취소할 수 있는 권한이 있습니다.
보관된 프로젝트를 찾으려면:
- 프로젝트 소유자 또는 관리자 역할을 가진 사용자로 GitLab에 로그인합니다.
- 로그인 후:
- 프로젝트의 URL을 알고 있으면 브라우저에서 프로젝트의 페이지를 엽니다.
- 프로젝트의 URL을 모르면
- 상단 바에서 Menu > Project를 선택합니다.
- Explore projects을 선택합니다.
- Sort projects 드롭다운 상자에서 Show archived projects을 선택합니다.
- Filter by name 필드에 프로젝트 이름을 제공합니다.
- 프로젝트에 대한 링크를 클릭하여 Details 페이지를 엽니다.
다음으로 프로젝트 보관을 취소하려면:
- 프로젝트의 Settings > General 으로 이동합니다.
- Advanced에서 Expand을 클릭합니다.
- Unarchive project 섹션에서 Unarchive project 버튼을 클릭합니다.
- 메시지가 표시되면 작업을 확인합니다.
리포지토리 이름 변경#
참고 : 프로젝트 Maintainer와 Administrator만 리포지토리 이름을 변경할 수 있는 권한을 가집니다. 일반 프로젝트 설정에서 변경할 수 있는 프로젝트 이름과 혼동하지 마십시오.
프로젝트의 리포지토리 이름은 URL(브라우저를 통해 프로젝트에 액세스 하는 데 사용하는)과 GitLab이 설치된 파일 디스크의 위치를 정의합니다.
리포지토리 이름을 변경하려면 :
- 프로젝트의 Settings > General로 이동합니다.
- Advanced 섹션에서 Expand 버튼을 클릭합니다.
- Change path 아래에서 리포지토리의 경로를 업데이트합니다.
- Change path 버튼을 클릭합니다.
이전 URL을 사용하는 모든 사용자가 Push 하거나 Pull 할 수 없으므로 의도하지 않은 부작용이 발생할 수 있습니다. 리포지토리의 이름을 변경할 때 리다이렉션이 어떻게 되는지 자세히 알아보세요.
기존 프로젝트를 다른 네임스페이스로 전송#
참고 : 프로젝트 Owner와 Administrator만 프로젝트를 전송할 수 있는 권한을 가집니다.
다음과 같은 경우 기존 프로젝트를 그룹으로 전송할 수 있습니다.
- 해당 그룹에 대해 최소한 Maintainer 권한이 있습니다.
- 적어도 이전할 프로젝트의 Owner이어야 합니다.
- 프로젝트가 전송되는 그룹은 새 프로젝트 생성을 허용해야 합니다.
프로젝트를 전송하려면 :
- 프로젝트의 Settings > General로 이동합니다.
- Advanced 섹션에서 Expand 버튼을 클릭합니다.
- "Transfer project"에서 프로젝트를 전송할 네임스페이스를 선택합니다.
- Confirm 창이 뜨면 지시에 따라 프로젝트의 경로를 입력하여 전송을 확인합니다.
완료되면 새 프로젝트의 네임스페이스로 이동하게 됩니다. 이 시점에서 이전 프로젝트에서 새 프로젝트로의 리다이렉션이 어떻게 되는지 읽어보십시오.
참고 : GitLab Administrator는 Admin 인터페이스를 사용하여 필요한 경우 프로젝트를 어느 네임스페이스로든 전송할 수 있습니다.
프로젝트 삭제#
참고 : 프로젝트 Owner와 Administrator만 프로젝트를 삭제할 수 있는 권한을 가집니다.
프로젝트를 삭제하려면 :
- 상단 표시줄에서 Menu > Projects를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 Settings > General를 선택합니다.
- Advanced을 확장합니다.
- "Delete project" 섹션에서 Delete project 버튼을 클릭합니다.
- 메시지가 표시되면 작업을 확인합니다.
이 작업은 모든 관련 리소스(이슈, 병합 요청 등)를 포함하는 프로젝트를 삭제합니다.
경고 : GitLab 12.6에서 지연된 프로젝트 삭제의 기본 동작이 GitLab 13.2에서 즉시 삭제로 변경되었습니다.
포크 관계 제거#
포크는 멤버가 아닌 프로젝트에 기여할 수 있는 좋은 방법입니다. 포크를 사용하고 업스트림 프로젝트에 병합 요청을 보낼 필요가 없는 경우 포크 관계를 안전하게 제거할 수 있습니다.
경고 : 제거한 후에는 분기 관계를 복원할 수 없습니다. 소스에 병합 요청을 보낼 수 없으며 누군가 프로젝트를 분기했다면 해당 포크도 관계를 잃게 됩니다.
이렇게 하려면:
- 프로젝트의 Settings > General > Advanced 으로 이동합니다.
- Remove fork relationship 아래에서 유사하게 레이블이 지정된 버튼을 클릭하십시오.
- 지침에 따라 프로젝트 경로를 입력하여 작업을 확인합니다.
참고 : 프로젝트 소유자만 포크 관계를 제거할 수 있는 권한이 있습니다.