gitlab-org--gitlab-foss/doc/integration
Horacio Sanson f986b4c4e5 Add support for PlantUML diagrams in Asciidoc.
This MR enables rendering of PlantUML diagrams in Asciidoc documents. To add a
PlantUML diagram all we need is to include a plantuml block like:

```
[plantuml, id="myDiagram", width="100px", height="100px"]
--
bob -> alice : ping
alice -> bob : pong
--
```

The plantuml block is substituted by an HTML img element with *src* pointing to
an external PlantUML server.

This MR also add a PlantUML integration section to the Administrator -> Settings
page to configure the PlantUML rendering service and to enable/disable it.

Closes: #17603
2017-01-12 10:04:52 +00:00
..
img Add Wiki import to BB importer 2016-12-19 20:48:08 +02:00
README.md Add support for PlantUML diagrams in Asciidoc. 2017-01-12 10:04:52 +00:00
akismet.md Updated Akismet documentation 2016-08-16 17:13:01 -05:00
auth0.md Added omniauth-auth0 Gem + Applicable Documentation. 2016-03-16 13:12:20 +01:00
azure.md Enable Microsoft Azure OAuth2 support 2016-01-06 14:30:43 +01:00
bitbucket.md Update Bitbucket callback URL documentation 2016-12-21 13:51:17 -08:00
cas.md Update cas.md to reflect the current syntax, and added that gitlab-ctl reconfigure should be run. 2016-04-21 10:30:27 +00:00
chat_commands.md List all commands 2016-12-22 19:12:17 +01:00
crowd.md Fix typos in integration docs 2015-12-07 10:28:47 +01:00
external-issue-tracker.md Added Bugzilla as external issue tracker option 2016-06-29 06:01:54 -04:00
facebook.md Move all integration docs images in a single directory 2016-01-24 21:22:19 +01:00
github.md Update github.md 2016-10-21 14:57:15 +02:00
gitlab.md Fix escaped angle bracket's in integration documentation. 2016-05-12 10:48:34 -04:00
gmail_action_buttons_for_gitlab.md Move all integration docs images in a single directory 2016-01-24 21:22:19 +01:00
google.md Update Google integration API workflow 2016-05-23 18:35:04 +00:00
jira.md Add missing JIRA file that redirects to the new location 2016-11-24 11:01:56 +01:00
ldap.md Fix LDAP link and codeblock indentation 2016-04-05 17:04:16 +03:00
oauth_provider.md Include default callback URL (OAuth) 2016-07-14 09:10:15 +00:00
omniauth.md Added support for Authentiq oauth provider 2016-12-21 10:51:10 +02:00
recaptcha.md reCAPTCHA is configurable through Admin Settings, no reload needed. 2015-12-28 18:50:29 -02:00
saml.md fix how to get SAML error details 2016-10-31 21:35:34 -07:00
shibboleth.md NIGNX -> Nginx 2016-12-05 14:37:44 +00:00
slack.md Refactor Slack service documentation 2016-07-22 12:37:05 +03:00
twitter.md Fix escaped angle bracket's in integration documentation. 2016-05-12 10:48:34 -04:00

README.md

GitLab Integration

GitLab integrates with multiple third-party services to allow external issue trackers and external authentication.

See the documentation below for details on how to configure these services.

  • JIRA Integrate with the JIRA issue tracker
  • External issue tracker Redmine, JIRA, etc.
  • LDAP Set up sign in via LDAP
  • OmniAuth Sign in via Twitter, GitHub, GitLab.com, Google, Bitbucket, Facebook, Shibboleth, SAML, Crowd, Azure and Authentiq ID
  • SAML Configure GitLab as a SAML 2.0 Service Provider
  • CAS Configure GitLab to sign in using CAS
  • OAuth2 provider OAuth2 application creation
  • Gmail actions buttons Adds GitLab actions to messages
  • reCAPTCHA Configure GitLab to use Google reCAPTCHA for new users
  • Akismet Configure Akismet to stop spam
  • Koding Configure Koding to use IDE integration
  • PlantUML Configure PlantUML to use diagrams in AsciiDoc documents.

GitLab Enterprise Edition contains advanced Jenkins support.

Project services

Integration with services such as Campfire, Flowdock, Gemnasium, HipChat, Pivotal Tracker, and Slack are available in the form of a Project Service.

SSL certificate errors

When trying to integrate GitLab with services that are using self-signed certificates, it is very likely that SSL certificate errors will occur on different parts of the application, most likely Sidekiq. There are 2 approaches you can take to solve this:

  1. Add the root certificate to the trusted chain of the OS.
  2. If using Omnibus, you can add the certificate to GitLab's trusted certificates.

OS main trusted chain

This resource has all the information you need to add a certificate to the main trusted chain.

This answer at Super User also has relevant information.

Omnibus Trusted Chain

Install the self signed certificate or custom certificate authorities in to GitLab Omnibus.

It is enough to concatenate the certificate to the main trusted certificate however it may be overwritten during upgrades:

cat jira.pem >> /opt/gitlab/embedded/ssl/certs/cacert.pem

After that restart GitLab with:

sudo gitlab-ctl restart