프로젝트 General 설정 | DevSecOps 구축 컨설팅, 교육, 기술지원 서비스 제공

프로젝트 General 설정

프로젝트의 일반 설정에서 프로젝트의 기능과 관련된 모든 것을 찾을 수 있습니다.

일반 프로젝트 설정#

프로젝트의 이름, 설명, 아바타, 기본 브랜치 및 토픽을 조정합니다.

GitLab 일반 프로젝트 설정 | 인포그랩 GitLab

프로젝트 설명은 부분적으로 표준 Markdown을 지원합니다. 강조, 링크 및 줄 바꿈을 사용하여 프로젝트 설명에 더 많은 컨텍스트를 추가할 수 있습니다.

Topics#

Topics를 사용하여 프로젝트를 분류하고 유사한 새 프로젝트를 찾습니다.

프로젝트에 Topic을 할당하려면:

  1. 상단 표시줄에서 Menu > Projects를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. Topics 아래에 프로젝트 주제를 입력합니다. 입력할 때 Existing popular topics가 제안됩니다.
  4. Save changes를 선택합니다.

공유 및 권한#

리포지토리의 경우 공개 액세스, 리포지토리 기능, 문서, 액세스 권한 등과 같은 기능을 설정할 수 있습니다. 프로젝트에서 그렇게 하려면, Settings > General로 이동하여 Visibility, project features, permissions 섹션을 확장합니다.

이제 프로젝트 가시성을 변경할 수 있습니다. Project visibility을 비공개로 설정하면 일부 기능에 대한 액세스를 프로젝트 구성원 전용으로 제한할 수 있습니다. 또한 사용자가 액세스를 요청하도록 허용 옵션을 선택할 수 있습니다.

스위치를 사용하여 다음 기능을 활성화 또는 비활성화합니다.

옵션더 많은 액세스 제한 옵션설명
IssuesGitLab 이슈 트래커 활성화
Repository리포지토리 기능 활성화
Merge Requests병합 요청 기능 활성화
Forks포킹(forking) 기능 활성화
Git LFS대용량 파일 사용 가능
Packages패키지 레지스트리 기능 구성 지원
CI/CDCI/CD 기능 활성화
Container RegistryDocker 이미지에 대한 레지스트리 활성
Analytics분석 활성화
Requirements요구사항 관리에 대한 엑세스 제어
Security & Compliance보안 기능에 대한 엑세스 제어
Wiki문서화를 위한 별도 시스템 활성화
Snippets코드 및 텍스트 공유 활성화
Pages정적 웹사이트 게시
Operations운영 대시보드, 환경 및 배포, 기능 플래그를 포함한 운영 관련 기능에 대한 액세스를 제어
Metrics Dashboard메트릭 대시보드에 대한 액세스 제어

일부 기능은 다른 기능에 따라 달라집니다.

  • Issues 옵션을 비활성화하면, GitLab은 다음 기능도 제거합니다.

    • issue boards
    • Service Desk
    참고

    Issues 옵션이 비활성화되어도 병합 요청에서 Milestones에 계속 액세스할 수 있습니다.

  • 또한 IssuesMerge 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 옵션 활성화
  • 제안된 변경사항 커밋 메시지 구성
  • 병합 및 스쿼시 커밋 메시지 템플릿 구성
  • 포크에서 오는 병합 요청에 대한 기본 대상 프로젝트를 구성
GitLab Merge Request 설정 | 인포그랩 GitLab

Advanced 설정#

여기에서 하우스키핑(housekeeping), 보관(archive), 이름 변경, 전송, 포크 관계 제거 또는 프로젝트 제거를 실행할 수 있습니다.

Housekeeping#

파일 리비전(revision) 압축 및 도달할 수 없는 개체 제거와 같은, 현재 리포지토리 내에서 여러 하우스키핑 작업을 실행합니다.

프로젝트 내보내기#

전체 프로젝트 내보내기 기능은 프로젝트 Maintainers와 Owners로 제한됩니다. 프로젝트 설정을 통해 이러한 기능을 구성할 수 있습니다.

프로젝트 및 프로젝트 데이터를 내보내려면 다음 단계를 따르십시오.

  1. 프로젝트 홈페이지로 이동합니다.
  2. 사이드 바에서 Settings을 클릭합니다.
  3. Advanced 섹션을 확장하고 아래로 스크롤하여 Export project 버튼을 찾습니다.
GitLab Export Project | 인포그랩 GitLab
  1. 내보내기가 생성되면 파일을 다운로드할 수 있는 링크가 포함된 이메일을 받아야 합니다.
GitLab Export Project 이메일 | 인포그랩 GitLab
  1. 또는 프로젝트 설정으로 돌아가서 여기에서 파일을 다운로드하거나 새 내보내기를 생성할 수 있습니다. 파일을 사용할 수 있게 되면, 페이지에 Download export 버튼이 표시됩니다.
GitLab Export Project 다운로드 | 인포그랩 GitLab

프로젝트 보관#

프로젝트를 보관하면 모든 사용자에게 읽기 전용이 되며 더 이상 적극적으로 유지 관리되지 않음을 나타냅니다. 보관된 프로젝트는 보관 취소도 할 수 있습니다. 프로젝트 소유자와 Admin만 프로젝트를 아카이브 할 수 있는 권한을 가집니다.

프로젝트가 보관되면, 리포지토리, 패키지, 이슈, 병합 요청 및 기타 모든 기능은 읽기 전용이 됩니다. 보관된 프로젝트는 프로젝트 목록에서도 숨겨집니다.

