InfoGrab Docs

그룹의 사용자 정의 프로젝트 템플릿

요약

프로젝트를 생성할 때 템플릿 목록에서 선택할 수 있습니다. 그룹의 모든 프로젝트가 동일한 목록을 갖도록 사용 가능한 템플릿 목록을 사용자 정의할 수 있습니다. 인스턴스용 사용자 정의 템플릿도 구성할 수 있습니다. 그룹에서 사용자 정의 프로젝트 템플릿을 설정하려면 프로젝트 템플릿이 포함된 서브그룹을 그룹 설정에 추가합니다:

히스토리
  • 그룹 외부 컨텍스트에서 그룹 템플릿을 탐색할 수 있는 그룹 선택기가 GitLab 18.11에서 constrain_group_project_templates라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화.
  • 그룹 컨텍스트 외부에서 그룹 템플릿을 탐색하기 위한 그룹 선택기가 GitLab 19.0에서 일반 공개되었습니다. 기능 플래그 constrain_group_project_templates 제거됨.

프로젝트를 생성할 때 템플릿 목록에서 선택할 수 있습니다. GitLab Pages나 Ruby 같은 것들을 위한 이 템플릿은 새 프로젝트에 템플릿에 포함된 파일의 복사본을 채웁니다. 이 정보는 GitLab 프로젝트 가져오기/내보내기에 사용되는 정보와 동일하며 새 프로젝트를 더 빠르게 시작하는 데 도움이 될 수 있습니다.

그룹의 모든 프로젝트가 동일한 목록을 갖도록 사용 가능한 템플릿 목록을 사용자 정의할 수 있습니다. 이를 위해 템플릿으로 사용할 프로젝트로 서브그룹을 채웁니다.

인스턴스용 사용자 정의 템플릿도 구성할 수 있습니다.

그룹에 프로젝트 템플릿 설정#

사전 요구 사항:

  • 그룹에 대한 Owner 권한이 있어야 합니다.

그룹에서 사용자 정의 프로젝트 템플릿을 설정하려면 프로젝트 템플릿이 포함된 서브그룹을 그룹 설정에 추가합니다:

  1. 그룹에서 서브그룹을 생성합니다.
  2. 템플릿으로 사용할 새 서브그룹에 프로젝트를 추가합니다.
  3. 그룹의 왼쪽 메뉴에서 Settings > General을 선택합니다.
  4. Custom project templates를 펼치고 서브그룹을 선택합니다.

다음에 그룹 구성원이 프로젝트를 생성할 때 서브그룹의 프로젝트 중 하나를 선택할 수 있습니다.

중첩된 서브그룹의 프로젝트는 템플릿 목록에 포함되지 않습니다.

템플릿으로 사용 가능한 프로젝트#

  • GitLab Pages 및 Security and compliance를 제외한 모든 프로젝트 기능이 Everyone With Access로 설정된 경우 공개 및 내부 프로젝트는 인증된 모든 사용자가 새 프로젝트의 템플릿으로 선택할 수 있습니다.
  • 비공개 프로젝트는 해당 프로젝트의 구성원인 사용자만 선택할 수 있습니다.

그룹 컨텍스트 외부에서 프로젝트를 생성할 때 템플릿을 탐색하기 전에 드롭다운 목록에서 그룹을 선택해야 합니다. 액세스 권한이 있는 그룹만 나열됩니다.

구조 예시#

myorganization에 대한 프로젝트 템플릿의 샘플 그룹 및 프로젝트 구조입니다:

# GitLab instance and group
gitlab.com/myorganization/
    # Subgroups
    internal
    tools
    # Subgroup for handling project templates
    websites
        templates
            # Project templates
            client-site-django
            client-site-gatsby
            client-site-html

        # Other projects
        client-site-a
        client-site-b
        client-site-c
        ...

템플릿에서 복사되는 항목#

