Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
zerver/webhooks/teamcity/doc.md
View File

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