프로젝트를 보관하려면 :

  1. 프로젝트의 Settings > General로 이동합니다.
  2. Advanced 섹션에서 Expand 버튼을 클릭합니다.
  3. Archive project 섹션에서 Archive project 버튼을 클릭합니다.
  4. Confirm 창이 뜨면 확인 버튼을 클릭합니다.

프로젝트 보관 취소#

프로젝트 보관을 취소하면 프로젝트에 대한 읽기 전용 제한이 제거되고 프로젝트 목록에서 사용할 수 있습니다. 프로젝트 소유자와 관리자만 프로젝트 보관을 취소할 수 있는 권한이 있습니다.

보관된 프로젝트를 찾으려면:

  1. 프로젝트 소유자 또는 관리자 역할을 가진 사용자로 GitLab에 로그인합니다.
  2. 로그인 후:
    • 프로젝트의 URL을 알고 있으면 브라우저에서 프로젝트의 페이지를 엽니다.
    • 프로젝트의 URL을 모르면
      • 상단 바에서 Menu > Project를 선택합니다.
      • Explore projects을 선택합니다.
      • Sort projects 드롭다운 상자에서 Show archived projects을 선택합니다.
      • Filter by name 필드에 프로젝트 이름을 제공합니다.
      • 프로젝트에 대한 링크를 클릭하여 Details 페이지를 엽니다.

다음으로 프로젝트 보관을 취소하려면:

  1. 프로젝트의 Settings > General 으로 이동합니다.
  2. Advanced에서 Expand을 클릭합니다.
  3. Unarchive project 섹션에서 Unarchive project 버튼을 클릭합니다.
  4. 메시지가 표시되면 작업을 확인합니다.

리포지토리 이름 변경#

참고 : 프로젝트 Maintainer와 Administrator만 리포지토리 이름을 변경할 수 있는 권한을 가집니다. 일반 프로젝트 설정에서 변경할 수 있는 프로젝트 이름과 혼동하지 마십시오.

프로젝트의 리포지토리 이름은 URL(브라우저를 통해 프로젝트에 액세스 하는 데 사용하는)과 GitLab이 설치된 파일 디스크의 위치를 정의합니다.

리포지토리 이름을 변경하려면 :

  1. 프로젝트의 Settings > General로 이동합니다.
  2. Advanced 섹션에서 Expand 버튼을 클릭합니다.
  3. Change path 아래에서 리포지토리의 경로를 업데이트합니다.
  4. Change path 버튼을 클릭합니다.

이전 URL을 사용하는 모든 사용자가 Push 하거나 Pull 할 수 없으므로 의도하지 않은 부작용이 발생할 수 있습니다. 리포지토리의 이름을 변경할 때 리다이렉션이 어떻게 되는지 자세히 알아보세요.

기존 프로젝트를 다른 네임스페이스로 전송#

참고 : 프로젝트 Owner와 Administrator만 프로젝트를 전송할 수 있는 권한을 가집니다.

다음과 같은 경우 기존 프로젝트를 그룹으로 전송할 수 있습니다.

  • 해당 그룹에 대해 최소한 Maintainer 권한이 있습니다.
  • 적어도 이전할 프로젝트의 Owner이어야 합니다.
  • 프로젝트가 전송되는 그룹은 새 프로젝트 생성을 허용해야 합니다.

프로젝트를 전송하려면 :

  1. 프로젝트의 Settings > General로 이동합니다.
  2. Advanced 섹션에서 Expand 버튼을 클릭합니다.
  3. "Transfer project"에서 프로젝트를 전송할 네임스페이스를 선택합니다.
  4. Confirm 창이 뜨면 지시에 따라 프로젝트의 경로를 입력하여 전송을 확인합니다.

완료되면 새 프로젝트의 네임스페이스로 이동하게 됩니다. 이 시점에서 이전 프로젝트에서 새 프로젝트로의 리다이렉션이 어떻게 되는지 읽어보십시오.

참고 : GitLab Administrator는 Admin 인터페이스를 사용하여 필요한 경우 프로젝트를 어느 네임스페이스로든 전송할 수 있습니다.

프로젝트 삭제#

참고 : 프로젝트 Owner와 Administrator만 프로젝트를 삭제할 수 있는 권한을 가집니다.

프로젝트를 삭제하려면 :

  1. 상단 표시줄에서 Menu > Projects를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Settings > General를 선택합니다.
  3. Advanced을 확장합니다.
  4. "Delete project" 섹션에서 Delete project 버튼을 클릭합니다.
  5. 메시지가 표시되면 작업을 확인합니다.

이 작업은 모든 관련 리소스(이슈, 병합 요청 등)를 포함하는 프로젝트를 삭제합니다.

경고 : GitLab 12.6에서 지연된 프로젝트 삭제의 기본 동작이 GitLab 13.2에서 즉시 삭제로 변경되었습니다.

포크 관계 제거#

포크는 멤버가 아닌 프로젝트에 기여할 수 있는 좋은 방법입니다. 포크를 사용하고 업스트림 프로젝트에 병합 요청을 보낼 필요가 없는 경우 포크 관계를 안전하게 제거할 수 있습니다.

경고 : 제거한 후에는 분기 관계를 복원할 수 없습니다. 소스에 병합 요청을 보낼 수 없으며 누군가 프로젝트를 분기했다면 해당 포크도 관계를 잃게 됩니다.

이렇게 하려면:

  1. 프로젝트의 Settings > General > Advanced 으로 이동합니다.
  2. Remove fork relationship 아래에서 유사하게 레이블이 지정된 버튼을 클릭하십시오.
  3. 지침에 따라 프로젝트 경로를 입력하여 작업을 확인합니다.

참고 : 프로젝트 소유자만 포크 관계를 제거할 수 있는 권한이 있습니다.

깃랩 문서 바로가기