템플릿에서 프로젝트를 생성하면 내보낼 수 있는 모든 프로젝트 항목이 템플릿에서 새 프로젝트로 복사됩니다. 이 항목에는 다음이 포함됩니다:

  • 저장소 브랜치, 커밋 및 태그.
  • 프로젝트 업로드.
  • 프로젝트 구성.
  • 이슈와 머지 리퀘스트 및 댓글, 기타 메타데이터.
  • 레이블, 마일스톤, 스니펫 및 릴리스.
  • CI/CD 파이프라인 구성.

복사되는 항목의 전체 목록은 내보내는 프로젝트 항목을 참조하세요.

권한 및 민감한 데이터#

복사 동작은 권한에 따라 다를 수 있습니다:

  • 인스턴스의 사용자 정의 템플릿이 포함된 프로젝트에 대한 Owner 권한이 있거나 GitLab 관리자인 경우: 프로젝트 구성원을 포함한 모든 프로젝트 설정이 새 프로젝트로 복사됩니다.
  • 프로젝트에 대한 Owner 권한이 없거나 GitLab 관리자가 아닌 경우: 프로젝트 배포 키와 프로젝트 웹훅은 민감한 데이터를 포함하고 있어 복사되지 않습니다.

템플릿의 사용자 할당#

다른 사용자가 만든 템플릿을 사용하면 템플릿에서 사용자에게 할당된 항목이 귀하에게 재할당됩니다. 보호된 브랜치 및 태그 같은 보안 기능을 구성할 때 이 재할당을 이해하는 것이 중요합니다. 예를 들어 템플릿에 보호된 브랜치가 포함된 경우:

  • 템플릿에서 브랜치는 템플릿 소유자가 기본 브랜치에 머지할 수 있도록 허용합니다.
  • 템플릿에서 생성된 프로젝트에서 브랜치는 귀하가 기본 브랜치에 머지할 수 있도록 허용합니다.

문제 해결#

관리자가 프로젝트 생성 시 그룹의 사용자 정의 프로젝트 템플릿을 볼 수 없음#

그룹의 사용자 정의 프로젝트 템플릿은 그룹 구성원에게만 사용 가능합니다. 사용 중인 관리자 계정이 그룹의 구성원이 아닌 경우 템플릿에 액세스할 수 없습니다.

그룹의 사용자 정의 프로젝트 템플릿

Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기
요약

프로젝트를 생성할 때 템플릿 목록에서 선택할 수 있습니다. 그룹의 모든 프로젝트가 동일한 목록을 갖도록 사용 가능한 템플릿 목록을 사용자 정의할 수 있습니다. 인스턴스용 사용자 정의 템플릿도 구성할 수 있습니다. 그룹에서 사용자 정의 프로젝트 템플릿을 설정하려면 프로젝트 템플릿이 포함된 서브그룹을 그룹 설정에 추가합니다:

히스토리
  • 그룹 외부 컨텍스트에서 그룹 템플릿을 탐색할 수 있는 그룹 선택기가 GitLab 18.11에서 constrain_group_project_templates라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화.
  • 그룹 컨텍스트 외부에서 그룹 템플릿을 탐색하기 위한 그룹 선택기가 GitLab 19.0에서 일반 공개되었습니다. 기능 플래그 constrain_group_project_templates 제거됨.

프로젝트를 생성할 때 템플릿 목록에서 선택할 수 있습니다. GitLab Pages나 Ruby 같은 것들을 위한 이 템플릿은 새 프로젝트에 템플릿에 포함된 파일의 복사본을 채웁니다. 이 정보는 GitLab 프로젝트 가져오기/내보내기에 사용되는 정보와 동일하며 새 프로젝트를 더 빠르게 시작하는 데 도움이 될 수 있습니다.

그룹의 모든 프로젝트가 동일한 목록을 갖도록 사용 가능한 템플릿 목록을 사용자 정의할 수 있습니다. 이를 위해 템플릿으로 사용할 프로젝트로 서브그룹을 채웁니다.

인스턴스용 사용자 정의 템플릿도 구성할 수 있습니다.

그룹에 프로젝트 템플릿 설정#

사전 요구 사항:

  • 그룹에 대한 Owner 권한이 있어야 합니다.

