integration-docs: Update TeamCity for new doc format.

Part of zulip#29592.
This commit is contained in:
Niloth P 2024-07-09 17:47:52 +05:30 committed by Tim Abbott
parent 074542e7ae
commit c8781b4de7
1 changed files with 36 additions and 24 deletions

View File

@ -1,42 +1,54 @@
# Zulip TeamCity integration
Get Zulip notifications for your TeamCity builds! Get Zulip notifications for your TeamCity builds!
{start_tabs}
1. {!create-channel.md!} 1. {!create-channel.md!}
1. {!create-an-incoming-webhook.md!} 1. {!create-an-incoming-webhook.md!}
1. {!generate-integration-url.md!} 1. {!generate-webhook-url-basic.md!}
1. Install the [tcWebHooks plugin](https://github.com/tcplugins/tcWebHooks/releases) 1. Install the [tcWebHooks plugin][1] onto your TeamCity server. Follow
onto your TeamCity server. Follow the plugin instructions in your the plugin instructions in your TeamCity documentation, or refer to
TeamCity documentation, or refer to [the online TeamCity documentation][1]. [the online TeamCity documentation][2].
1. Go to your TeamCity **Overview** page. Select the **Project** or **Build** 1. Go to your TeamCity **Overview** page. Select the **Project** or
you'd like to receive notifications about, and click on the **WebHooks** tab. **Build** you'd like to receive notifications about, and click on the
If you'd like to configure webhooks for a **Project**, click on **WebHooks** tab. Click **Add project WebHooks** for a **Project**,
**Add project WebHooks**. If you'd like to configure webhooks for a specific or click **Add build WebHooks** for a **Build**. Select **Click to
**Build**, click on **Add build WebHooks**. Click on create new WebHook for this project/build**.
**Click to create new WebHook for this project/build**.
1. Set **URL** to the URL constructed above. Set **Payload Format** to 1. Set **URL** to the URL generated above, and set **Payload Format** to
**Legacy Webhook (JSON)**. Uncheck all **Trigger on Events** options, **Legacy Webhook (JSON)**. Untoggle all **Trigger on Events** options,
and check **Trigger when build is Successful** and **Trigger when build Fails**. and toggle **Trigger when build is Successful** and **Trigger when
build Fails**. You may also toggle the options **Only trigger when
build changes from Failure to Success** and **Only trigger when build
changes from Success to Failure** if you'd like. Click **Save**.
1. Optionally, check **Only trigger when build changes from Failure to Success** {end_tabs}
and **Only trigger when build changes from Success to Failure**.
1. Click **Save**.
[1]: https://confluence.jetbrains.com/display/TCD9/Installing+Additional+Plugins
{!congrats.md!} {!congrats.md!}
![](/static/images/integrations/teamcity/001.png) ![](/static/images/integrations/teamcity/001.png)
**Personal Builds** ### Personal Builds
When a user runs a personal build, if Zulip can map their TeamCity When a user runs a personal build in TeamCity, if Zulip can map their
username to a Zulip user (by comparing it with the Zulip user's email TeamCity username to a Zulip user (by matching it to a Zulip user's
address or full name), that Zulip user will receive a direct message email address or full name), then that Zulip user will receive a direct
with the result of their personal build. message with the result of their personal build.
![](/static/images/integrations/teamcity/002.png) ![](/static/images/integrations/teamcity/002.png)
### Related documentation
- [tcWebHooks plugin][1]
- [TeamCity plugin installation documentation][2]
{!webhooks-url-specification.md!}
[1]: https://github.com/tcplugins/tcWebHooks/releases
[2]: https://www.jetbrains.com/help/teamcity/installing-additional-plugins.html