debian-mirror-gitlab/doc/user/project/integrations/services_templates.md

64 lines
2.5 KiB
Markdown
Raw Normal View History

2020-10-24 23:57:45 +05:30
---
stage: Create
group: Ecosystem
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/#designated-technical-writers
---
2020-07-28 23:09:34 +05:30
# Service templates
2017-08-17 22:00:37 +05:30
2021-01-03 14:25:43 +05:30
Using a service template, GitLab administrators can:
2020-07-28 23:09:34 +05:30
2021-01-03 14:25:43 +05:30
- Provide default values for configuring integrations when creating new projects.
- Bulk configure all existing projects in one step.
2020-07-28 23:09:34 +05:30
2021-01-03 14:25:43 +05:30
When you enable a service template:
- The defaults are applied to **all** existing projects that either:
- Don't already have the integration enabled.
- Don't have custom values stored for already enabled integrations.
- Values are populated on each project's configuration page for the applicable
integration.
- Settings are stored at the project level.
If you disable the template:
- GitLab default values again become the default values for integrations on
new projects.
- Projects previously configured using the template will continue to use
those settings.
If you change the template, the revised values are applied to new projects. This feature
does not provide central administration of integration settings.
## Central administration of project integrations
A new set of features is being introduced in GitLab to provide more control over
how integrations are configured at the instance, group, and project level.
[Read more about setting up project integration management](../../admin_area/settings/project_integration_management.md)
(introduced in GitLab 13.3) and [our plans for managing integrations](https://gitlab.com/groups/gitlab-org/-/epics/2137).
2017-08-17 22:00:37 +05:30
## Enable a service template
2020-03-13 15:44:24 +05:30
Navigate to the **Admin Area > Service Templates** and choose the service
template you wish to create.
2017-08-17 22:00:37 +05:30
2021-01-03 14:25:43 +05:30
Recommendation:
- Test the settings on some projects individually before enabling a template.
- Copy the working settings from a project to the template.
There is no "Test settings" option when enabling templates. If the settings do not work,
these incorrect settings will be applied to all existing projects that do not already have
the integration configured. Fixing the integration then needs to be done project-by-project.
2020-07-28 23:09:34 +05:30
## Service for external issue trackers
2017-08-17 22:00:37 +05:30
2020-07-28 23:09:34 +05:30
The following image shows an example service template for Redmine.
2017-08-17 22:00:37 +05:30
![Redmine service template](img/services_templates_redmine_example.png)
For each project, you will still need to configure the issue tracking
URLs by replacing `:issues_tracker_id` in the above screenshot with the ID used
2020-07-28 23:09:34 +05:30
by your external issue tracker.