zulip/templates/zerver/integrations/capistrano.md
Adam Birds 3acdbd277a integrations: Update Capistrano Documentation.
I have updated the capistrano docs so that the indentations are all
correct and align with the numbers correctly.

This one, if wanting to pout backticks round the code whilst indented,
doesn't render properly. Has to be double indented.

Fixes #17633.
2021-03-25 01:40:38 -07:00

40 lines
1.4 KiB
Markdown

Get Zulip notifications for your Capistrano deploys!
1. {!create-a-bot-indented.md!}
1. {!download-python-bindings.md!}
1. You can now send Zulip messages by calling the `zulip-send`
utility from your `deploy.rb` config file. Here's some example code for
sending a Zulip notification when a deployment has completed:
after 'deploy', 'notify:humbug'
namespace :notify do
desc "Post a message to Zulip after deploy"
task :humbug do
run_locally "echo 'I just deployed to #{stage}! :tada:' | zulip-send \
--user capistrano-bot@example.com --api-key a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 \
--site={{ api_url }} \
--stream commits --subject deployments || true"
end
end
The `--user` and `--api-key` should be the email and API key of the Zulip
bot created above. You can also put these values in a `~/.zuliprc` file on
your Capistrano machine. See our [API docs](/api) for instructions on
creating that file.
!!! tip ""
You can change the `deploy` above to another step of
your deployment process, if you'd like the notification to fire
at a different time. See [Capistrano's Before/After Hooks page][1]
for more information!
[1]: https://capistranorb.com/documentation/getting-started/before-after/
{!congrats.md!}
![Capistrano bot message](/static/images/integrations/capistrano/001.png)