81 lines
2.4 KiB
ReStructuredText
81 lines
2.4 KiB
ReStructuredText
.. _rhodecode-issue-trackers-ref:
|
|
|
|
Issue Tracker Integration
|
|
=========================
|
|
|
|
You can set an issue tracker connection in two ways with |RCE|.
|
|
|
|
* At the instance level, you can set a default issue tracker.
|
|
* At the |repo| level, you can configure an integration with a different issue
|
|
tracker.
|
|
|
|
To integrate |RCE| with an issue tracker, you need to define a regular
|
|
expression that will fetch the issue ID stored in commit messages, and replace
|
|
it with a URL. This enables |RCE| to generate a link matching each issue to the
|
|
target |repo|.
|
|
|
|
Default Issue Tracker Configuration
|
|
-----------------------------------
|
|
|
|
To integrate your issue tracker, use the following steps:
|
|
|
|
1. Open :menuselection:`Admin --> Settings --> Issue Tracker`.
|
|
2. In the new entry field, enter the following information:
|
|
|
|
* :guilabel:`Description`: A name for this set of rules.
|
|
* :guilabel:`Pattern`: The regular expression that will match issues
|
|
tagged in commit messages, or more see :ref:`issue-tr-eg-ref`.
|
|
* :guilabel:`URL`: The URL to your issue tracker.
|
|
* :guilabel:`Prefix`: The prefix with which you want to mark issues.
|
|
|
|
3. Select **Add** so save the rule to your issue tracker configuration.
|
|
|
|
Repository Issue Tracker Configuration
|
|
--------------------------------------
|
|
|
|
You can configure specific |repos| to use a different issue tracker than the
|
|
default one. See the instructions in :ref:`repo-it`
|
|
|
|
.. _issue-tr-eg-ref:
|
|
|
|
Jira Integration
|
|
----------------
|
|
|
|
* Regex = ``(?:^#|\s#)(\w+-\d+)``
|
|
* URL = ``https://myissueserver.com/browse/${id}``
|
|
* Issue Prefix = ``#``
|
|
|
|
Confluence (Wiki)
|
|
-----------------
|
|
|
|
* Regex = ``(?:conf-)([A-Z0-9]+)``
|
|
* URL = ``https://example.atlassian.net/display/wiki/${id}/${repo_name}``
|
|
* issue prefix = ``CONF-``
|
|
|
|
Redmine Integration
|
|
-------------------
|
|
|
|
* Regex = ``(issue-+\d+)``
|
|
* URL = ``https://myissueserver.com/redmine/issue/${id}``
|
|
* Issue Prefix = ``issue-``
|
|
|
|
Redmine (wiki)
|
|
--------------
|
|
|
|
* Regex = ``(?:wiki-)([a-zA-Z0-9]+)``
|
|
* URL = ``https://example.com/redmine/projects/wiki/${repo_name}``
|
|
* Issue prefix = ``Issue-``
|
|
|
|
Pivotal Tracker
|
|
---------------
|
|
|
|
* Regex = ``(?:pivot-)(?<project_id>\d+)-(?<story>\d+)``
|
|
* URL = ``https://www.pivotaltracker.com/s/projects/${project_id}/stories/${story}``
|
|
* Issue prefix = ``Piv-``
|
|
|
|
Trello
|
|
------
|
|
|
|
* Regex = ``(?:trello-)(?<card_id>[a-zA-Z0-9]+)``
|
|
* URL = ``https://trello.com/example.com/${card_id}``
|
|
* Issue prefix = ``Trello-``
|