Commit 2f97b0fd authored by Arturo Herrero's avatar Arturo Herrero

Merge branch '327436-feature-flag-disable-service-templates' into 'master'

[RUN ALL RSPEC] [RUN AS-IF-FOSS] Enable :disable_service_templates by default

See merge request gitlab-org/gitlab!61312
parents 69707e45 2ac75902
......@@ -5,4 +5,4 @@ rollout_issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/327436
milestone: '13.12'
type: development
group: group::ecosystem
default_enabled: false
default_enabled: true
......@@ -34,10 +34,3 @@ Visit the links below for details:
- [Jira](../integration/jira/index.md)
- [Redmine](../user/project/integrations/redmine.md)
- [YouTrack](../user/project/integrations/youtrack.md)
### Service Template
To avoid configuring each project's service individually, GitLab provides the ability to set
Service Templates. These can then be overridden in each project's settings.
Read more on [Services Templates](../user/project/integrations/services_templates.md).
......@@ -77,10 +77,9 @@ To make full use of Auto DevOps with Kubernetes, you need:
instruct GitLab to query an in-cluster Prometheus by enabling
the [Prometheus cluster integration](../../user/clusters/integrations.md#prometheus-cluster-integration).
The [Prometheus service](../../user/project/integrations/prometheus.md)
integration must be enabled for the project, or enabled as a
[default service template](../../user/project/integrations/services_templates.md)
for the entire GitLab installation.
The [Prometheus integration](../../user/project/integrations/prometheus.md)
integration must be activated for the project, or activated at the group or instance level.
Learn more about [Project integration management](../../user/admin_area/settings/project_integration_management.md).
To get response metrics (in addition to system metrics), you must
[configure Prometheus to monitor NGINX](../../user/project/integrations/prometheus_library/nginx_ingress.md#configuring-nginx-ingress-monitoring).
......
......@@ -35,7 +35,7 @@ The Admin Area is made up of the following sections:
| **{location-dot}** Geo | Configure and maintain [Geo nodes](geo_nodes.md). |
| **{key}** Deploy keys | Create instance-wide [SSH deploy keys](../project/deploy_keys/index.md). |
| **{lock}** Credentials | View [credentials](credentials_inventory.md) that can be used to access your instance. |
| **{template}** Service Templates | Create [service templates](../project/integrations/services_templates.md) for projects. |
| **{template}** Integrations | Manage [instance-level default settings](settings/project_integration_management.md) for a project integration. |
| **{labels}** Labels | Create and maintain [labels](labels.md) for your GitLab instance. |
| **{appearance}** Appearance | Customize [GitLab appearance](appearance.md). |
| **{settings}** Settings | Modify the [settings](settings/index.md) for your GitLab instance. |
......
......@@ -80,19 +80,6 @@ instance configuration or provide custom settings.
Read more about [Project integration management](../../admin_area/settings/project_integration_management.md).
### Service templates
[Service templates](services_templates.md) were a way to set predefined values for
a project integration across all new projects on the instance. They are deprecated and
[scheduled to be removed](https://gitlab.com/gitlab-org/gitlab/-/issues/268032)
in GitLab 14.0.
GitLab recommends you use [project integration management](../../admin_area/settings/project_integration_management.md)
instead of service templates. GitLab versions 13.3 and later provide
[instance-level integrations](../../admin_area/settings/project_integration_management.md#project-integration-management)
you can use.
instead.
## Troubleshooting integrations
Some integrations use service hooks for integration with external applications. To confirm which ones use service hooks, see the [integrations listing](#integrations-listing) above. GitLab stores details of service hook requests made within the last 2 days. To view details of the requests, go to that integration's configuration page.
......
---
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/#assignments
redirect_to: '../../admin_area/settings/project_integration_management.md'
remove_date: '2021-09-09'
---
# Service templates **(FREE)**
This document was moved to [another location](../../admin_area/settings/project_integration_management.md).
WARNING:
Service templates are [deprecated and scheduled to be removed](https://gitlab.com/gitlab-org/gitlab/-/issues/268032)
in GitLab 14.0. Use [project integration management](#central-administration-of-project-integrations) instead.
Using a service template, GitLab administrators can:
- Provide default values for configuring integrations when creating new projects.
- Bulk configure all existing projects in one step.
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 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. For
more information, read more about:
- [Setting up project integration management](../../admin_area/settings/project_integration_management.md) (introduced in GitLab 13.3)
- [Our plans for managing integrations](https://gitlab.com/groups/gitlab-org/-/epics/2137).
## Enable a service template
Navigate to the **Admin Area > Service Templates** and choose the service
template you wish to create.
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 are applied to all existing projects that do not already have
the integration configured. Fixing the integration then needs to be done project-by-project.
## Service for external issue trackers
The following image shows an example service template for Redmine.
![Redmine service template](img/services_templates_redmine_example.png)
For each project, you still need to configure the issue tracking
URLs by replacing `:issues_tracker_id` in the above screenshot with the ID used
by your external issue tracker.
<!-- This redirect file can be deleted after <2021-09-09>. -->
<!-- Before deletion, see: https://docs.gitlab.com/ee/development/documentation/#move-or-rename-a-page -->
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment