인스턴스를 위한 프로젝트 템플릿
GitLab v19.1Offering: GitLab Self-Managed, GitLab Dedicated
프로젝트 템플릿은 새 프로젝트에 파일과 구성을 채워 넣습니다. 인스턴스에서 프로젝트 생성 속도를 높이려면 템플릿 프로젝트가 포함된 그룹을 구성하세요. 템플릿 프로젝트에서 복사되는 데이터에 대한 자세한 내용은 템플릿에서 복사되는 항목을 참조하세요.
프로젝트 템플릿은 새 프로젝트에 파일과 구성을 채워 넣습니다. 인스턴스에서 관리하는 그룹으로부터 커스텀 프로젝트 템플릿을 구성하고, 기본 제공 프로젝트 템플릿을 사용자에게 제공할지 여부를 제어할 수 있습니다.
커스텀 프로젝트 템플릿#
인스턴스에서 프로젝트 생성 속도를 높이려면 템플릿 프로젝트가 포함된 그룹을 구성하세요. 그러면 사용자는 지정한 공통 도구와 구성이 포함된 템플릿 기반의 새 프로젝트를 생성할 수 있습니다.
템플릿 프로젝트에서 복사되는 데이터에 대한 자세한 내용은 템플릿에서 복사되는 항목을 참조하세요.
인스턴스에서 템플릿 프로젝트를 사용할 수 있도록 설정하기 전에, 템플릿을 관리할 그룹을 선택하세요. 템플릿의 예기치 않은 변경을 방지하려면 기존 그룹을 재사용하지 말고 이 용도로 새 그룹을 만드세요. 다른 용도로 생성된 기존 그룹을 재사용하면, Maintainer 권한이 있는 사용자가 부작용을 인식하지 못한 채 템플릿 프로젝트를 수정할 수 있습니다.
템플릿 프로젝트를 관리할 그룹 선택#
사전 요구 사항:
- 관리자 액세스 권한.
인스턴스의 프로젝트 템플릿을 관리할 그룹을 선택하려면:
-
오른쪽 상단 모서리에서 Admin을 선택합니다.
-
왼쪽 사이드바에서 Settings > Templates를 선택합니다.
-
Custom project templates를 펼칩니다.
-
사용할 그룹을 선택합니다.
-
Save changes를 선택합니다.
그룹을 프로젝트 템플릿의 소스로 구성하면, 이 그룹에 추가된 새 프로젝트가 템플릿으로 사용 가능해집니다.
프로젝트를 템플릿으로 사용하도록 구성#
템플릿 프로젝트를 관리할 그룹을 만든 후에는 각 템플릿 프로젝트의 가시성과 기능 사용 가능 여부를 구성하세요.
사전 요구 사항:
-
인스턴스의 관리자이거나 프로젝트를 구성할 수 있는 권한이 있는 사용자여야 합니다.
-
프로젝트가 하위 그룹이 아닌 해당 그룹에 직접 속해 있어야 합니다. 선택한 그룹의 하위 그룹에 속한 프로젝트는 템플릿으로 사용할 수 없습니다.
-
프로젝트 템플릿을 선택할 수 있는 사용자를 구성하려면 프로젝트 가시성을 설정하세요:
Public 및 Internal 프로젝트는 인증된 모든 사용자가 선택할 수 있습니다.
-
Private 프로젝트는 해당 프로젝트의 멤버만 선택할 수 있습니다.
-
프로젝트의 기능 설정을 검토하세요. GitLab Pages 및 Security and compliance를 제외한 모든 활성화된 프로젝트 기능은 Everyone With Access로 설정해야 합니다.
각 새 프로젝트로 복사되는 리포지터리와 데이터베이스 정보는 GitLab 프로젝트 가져오기 및 내보내기로 내보낸 데이터와 동일합니다. 여기에는 템플릿 프로젝트의 전체 Git 커밋 히스토리가 포함됩니다. 자세한 내용은 파일 내보내기를 사용하여 GitLab 데이터 마이그레이션을 참조하세요.
커밋 히스토리 없이 템플릿을 만들려면, 포함할 모든 파일이 담긴 단일 커밋으로 템플릿 프로젝트를 초기화하세요.
기본 제공 프로젝트 템플릿#
이 기능의 사용 가능 여부는 기능 플래그에 의해 제어됩니다. 자세한 내용은 히스토리를 참조하세요. 이 기능은 테스트용으로만 사용 가능하며 프로덕션 환경에서 사용할 준비가 되어 있지 않습니다.
기본 제공 프로젝트 템플릿은 새 프로젝트에 스타터 파일을 채워 넣습니다. 기본적으로 이 템플릿은 모든 사용자에게 제공됩니다. 관리자는 인스턴스에 대해 이 설정을 끌 수 있으며, 선택적으로 그룹 Owner가 이를 재정의하지 못하도록 적용할 수 있습니다. 그룹 Owner도 그룹에 대한 이 설정을 제어할 수 있습니다.
이 설정은 계단식 상속을 사용합니다:
-
기본적으로 루트 그룹은 인스턴스 값을 상속합니다.
-
하위 그룹은 가장 가까운 상위 그룹의 값을 상속합니다.
-
그룹별 값은 상속된 값을 재정의합니다.
-
인스턴스에 설정을 적용하면 모든 그룹이 이를 상속합니다.
-
그룹에 설정을 적용하면 모든 하위 그룹이 이를 상속합니다.
-
인스턴스 설정을 변경하면 새 값이 모든 그룹에 계단식으로 적용됩니다.
-
그룹 설정을 변경하면 새 값이 모든 하위 그룹에 계단식으로 적용됩니다.
기본 제공 프로젝트 템플릿 구성#
사전 요구 사항:
- 관리자여야 합니다.
인스턴스의 기본 제공 프로젝트 템플릿을 제어하려면:
-
오른쪽 상단 모서리에서 Admin을 선택합니다.
-
Settings > Templates를 선택합니다.
-
Built-in project templates를 펼칩니다.
-
Enable built-in project templates 체크박스를 선택하거나 선택 해제합니다.
-
선택 사항. 그룹이 이 설정을 변경하지 못하도록 하려면 Enforce for all groups 체크박스를 선택합니다.
-
Save changes를 선택합니다.