Knowledge Base Help Center
GitLab 프로젝트 설정
프로젝트 관리자와 관리자 만 프로젝트 설정에 액세스 할 수있는 권한 이 있습니다.
GitLab 의 설정 페이지는 프로젝트 구성 옵션을 위한 중앙 집중식 홈을 제공합니다 . 액세스하려면 프로젝트 홈페이지로 이동하고 왼쪽 탐색 메뉴에서 설정을 클릭 합니다 . 복잡성을 줄이기 위해 설정은 주제별로 섹션으로 그룹화됩니다. 섹션의 모든 설정을 표시하려면 확장을 클릭 합니다.
GitLab 버전 13.10 이상 에서 GitLab은 보려는 설정을 찾는 데 도움이되는 검색 상자를 표시합니다.
일반 설정
프로젝트의 일반 설정에서 프로젝트의 기능과 관련된 모든 것을 찾을 수 있습니다.
일반 프로젝트 설정
프로젝트 이름, 설명, 아바타, 기본 브랜치 및 주제를 조정합니다.
프로젝트 설명은 부분적으로 표준 Markdown을 지원합니다 . 당신은 사용할 수 있습니다 강조 , 링크 , 그리고 행 구분을 프로젝트 설명에 더 많은 컨텍스트를 추가 할 수 있습니다.
규정 준수 프레임 워크 프리미엄
버전 기록
프레임 워크 레이블을 만들어 프로젝트에 특정 규정 준수 요구 사항이 있거나 추가 감독이 필요함을 식별 할 수 있습니다.
그룹 소유자는 설정 > 일반 으로 이동하고 준수 프레임 워크 섹션을 확장하여 준수 프레임 워크를 생성, 편집 및 삭제할 수 있습니다 . 생성 된 규정 준수 프레임 워크는 그룹 또는 하위 그룹 내의 프로젝트 설정 페이지를 통해 원하는 수의 프로젝트에 할당 할 수 있습니다.GraphQL을 통해 하위 그룹에서 규정 준수 프레임 워크를 만들려고하면 사용자에게 올바른 권한이있는 경우 프레임 워크가 루트 조상에서 생성됩니다. 웹 UI는이 동작을 방지하기 위해 읽기 전용보기를 제공합니다.
규정 준수 파이프 라인 구성 최고의
버전 기록이 기능은 사용하지 못할 수 있습니다. 자세한 내용은 위 의 버전 기록 참고를 확인 하십시오.
그룹 소유자는 규정 준수 파이프 라인 구성을 사용하여 스캔 또는 테스트와 같은 규정 준수 요구 사항을 정의하고 개별 프로젝트에 적용 할 수 있습니다.
사용자 정의 준수 프레임 워크의 기능은 그룹 소유자가 개발자의 프로젝트를 구별 전용 프로젝트 저장 및 관리 규정 준수 파이프 라인 구성의 위치를 지정할 수 있습니다.
규정 준수 파이프 라인 구성 필드를 설정할 때 file@group/project형식을 사용하십시오 . 예를 들어 .compliance-gitlab-ci.yml@compliance-group/compliance-project. 이 필드는 규정 준수 프레임 워크 레이블이 적용된 프로젝트에 상속됩니다. 그 결과 프로젝트가 규정 준수 구성을 실행하게됩니다.
커스텀 라벨이있는 프로젝트가 파이프 라인을 실행하면 규정 준수 파이프 라인 구성을 평가하는 것으로 시작됩니다. 그런 다음 사용자 지정 파이프 라인 구성은 포함 된 개별 프로젝트 구성을 실행할 수 있습니다.
프로젝트에서 파이프 라인을 실행하는 사용자는 최소한 규정 준수 프로젝트에 대한 Reporter 액세스 권한이 있어야합니다.
예 .compliance-gitlab-ci.yml
stages: # Allows compliance team to control the ordering and interweaving of stages/jobs
- pre-compliance
- build
- test
- pre-deploy-compliance
- deploy
- post-compliance
variables: # can be overriden by a developer's local .gitlab-ci.yml
FOO: sast
sast: # none of these attributes can be overriden by a developer's local .gitlab-ci.yml
variables:
FOO: sast
stage: pre-compliance
script:
- echo "running $FOO"
sanity check:
stage: pre-deploy-compliance
script:
- echo "running $FOO"
audit trail:
stage: post-compliance
script:
- echo "running $FOO"
include: # Execute individual project's configuration
project: '$CI_PROJECT_PATH'
file: '$CI_PROJECT_CONFIG_PATH'
공유 및 권한
저장소의 경우 공개 액세스, 저장소 기능, 문서, 액세스 권한 등과 같은 기능을 설정할 수 있습니다. 프로젝트에서이를 수행하려면 설정 > 일반으로 이동 하여 가시성, 프로젝트 기능, 권한 섹션을 확장 하십시오.
이제 프로젝트 가시성을 변경할 수 있습니다 . 프로젝트 가시성 을 공개로 설정 하면 일부 기능에 대한 액세스를 프로젝트 구성원 만로 제한 할 수 있습니다 . 또한 사용자가 액세스를 요청 하도록 허용 옵션을 선택할 수 있습니다 .
스위치를 사용하여 다음 기능을 활성화 또는 비활성화합니다.
| 선택권 | 더 많은 액세스 제한 옵션 | 기술 |
|---|---|---|
| 이슈 | ✓ | GitLab 문제 추적기를 활성화합니다. |
| 저장소 | ✓ | 리포지토리 기능 활성화 |
| 병합 요청 | ✓ | 병합 요청 기능을 활성화합니다 . 병합 요청 설정 참조 |
| 포크 | ✓ | 분기 기능 활성화 |
| 파이프 라인 | ✓ | CI / CD 기능 활성화 |
| Container Registry | Docker 이미지에 대한 레지스트리 를 활성화합니다. | |
| Git 대용량 파일 저장소 | 대용량 파일 사용 가능 | |
| 패키지 | 패키지 레지스트리 기능 구성 지원 | |
| 해석학 | ✓ | 분석 가능 |
| 위키 | ✓ | 문서화를 위한 별도의 시스템 활성화 |
| 짧은 발췌 | ✓ | 코드 및 텍스트 공유 가능 |
| 페이지 | ✓ | 정적 웹 사이트 를 게시 할 수 있습니다. |
| 메트릭 대시 보드 | ✓ | 메트릭 대시 보드에 대한 액세스 제어 |
| 요구 사항 | ✓ | 요구 사항 관리에 대한 액세스 제어 |
| 운영 대시 보드 | ✓ | 운영 대시 보드에 대한 액세스 제어 |
일부 기능은 다른 기능에 따라 다릅니다.
- 문제 옵션 을 비활성화하면 GitLab은 다음 기능도 제거합니다.
- 이슈 보드
- 서비스 데스크
- 또한 Issues 및 Merge Requests를 모두 비활성화하면 다음에 액세스 할 수 없습니다.
- 라벨
- 마일스톤
- 당신이하지 않으면 저장소 기능을 GitLab 또한 프로젝트에 대한 다음과 같은 기능을 비활성화합니다 :
- 병합 요청
- 파이프 라인
- Container Registry
- Git 대용량 파일 저장소
- 패키지
- 메트릭 대시 보드 액세스를 위해서는 프로젝트 환경과 배포를 모두 읽어야합니다. 메트릭 대시 보드에 대한 액세스 권한이있는 사용자는 환경 및 배포에도 액세스 할 수 있습니다.
CVE ID 요청 버튼 비활성화
GitLab 13.4에 도입 되었으며 GitLab.com의 공개 프로젝트에만 해당됩니다.
해당 환경에서 Create CVE ID Request 버튼 이 이슈 사이드 바에 있습니다. 이 버튼은 이슈 사이드 바에서 Enable CVE ID requests 설정을 토글하여 프로젝트별로 비활성화 할 수 있습니다 .
이메일 알림 비활성화
프로젝트 소유자는 이메일 알림 비활성화 확인란 을 선택하여 프로젝트와 관련된 모든 이메일 알림을 비활성화 할 수 있습니다 .
병합 요청 설정
프로젝트의 병합 요청 설정을 지정합니다.
- 병합 요청 방법 (병합 커밋, 빨리 감기 병합 )을 설정합니다.
- 병합 요청 설명 템플릿을 추가합니다 .
- 병합 요청 승인을 활성화합니다 .
- 파이프 라인이 성공한 경우에만 병합을 활성화 합니다 .
- 모든 스레드가 해결 된 경우에만 병합을 활성화합니다 .
- 기본적으로 활성화
delete source branch after merge옵션 - 제안 된 변경 사항 커밋 메시지 구성
- 포크에서 오는 병합 요청에 대한 기본 대상 프로젝트 를 구성 하십시오 .
서비스 데스크
프로젝트에 대해 Service Desk 를 활성화 하여 고객 지원을 제공합니다.
수출 프로젝트
GitLab 에서 프로젝트 를 내보내는 방법을 알아 봅니다 .
고급 설정
여기에서 하우스 키핑, 보관, 이름 바꾸기, 전송, 포크 관계 제거 또는 프로젝트 제거를 실행할 수 있습니다 .
프로젝트 보관
프로젝트를 보관하면 모든 사용자에게 읽기 전용이되고 더 이상 적극적으로 유지 관리되지 않음을 나타냅니다. 보관 된 프로젝트도 보관 취소 할 수 있습니다. 프로젝트 소유자와 관리자 만 프로젝트 를 보관할 권한 이 있습니다.
프로젝트가 보관되면 저장소, 패키지, 이슈, 병합 요청 및 기타 모든 기능이 읽기 전용입니다. 보관 된 프로젝트는 프로젝트 목록에서도 숨겨집니다.
프로젝트를 보관하려면 :
- 프로젝트의 설정> 일반으로 이동합니다 .
- 에서 고급 , 클릭 확장합니다 .
- 에서 아카이브 프로젝트 섹션을 클릭 아카이브 프로젝트 버튼을 누릅니다.
- 요청되면 조치를 확인하십시오.
프로젝트 보관 취소
프로젝트 보관을 취소하면 프로젝트에 대한 읽기 전용 제한이 제거되고 프로젝트 목록에서 사용할 수 있습니다. 프로젝트 소유자와 관리자 만 프로젝트 보관을 취소 할 수있는 권한 이 있습니다.
보관 된 프로젝트를 찾으려면 :
- 프로젝트 소유자 또는 관리자 권한이있는 사용자로 GitLab에 로그인합니다.
- 만약 너라면:
- 프로젝트의 URL을 가지고 브라우저에서 프로젝트 페이지를 엽니 다.
- 프로젝트의 URL이없는 경우 : 1. 프로젝트> 프로젝트 탐색을 클릭 합니다 . 1. 프로젝트 정렬 드롭 다운 상자에서 보관 된 프로젝트 표시를 선택 합니다 . 1. 이름으로 필터링 필드에 프로젝트 이름을 입력합니다. 1. 프로젝트에 대한 링크를 클릭하여 세부 정보 페이지 를 엽니 다 .
다음으로 프로젝트 보관을 취소하려면 :
- 프로젝트의 설정> 일반으로 이동합니다 .
- 에서 고급 , 클릭 확장합니다 .
- 에서 보관 취소 프로젝트 섹션을 클릭 보관 취소 프로젝트 버튼을 누릅니다.
- 요청되면 조치를 확인하십시오.
저장소 이름 바꾸기
프로젝트 관리자와 관리자 만 저장소 이름을 바꿀 수있는 권한 이 있습니다. 일반 프로젝트 설정 에서 변경할 수있는 프로젝트 이름과 혼동하지 마십시오 .
프로젝트의 저장소 이름은 URL (브라우저를 통해 프로젝트에 액세스하는 데 사용하는 URL)과 GitLab이 설치된 파일 디스크의 위치를 정의합니다.
저장소 이름을 바꾸려면 :
- 프로젝트의 설정> 일반으로 이동합니다 .
- 에서 고급 , 클릭 확장합니다 .
- 아래 경로 변경 , 저장소의 경로를 업데이트합니다.
- 경로 변경을 클릭 합니다 .
이전 URL을 가진 모든 사람이 푸시하거나 가져올 수 없으므로 의도하지 않은 부작용이 발생할 수 있습니다. 리포지토리의 이름을 변경할 때 리디렉션이 어떻게되는지 자세히 알아보세요 .
기존 프로젝트를 다른 네임 스페이스로 전송
프로젝트 소유자와 관리자 만 프로젝트 를 전송할 수있는 권한 이 있습니다.
다음과 같은 경우 기존 프로젝트를 그룹 으로 전송할 수 있습니다 .
- 해당 그룹에 대해 최소한 유지 관리자 권한 이 있습니다.
- 이전 할 프로젝트 의 소유자 이상 입니다.
- 프로젝트가 전송되는 그룹은 새 프로젝트 생성을 허용해야합니다.
프로젝트를 전송하려면 :
- 프로젝트의 설정> 일반으로 이동합니다 .
- 에서 고급 , 클릭 확장합니다 .
- “프로젝트 전송”에서 프로젝트를 전송할 네임 스페이스를 선택합니다.
- 지시에 따라 프로젝트의 경로를 입력하여 전송을 확인합니다.
완료되면 새 프로젝트의 네임 스페이스로 리디렉션됩니다. 이 시점 에서 이전 프로젝트에서 새 프로젝트로의 리디렉션이 어떻게되는지 읽어보십시오 .GitLab 관리자는 필요한 경우 관리 인터페이스를 사용하여 프로젝트를 네임 스페이스로 이동할 수 있습니다.
프로젝트 삭제
프로젝트 소유자와 관리자 만 프로젝트 를 삭제할 수있는 권한 이 있습니다.
프로젝트를 삭제하려면 :
- 프로젝트로 이동하고 설정> 일반> 고급을 선택 합니다 .
- “프로젝트 삭제”섹션에서 프로젝트 삭제 버튼을 클릭 합니다.
- 요청되면 조치를 확인하십시오.
이 조치 :
- 모든 관련 리소스 (이슈, 병합 요청 등)를 포함하는 프로젝트를 삭제합니다.
- 에서 GitLab 13.2 에 프리미엄 이상 계층, 그룹 소유자는 수 구성 지연 기간 이후 삭제 될 그룹 내에서 프로젝트를. 활성화하면 인스턴스 설정에 지정된 일 수 후에 실제 삭제가 발생합니다 .
GitLab 12.6에서 지연된 프로젝트 삭제 의 기본 동작이 GitLab 13.2에서 즉시 삭제 로 변경되었습니다 .
프로젝트 복원 프리미엄
GitLab 12.6에 도입 되었습니다.
삭제 표시된 프로젝트를 복원하려면 :
- 프로젝트로 이동하고 설정> 일반> 고급을 선택 합니다 .
- 프로젝트 복원 섹션에서 프로젝트 복원 버튼을 클릭 합니다.
포크 관계 제거
포크는 회원이 아닌 프로젝트 에 기여할 수 있는 좋은 방법 입니다. 포크를 직접 사용하고 업스트림 프로젝트에 병합 요청 을 보낼 필요가없는 경우 포크 관계를 안전하게 제거 할 수 있습니다.일단 제거되면 포크 관계를 복원 할 수 없습니다. 소스에 병합 요청을 보낼 수 없으며 누군가가 프로젝트를 분기 한 경우 해당 분기도 관계를 잃습니다.
그렇게하려면 :
- 프로젝트의 설정> 일반> 고급으로 이동 합니다 .
- 에서 제거 포크 관계 는 마찬가지로 표지 버튼을 클릭합니다.
- 지시에 따라 프로젝트의 경로를 입력하여 작업을 확인합니다.
프로젝트 소유자 만 포크 관계를 삭제할 수있는 권한 이 있습니다.
작업 설정
경고
경고 통합 을 구성 하여 응용 프로그램의 중요한 문제를 경고 로 분류하고 관리 합니다 .
사건
경고 통합
GitLab 알림을 기반으로 인시던트를 자동으로 생성 , 알림 및 해결 합니다.
PagerDuty 통합
각 PagerDuty 사건에 대해 GitLab에서 사건을 생성 합니다.
사건 설정
SLA 카운트 다운 타이머를 사용하여 인시던트 에 대한 서비스 수준 계약을 관리 합니다.
오류 추적
GitLab 내에서 Sentry 오류 를 발견하고 볼 수 있도록 오류 추적을 구성 합니다.
Jaeger 추적 최고의
사용자가 GitLab 내에서 Jaeger UI 에 쉽게 액세스 할 수 있도록 Jaeger 서버의 URL을 추가하십시오 .
상태 페이지
배포 된 상태 페이지 에 공개 문제를 동기화 할 수 있도록 저장소 자격 증명 을 추가 합니다 .