mirror of
https://github.com/zulip/zulip.git
synced 2025-11-17 04:12:02 +00:00
8bb8240c27
Restructures the integration documentation pages to use a style that's more similar to the help center documentation, with an instruction block for setting up the integration, and sections for additional configuration information and related documentation links. Updates the doc pages for the airbrake, azuredevops and gitlab integrations as examples of the updated style. Also updates the URL specification section of the incoming webhook overview in the API documentation so that the documented URL parameters can be linked to directly in the integration doc pages. Co-authored-by: Alya Abbott <alya@zulip.com>
53 lines
1.4 KiB
Markdown
53 lines
1.4 KiB
Markdown
# Zulip GitLab integration
|
|
|
|
Receive GitLab notifications in Zulip!
|
|
|
|
{start_tabs}
|
|
|
|
1. {!create-stream.md!}
|
|
|
|
1. {!create-an-incoming-webhook.md!}
|
|
|
|
1. {!generate-webhook-url-basic.md!}
|
|
|
|
1. Go to your repository on GitLab and click **Settings** on the left
|
|
sidebar. Click on **Integrations**.
|
|
|
|
1. Set **URL** to the URL you generated. Select the
|
|
[events](#filtering-incoming-events) you you would like to receive
|
|
notifications for, and click **Add Webhook**.
|
|
|
|
!!! warn ""
|
|
|
|
**Note**: If your GitLab server and your Zulip server are on a local network
|
|
together, and you're running GitLab 10.5 or newer, you may need to enable
|
|
GitLab's "Allow requests to the local network from hooks and
|
|
services" setting (by default, recent GitLab versions refuse to post
|
|
webhook events to servers on the local network). You can find this
|
|
setting near the bottom of the GitLab "Settings" page in the "Admin area".
|
|
|
|
{end_tabs}
|
|
|
|
{!congrats.md!}
|
|
|
|
|
|
|
|
{% if all_event_types is defined %}
|
|
|
|
{!event-filtering-additional-feature.md!}
|
|
|
|
{% endif %}
|
|
|
|
### Configuration options
|
|
|
|
* By default, the Zulip topics for merge requests will contain the title
|
|
of the GitLab merge request. You can change the topic format to just
|
|
contain the merge request ID by adding `&use_merge_request_title=false`
|
|
to the generated URL.
|
|
|
|
{!git-branches-additional-feature.md!}
|
|
|
|
### Related documentation
|
|
|
|
{!webhooks-url-specification.md!}
|