debian-mirror-gitlab/doc/user/admin_area/custom_project_templates.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

55 lines
2.7 KiB
Markdown
Raw Normal View History

2019-10-12 21:52:04 +05:30
---
2020-10-24 23:57:45 +05:30
stage: Manage
group: Import
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2019-10-12 21:52:04 +05:30
type: reference
---
2021-03-11 19:13:27 +05:30
# Custom instance-level project templates **(PREMIUM SELF)**
2019-02-15 15:39:39 +05:30
2021-11-18 22:05:49 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/6860) in GitLab 11.2.
2019-02-15 15:39:39 +05:30
2021-09-30 23:02:18 +05:30
GitLab administrators can set a group to be the source of project templates that are
selectable when a new project is created on the instance. These templates can be selected
when you go to **New project > Create from template** and select the **Instance** tab.
2019-03-02 22:35:43 +05:30
2021-09-30 23:02:18 +05:30
Every project in the group, but not its subgroups, can be selected when a new project
is created, based on the user's access permissions:
2019-10-12 21:52:04 +05:30
2021-09-30 23:02:18 +05:30
- Public projects can be selected by any signed-in user as a template for a new project,
2022-07-23 23:45:48 +05:30
if all enabled [project features](../project/settings/index.md#configure-project-visibility-features-and-permissions)
2021-10-27 15:23:28 +05:30
except for **GitLab Pages** and **Security & Compliance** are set to **Everyone With Access**.
The same applies to internal projects.
2021-09-30 23:02:18 +05:30
- Private projects can be selected only by users who are members of the projects.
2019-10-12 21:52:04 +05:30
2021-10-27 15:23:28 +05:30
The **Metrics Dashboard** is set to **Only Project Members** when you create a new project. Make
sure you change it to **Everyone With Access** before making it a project template.
2019-10-12 21:52:04 +05:30
Repository and database information that are copied over to each new project are
2021-09-30 23:02:18 +05:30
identical to the data exported with the [GitLab Project Import/Export](../project/settings/import_export.md).
2019-03-02 22:35:43 +05:30
2021-09-30 23:02:18 +05:30
To set project templates at the group level, see [Custom group-level project templates](../group/custom_project_templates.md).
2019-02-15 15:39:39 +05:30
2021-09-30 23:02:18 +05:30
## Select instance-level project template group
2019-02-15 15:39:39 +05:30
2021-09-30 23:02:18 +05:30
To select the group to use as the source for the project templates:
2019-10-12 21:52:04 +05:30
2021-09-04 01:27:46 +05:30
1. On the top bar, navigate to **Menu > Admin > Settings > Templates**.
1. Expand **Custom project templates**.
1. Select a group to use.
1. Select **Save changes**.
2019-02-15 15:39:39 +05:30
2021-09-30 23:02:18 +05:30
Projects in subgroups of the template group are **not** included in the template list.
2019-02-15 15:39:39 +05:30
2019-10-12 21:52:04 +05:30
<!-- ## Troubleshooting
Include any troubleshooting steps that you can foresee. If you know beforehand what issues
one might have when setting this up, or when something is changed, or on upgrading, it's
important to describe those, too. Think of things that may go wrong and include them here.
This is important to minimize requests for support, and to avoid doc comments with
questions that you know someone might ask.
Each scenario can be a third-level heading, e.g. `### Getting error message X`.
If you have none to add when creating a doc, leave this section in place
but commented out to help encourage others to add to it in the future. -->