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

43 lines
1.8 KiB
Markdown
Raw Normal View History

2020-10-24 23:57:45 +05:30
---
2021-10-27 15:23:28 +05:30
stage: Ecosystem
group: Integrations
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
2020-10-24 23:57:45 +05:30
---
2021-06-08 01:23:25 +05:30
# YouTrack service **(FREE)**
2019-07-07 11:18:12 +05:30
2021-06-08 01:23:25 +05:30
JetBrains [YouTrack](https://www.jetbrains.com/youtrack/) is a web-based issue tracking and project
management platform.
2019-07-07 11:18:12 +05:30
2021-06-08 01:23:25 +05:30
You can configure YouTrack as an
[external issue tracker](../../../integration/external-issue-tracker.md) in GitLab.
2019-07-07 11:18:12 +05:30
2021-06-08 01:23:25 +05:30
To enable the YouTrack integration in a project:
2019-07-07 11:18:12 +05:30
2022-06-21 17:19:12 +05:30
1. On the top bar, select **Menu > Projects** and find your project.
1. On the left sidebar, select **Settings > Integrations**.
2021-06-08 01:23:25 +05:30
1. Select **YouTrack**.
1. Select the checkbox under **Enable integration**.
1. Fill in the required fields:
- **Project URL**: The URL to the project in YouTrack.
- **Issue URL**: The URL to view an issue in the YouTrack project.
The URL must contain `:id`. GitLab replaces `:id` with the issue number.
1. Select **Save changes** or optionally select **Test settings**.
2019-07-07 11:18:12 +05:30
2021-06-08 01:23:25 +05:30
After you configure and enable YouTrack, a link appears on the GitLab
project pages. This link takes you to the appropriate YouTrack project.
2019-07-07 11:18:12 +05:30
2021-06-08 01:23:25 +05:30
You can also disable [GitLab internal issue tracking](../issues/index.md) in this project.
Learn more about the steps and consequences of disabling GitLab issues in
2022-07-23 23:45:48 +05:30
[Sharing and permissions](../settings/index.md#configure-project-visibility-features-and-permissions).
2019-07-07 11:18:12 +05:30
2021-06-08 01:23:25 +05:30
## Reference YouTrack issues in GitLab
2019-07-07 11:18:12 +05:30
2021-06-08 01:23:25 +05:30
You can reference issues in YouTrack using `<PROJECT>-<ID>` (for example `YT-101`, `Api_32-143` or `gl-030`) where:
2019-07-07 11:18:12 +05:30
2021-06-08 01:23:25 +05:30
- `<PROJECT>` starts with a letter and is followed by letters, numbers, or underscores.
- `<ID>` is a number.
2019-07-07 11:18:12 +05:30
2021-06-08 01:23:25 +05:30
References to `<PROJECT>-<ID>` in merge requests, commits, or comments are automatically linked
to the YouTrack issue URL.