webhooks/teamcity: Migrate docs to Markdown.

This commit is contained in:
Eeshan Garg 2017-06-01 00:08:24 -02:30 committed by Tim Abbott
parent 28a2166bd0
commit a8e4abfb7c
2 changed files with 37 additions and 58 deletions

View File

@ -1,58 +0,0 @@
<p>See your Teamcity build status in Zulip!</p>
<p>
First, create the stream you'd like to use for Teamcity
notifications, and subscribe all interested parties to this stream. We
recommend the name <code>teamcity</code>.
</p>
<p>
Next, set up a bot for the integration. You'll need the bot's API key
to construct a URL for Teamcity.
</p>
<p>
Next, install the <a href="https://github.com/tcplugins/tcWebHooks/releases">tcWebHooks plugin</a>
onto your Teamcity server. Follow the plugin instructions in your
Teamcity documentation, or refer to
<a href="https://confluence.jetbrains.com/display/TCD9/Installing+Additional+Plugins">the online Teamcity
documentation</a>.
</p>
<p>
Next, in your Teamcity project overview page,
click the "Webhooks" tab, and add a new project webhook.
Enter the following URL:
</p>
<p><code>{{ external_api_uri_subdomain }}/v1/external/teamcity?api_key=abcdefgh&amp;stream=teamcity</code></p>
<p>
where <code>api_key</code> is the API key of your Zulip bot,
and <code>stream</code> is the stream name you want the
notifications sent to.
</p>
<p>
Uncheck all "Trigger on Events" options, and check
"Trigger when build is Successful" and "Trigger when build Fails".
Optionally, check "Only trigger when build changes from Failure to Success"
and "Only trigger when build changes from Success to Failure".
</p>
<p>Set the Payload Format to "JSON" and save your webhook.</p>
<img class="screenshot" src="/static/images/integrations/teamcity/001.png"/>
<p>
<b>Congratulations! You're done!</b><br/> Your Teamcity build
notifications will appear in Zulip:
</p>
<img class="screenshot" src="/static/images/integrations/teamcity/002.png"/>
<p>
<b>Personal Builds</b><br/> When a user runs a personal build, if Zulip can
map their Teamcity username to a Zulip user, that Zulip user will receive a
private message with the result of their personal build.
</p>
<img class="screenshot" src="/static/images/integrations/teamcity/003.png"/>

View File

@ -0,0 +1,37 @@
See your Teamcity build status in Zulip!
{!create-stream.md!}
{!create-bot-construct-url.md!}
Next, 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]: https://confluence.jetbrains.com/display/TCD9/Installing+Additional+Plugins
Next, in your Teamcity project overview page, click the **Webhooks**
tab, and add a new project webhook. Enter the URL you created
earlier.
Uncheck all **Trigger on Events** options, and check
**Trigger when build is Successful** and **Trigger when build Fails**.
Optionally, check **Only trigger when build changes from Failure to Success**
and **Only trigger when build changes from Success to Failure**.
Set the Payload Format to **JSON** and save your webhook.
![](/static/images/integrations/teamcity/001.png)
{!congrats.md!}
![](/static/images/integrations/teamcity/002.png)
**Personal Builds**
When a user runs a personal build, if Zulip can map their Teamcity
username to a Zulip user, that Zulip user will receive a private
message with the result of their personal build.
![](/static/images/integrations/teamcity/003.png)