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

86 lines
3.6 KiB
Markdown
Raw Normal View History

2019-09-04 21:01:54 +05:30
---
type: reference
2020-06-23 00:09:42 +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-09-04 21:01:54 +05:30
---
2019-09-30 21:07:59 +05:30
# Custom group-level project templates **(PREMIUM)**
2019-02-15 15:39:39 +05:30
2020-06-23 00:09:42 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/6861) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.6.
2019-02-15 15:39:39 +05:30
2020-10-24 23:57:45 +05:30
Custom project templates are useful for organizations that need to create many similar types of [projects](../project/index.md) and want to start from the same jumping-off point.
## Setting up Group-level Project Templates
To use a custom project template for a new project you need to:
1. [Create a 'templates' subgroup](subgroups/index.md).
1. [Add repositories (projects) to the that new subgroup](index.md#add-projects-to-a-group), as your templates.
1. Edit your group's settings to look to your 'templates' subgroup for templates:
1. In the left-hand menu, click **{settings}** **Settings > General**.
2021-02-22 17:27:13 +05:30
NOTE:
2020-10-24 23:57:45 +05:30
If you don't have access to the group's settings, you may not have sufficient privileges (for example, you may need developer or higher permissions).
1. Scroll to **Custom project templates** and click **Expand**. If no **Custom project templates** section displays, make sure you've created a subgroup, and added a project (repository) to it.
1. Select the 'templates' subgroup.
### Example structure
Here is a sample group/project structure for a hypothetical "Acme Co" for project templates:
```txt
# GitLab instance and group
gitlab.com/acmeco/
# 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
...
```
### Adjust Settings
2019-03-02 22:35:43 +05:30
Users can configure a GitLab group that serves as template
source under a group's **Settings > General > Custom project templates**.
2021-02-22 17:27:13 +05:30
NOTE:
2019-03-02 22:35:43 +05:30
GitLab administrators can
[set project templates for an entire GitLab instance](../admin_area/custom_project_templates.md).
2019-02-15 15:39:39 +05:30
Within this section, you can configure the group where all the custom project
2020-10-04 03:57:07 +05:30
templates are sourced. Every project _template_ directly under the group namespace is
available to every signed-in user, if all enabled [project features](../project/settings/index.md#sharing-and-permissions) are set to **Everyone With Access**.
2019-02-15 15:39:39 +05:30
2019-03-02 22:35:43 +05:30
However, private projects will be available only if the user is a member of the project.
2021-02-22 17:27:13 +05:30
NOTE:
2019-09-30 21:07:59 +05:30
Only direct subgroups can be set as the template source. Projects of nested subgroups of a selected template source cannot be used.
2019-02-15 15:39:39 +05:30
Repository and database information that are copied over to each new project are
2021-02-22 17:27:13 +05:30
identical to the data exported with the [GitLab Project Import/Export](../project/settings/import_export.md).
2019-09-04 21:01:54 +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. -->