实例模板仓库
在托管系统中,企业通常需要跨团队共享自己的模板。此功能允许管理员选择一个项目来收集实例范围内的文件模板。然后,这些模板会在项目保持安全的同时,通过 Web 编辑器向所有用户公开。
配置
要选择一个项目作为自定义模板仓库:
- 在顶部栏上,选择 主菜单 > 管理员。
- 在左侧边栏上,选择 设置 > 模板。
- 展开 模板。
- 从下拉列表中,选择要用作模板仓库的项目。
- 选择 保存修改。
- 将自定义模板添加到选定的仓库。
添加模板后,您可以将它们用于整个实例。 它们在 Web 编辑器的下拉列表中可用,在通过 API 设置可用。
支持的文件类型和位置
模板必须添加到仓库中的特定子目录,对应于模板的种类。支持以下类型的自定义模板:
类型 | 目录 | 扩展名 |
---|---|---|
Dockerfile
| Dockerfile
| .dockerfile
|
.gitignore
| gitignore
| .gitignore
|
.gitlab-ci.yml
| gitlab-ci
| .yml
|
LICENSE
| LICENSE
| .txt
|
metrics-dashboard.yml
| metrics-dashboards
| .yml
|
每个模板必须位于其各自的子目录中,具有正确的扩展名并且不能为空。层次结构应如下所示:
|-- README.md
|-- Dockerfile
|-- custom_dockerfile.dockerfile
|-- another_dockerfile.dockerfile
|-- gitignore
|-- custom_gitignore.gitignore
|-- another_gitignore.gitignore
|-- gitlab-ci
|-- custom_gitlab-ci.yml
|-- another_gitlab-ci.yml
|-- LICENSE
|-- custom_license.txt
|-- another_license.txt
|-- metrics-dashboards
|-- custom_metrics-dashboard.yml
|-- another_metrics-dashboard.yml
当通过 UI 添加新文件时,您的自定义模板会显示在下拉菜单中:
如果禁用此功能或不存在模板,则选择下拉列表中不会显示 自定义 部分。