unrhodecode/docs/integrations/integrations.rst
Marcin Kuzminski 175a9b344e rcextensions: new builtin rcextensions.
- ability to expose output to users from rcextensions
- new docs
- linking to the code makes the tests always check the integrity of rcextensions
- added new hook variables and described them to end users
2018-10-23 11:45:45 +02:00

60 lines
2.2 KiB
ReStructuredText

.. _integrations:
Integrations
------------
|RCE| supports integrations with external services for various events,
such as commit pushes and pull requests. Multiple integrations of the same type
can be added at the same time; this is useful for posting different events to
different Slack channels, for example.
Supported integrations
^^^^^^^^^^^^^^^^^^^^^^
================================ ============ ========================================
Type/Name |RC| Edition Description
================================ ============ ========================================
:ref:`integrations-webhook` |RCCEshort| Trigger events as `json` to a custom url
:ref:`integrations-slack` |RCCEshort| Integrate with https://slack.com/
:ref:`integrations-hipchat` |RCCEshort| Integrate with https://www.hipchat.com/
:ref:`integrations-email` |RCCEshort| Send repo push commits by email
:ref:`integrations-ci` |RCCEshort| Trigger Builds for Common CI Systems
:ref:`integrations-rcextensions` |RCCEshort| Advanced low-level integration framework
:ref:`integrations-jenkins` |RCEEshort| Trigger Builds for Jenkins CI System
:ref:`integrations-redmine` |RCEEshort| Close/Resolve/Reference Redmine issues
:ref:`integrations-jira` |RCEEshort| Close/Resolve/Reference JIRA issues
================================ ============ ========================================
.. _creating-integrations:
Creating an Integration
^^^^^^^^^^^^^^^^^^^^^^^
Integrations can be added globally via the admin UI:
:menuselection:`Admin --> Integrations`
or per repository in each repository's settings:
:menuselection:`Admin --> Repositories --> Edit --> Integrations`
To create an integration, select the type from the list in the *Create New
Integration* section.
The *Current Integrations* section shows existing integrations that have been
created along with their type (eg. Slack) and enabled status.
See pages specific to each type of integration for more instructions:
.. toctree::
slack
hipchat
redmine
jira
webhook
email
ci
jenkins
integrations-rcextensions