自定义群组级项目模板

创建项目时，您可以从模板列表中选择。这些模板（例如 GitLab Pages 或 Ruby）使用模板中包含的文件的副本填充新项目。此信息与项目导入/导出使用的信息相同，可以帮助您更快地启动新项目。

您可以可用模板的自定义列表，您群组中的所有项目都具有相同的列表。为此，您需要使用要用作模板的项目来填入子组。

您还可以配置实例的自定义模板。

设置群组级项目模板

先决条件：

您必须是群组的所有者角色。

要在群组中设置自定义项目模板，请将包含项目模板的子组添加到群组设置：

在群组中，创建一个子组。
将项目添加到新子组作为模板。
在群组的左侧菜单中，转到 设置 > 通用。
展开 自定义项目模板 并选择子组。

下次群组成员创建项目时，他们可以选择子组中的任何项目。

嵌套子组中的项目不包括在模板列表中。

哪些项目可用作模板

如果除 GitLab Pages 和 Security & Compliance 之外的所有项目功能都设置为 具有访问权限的任何人，则任何登录用户都可以选择公开和内部项目作为新项目的模板。
私有项目只能由项目成员的用户选择。

示例结构

以下是项目模板的示例群组/项目结构，假定为 myorganization：

# GitLab instance and group
jihulab.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
        ...

从模板拷贝了哪些内容

会拷贝整个自定义实例级别项目模板仓库，包括：

分支
提交
标签

如果用户：

具有自定义实例级别项目模板项目的所有者角色或是极狐GitLab 管理员，所有的项目设置，包括项目成员，都会被复制到新项目中。
没有所有者角色或是极狐GitLab 管理员，项目部署密钥和项目 Webhook 不会被复制，因为它们包含敏感数据。

要了解更多关于迁移的信息，可查阅导出的条目。

模板中的用户指派

当您使用其他用户创建的模板时，您可以将模板中的任何项目指派给您自己。这对于配置保护分支和标签很重要。例如：如果模板包含保护分支：

在模板中，分支允许 模板所有者 合并到默认分支。
从模板创建项目时，分支允许您合并到默认分支。

故障排查

当创建项目时管理员无法看到自定义群组级别的项目模板

仅有群组成员可以看到自定义群组级别的项目模板。如果您正在使用的管理员帐户不是群组成员，您无法访问模板。