Show More
@@ -1,81 +1,81 b'' | |||||
1 | .. _rhodecode-issue-trackers-ref: |
|
1 | .. _rhodecode-issue-trackers-ref: | |
2 |
|
2 | |||
3 | Issue Tracker Integration |
|
3 | Issue Tracker Integration | |
4 | ========================= |
|
4 | ========================= | |
5 |
|
5 | |||
6 | You can set an issue tracker connection in two ways with |RCE|. |
|
6 | You can set an issue tracker connection in two ways with |RCE|. | |
7 |
|
7 | |||
8 | * At the instance level, you can set a default issue tracker. |
|
8 | * At the instance level, you can set a default issue tracker. | |
9 | * At the |repo| level, you can configure an integration with a different issue |
|
9 | * At the |repo| level, you can configure an integration with a different issue | |
10 | tracker. |
|
10 | tracker. | |
11 |
|
11 | |||
12 | To integrate |RCM| with an issue tracker, you need to define a regular |
|
12 | To integrate |RCM| with an issue tracker, you need to define a regular | |
13 | expression that will fetch the issue ID stored in commit messages, and replace |
|
13 | expression that will fetch the issue ID stored in commit messages, and replace | |
14 | it with a URL. This enables |RCE| to generate a link matching each issue to the |
|
14 | it with a URL. This enables |RCE| to generate a link matching each issue to the | |
15 | target |repo|. |
|
15 | target |repo|. | |
16 |
|
16 | |||
17 | Default Issue Tracker Configuration |
|
17 | Default Issue Tracker Configuration | |
18 | ----------------------------------- |
|
18 | ----------------------------------- | |
19 |
|
19 | |||
20 | To integrate your issue tracker, use the following steps: |
|
20 | To integrate your issue tracker, use the following steps: | |
21 |
|
21 | |||
22 | 1. Open :menuselection:`Admin --> Settings --> Issue Tracker`. |
|
22 | 1. Open :menuselection:`Admin --> Settings --> Issue Tracker`. | |
23 | 2. In the new entry field, enter the following information: |
|
23 | 2. In the new entry field, enter the following information: | |
24 |
|
24 | |||
25 | * :guilabel:`Description`: A name for this set of rules. |
|
25 | * :guilabel:`Description`: A name for this set of rules. | |
26 | * :guilabel:`Pattern`: The regular expression that will match issues |
|
26 | * :guilabel:`Pattern`: The regular expression that will match issues | |
27 | tagged in commit messages, or more see :ref:`issue-tr-eg-ref`. |
|
27 | tagged in commit messages, or more see :ref:`issue-tr-eg-ref`. | |
28 | * :guilabel:`URL`: The URL to your issue tracker. |
|
28 | * :guilabel:`URL`: The URL to your issue tracker. | |
29 | * :guilabel:`Prefix`: The prefix with which you want to mark issues. |
|
29 | * :guilabel:`Prefix`: The prefix with which you want to mark issues. | |
30 |
|
30 | |||
31 | 3. Select **Add** so save the rule to your issue tracker configuration. |
|
31 | 3. Select **Add** so save the rule to your issue tracker configuration. | |
32 |
|
32 | |||
33 | Repository Issue Tracker Configuration |
|
33 | Repository Issue Tracker Configuration | |
34 | -------------------------------------- |
|
34 | -------------------------------------- | |
35 |
|
35 | |||
36 | You can configure specific |repos| to use a different issue tracker than the |
|
36 | You can configure specific |repos| to use a different issue tracker than the | |
37 | default one. See the instructions in :ref:`repo-it` |
|
37 | default one. See the instructions in :ref:`repo-it` | |
38 |
|
38 | |||
39 | .. _issue-tr-eg-ref: |
|
39 | .. _issue-tr-eg-ref: | |
40 |
|
40 | |||
41 | Jira Integration |
|
41 | Jira Integration | |
42 | ---------------- |
|
42 | ---------------- | |
43 |
|
43 | |||
44 | * Regex = ``(?:^#|\s#)(\w+-\d+)`` |
|
44 | * Regex = ``(?:^#|\s#)(\w+-\d+)`` | |
45 |
* URL = ``https://myissueserver.com/ |
|
45 | * URL = ``https://myissueserver.com/browse/${id}`` | |
46 | * Issue Prefix = ``#`` |
|
46 | * Issue Prefix = ``#`` | |
47 |
|
47 | |||
48 | Confluence (Wiki) |
|
48 | Confluence (Wiki) | |
49 | ----------------- |
|
49 | ----------------- | |
50 |
|
50 | |||
51 | * Regex = ``(?:conf-)([A-Z0-9]+)`` |
|
51 | * Regex = ``(?:conf-)([A-Z0-9]+)`` | |
52 | * URL = ``https://example.atlassian.net/display/wiki/${id}/${repo_name}`` |
|
52 | * URL = ``https://example.atlassian.net/display/wiki/${id}/${repo_name}`` | |
53 | * issue prefix = ``CONF-`` |
|
53 | * issue prefix = ``CONF-`` | |
54 |
|
54 | |||
55 | Redmine Integration |
|
55 | Redmine Integration | |
56 | ------------------- |
|
56 | ------------------- | |
57 |
|
57 | |||
58 | * Regex = ``(issue-+\d+)`` |
|
58 | * Regex = ``(issue-+\d+)`` | |
59 | * URL = ``https://myissueserver.com/redmine/issue/${id}`` |
|
59 | * URL = ``https://myissueserver.com/redmine/issue/${id}`` | |
60 | * Issue Prefix = ``issue-`` |
|
60 | * Issue Prefix = ``issue-`` | |
61 |
|
61 | |||
62 | Redmine (wiki) |
|
62 | Redmine (wiki) | |
63 | -------------- |
|
63 | -------------- | |
64 |
|
64 | |||
65 | * Regex = ``(?:wiki-)([a-zA-Z0-9]+)`` |
|
65 | * Regex = ``(?:wiki-)([a-zA-Z0-9]+)`` | |
66 | * URL = ``https://example.com/redmine/projects/wiki/${repo_name}`` |
|
66 | * URL = ``https://example.com/redmine/projects/wiki/${repo_name}`` | |
67 | * Issue prefix = ``Issue-`` |
|
67 | * Issue prefix = ``Issue-`` | |
68 |
|
68 | |||
69 | Pivotal Tracker |
|
69 | Pivotal Tracker | |
70 | --------------- |
|
70 | --------------- | |
71 |
|
71 | |||
72 | * Regex = ``(?:pivot-)(?<project_id>\d+)-(?<story>\d+)`` |
|
72 | * Regex = ``(?:pivot-)(?<project_id>\d+)-(?<story>\d+)`` | |
73 | * URL = ``https://www.pivotaltracker.com/s/projects/${project_id}/stories/${story}`` |
|
73 | * URL = ``https://www.pivotaltracker.com/s/projects/${project_id}/stories/${story}`` | |
74 | * Issue prefix = ``Piv-`` |
|
74 | * Issue prefix = ``Piv-`` | |
75 |
|
75 | |||
76 | Trello |
|
76 | Trello | |
77 | ------ |
|
77 | ------ | |
78 |
|
78 | |||
79 | * Regex = ``(?:trello-)(?<card_id>[a-zA-Z0-9]+)`` |
|
79 | * Regex = ``(?:trello-)(?<card_id>[a-zA-Z0-9]+)`` | |
80 | * URL = ``https://trello.com/example.com/${card_id}`` |
|
80 | * URL = ``https://trello.com/example.com/${card_id}`` | |
81 | * Issue prefix = ``Trello-`` |
|
81 | * Issue prefix = ``Trello-`` |
General Comments 0
You need to be logged in to leave comments.
Login now