그룹에서 사용자 정의 프로젝트 템플릿을 설정하려면 프로젝트 템플릿이 포함된 서브그룹을 그룹 설정에 추가합니다:

  1. 그룹에서 서브그룹을 생성합니다.
  2. 템플릿으로 사용할 새 서브그룹에 프로젝트를 추가합니다.
  3. 그룹의 왼쪽 메뉴에서 Settings > General을 선택합니다.
  4. Custom project templates를 펼치고 서브그룹을 선택합니다.

다음에 그룹 구성원이 프로젝트를 생성할 때 서브그룹의 프로젝트 중 하나를 선택할 수 있습니다.

중첩된 서브그룹의 프로젝트는 템플릿 목록에 포함되지 않습니다.

템플릿으로 사용 가능한 프로젝트#

  • GitLab Pages 및 Security and compliance를 제외한 모든 프로젝트 기능이 Everyone With Access로 설정된 경우 공개 및 내부 프로젝트는 인증된 모든 사용자가 새 프로젝트의 템플릿으로 선택할 수 있습니다.
  • 비공개 프로젝트는 해당 프로젝트의 구성원인 사용자만 선택할 수 있습니다.

그룹 컨텍스트 외부에서 프로젝트를 생성할 때 템플릿을 탐색하기 전에 드롭다운 목록에서 그룹을 선택해야 합니다. 액세스 권한이 있는 그룹만 나열됩니다.

구조 예시#

myorganization에 대한 프로젝트 템플릿의 샘플 그룹 및 프로젝트 구조입니다:

# GitLab instance and group
gitlab.com/myorganization/
    # Subgroups
    internal
    tools
    # Subgroup for handling project templates
    websites
        templates
            # Project templates
            client-site-django
            client-site-gatsby
            client-site-html

        # Other projects
        client-site-a
        client-site-b
        client-site-c
        ...

템플릿에서 복사되는 항목#

템플릿에서 프로젝트를 생성하면 내보낼 수 있는 모든 프로젝트 항목이 템플릿에서 새 프로젝트로 복사됩니다. 이 항목에는 다음이 포함됩니다:

  • 저장소 브랜치, 커밋 및 태그.
  • 프로젝트 업로드.
  • 프로젝트 구성.
  • 이슈와 머지 리퀘스트 및 댓글, 기타 메타데이터.
  • 레이블, 마일스톤, 스니펫 및 릴리스.
  • CI/CD 파이프라인 구성.

복사되는 항목의 전체 목록은 내보내는 프로젝트 항목을 참조하세요.

권한 및 민감한 데이터#

복사 동작은 권한에 따라 다를 수 있습니다:

  • 인스턴스의 사용자 정의 템플릿이 포함된 프로젝트에 대한 Owner 권한이 있거나 GitLab 관리자인 경우: 프로젝트 구성원을 포함한 모든 프로젝트 설정이 새 프로젝트로 복사됩니다.
  • 프로젝트에 대한 Owner 권한이 없거나 GitLab 관리자가 아닌 경우: 프로젝트 배포 키와 프로젝트 웹훅은 민감한 데이터를 포함하고 있어 복사되지 않습니다.

템플릿의 사용자 할당#

다른 사용자가 만든 템플릿을 사용하면 템플릿에서 사용자에게 할당된 항목이 귀하에게 재할당됩니다. 보호된 브랜치 및 태그 같은 보안 기능을 구성할 때 이 재할당을 이해하는 것이 중요합니다. 예를 들어 템플릿에 보호된 브랜치가 포함된 경우:

  • 템플릿에서 브랜치는 템플릿 소유자가 기본 브랜치에 머지할 수 있도록 허용합니다.
  • 템플릿에서 생성된 프로젝트에서 브랜치는 귀하가 기본 브랜치에 머지할 수 있도록 허용합니다.

문제 해결#

관리자가 프로젝트 생성 시 그룹의 사용자 정의 프로젝트 템플릿을 볼 수 없음#

그룹의 사용자 정의 프로젝트 템플릿은 그룹 구성원에게만 사용 가능합니다. 사용 중인 관리자 계정이 그룹의 구성원이 아닌 경우 템플릿에 액세스할 수 없습니다.