Logo of AppSignal

Menu
Documentation navigation

AppSignal for Ruby: Notify of deploy

Warning: This method of notifying AppSignal of deploys is deprecated. Please use the new revision config option instead. Read our deploy marker section for more information on how to create deploy markers.

Command line tool to send a "Deploy Marker" for an application to AppSignal.

Deploy markers are used on AppSignal.com to indicate changes in an application, "Deploy markers" indicate a deploy of an application.

Incidents for exceptions and performance issues will be closed and reopened if they occur again in the new deploy.

Note: The same logic is used in the Capistrano integration. A deploy marker is created on each deploy.

This tool is available since version 0.2.5 of the AppSignal Ruby gem.

Please read our documentation on Deploy markers for recommended alternative methods of sending deploy markers to AppSignal.

Usage

Basic example

1
2
3
4
appsignal notify_of_deploy \
  --user=tom \
  --environment=production \
  --revision=abc1234

Using a custom name

1
2
3
4
5
appsignal notify_of_deploy \
  --user=tom \
  --environment=production \
  --revision=abc1234 \
  --name="My app"

The help command

If you need more help from the command line tool itself, use the --help option.

1
appsignal notify_of_deploy --help

Options

Option Description
--environment=<environment> Required. The environment of the application being deployed.
--user=<user name> Required. Name of the user that triggered the deploy.
--revision=<revision> Required. Git commit SHA or other identifiable revision id.
--name=<name> Required. If no "name" config can be found in a config/appsignal.yml file or based on the APPSIGNAL_APP_NAME environment variable, this option is required.

Exit codes

  • Exits with status code 0 if the deploy marker is sent.
  • Exits with status code 1 if the configuration is not valid and active.
  • Exits with status code 1 if the required options aren't present.

We'd like to set cookies, read why.