Skip to content

Deployment notifications

After code is successfully deployed to a VIP Platform environment, a deployment notification can be sent by email, to Slack, or by sending JSON to an arbitrary webhook.

Enabling deployment notifications

To enable deployment notifications, create a VIP Support request with the following information:

  • Specify which applications and/or environments should have the feature enabled.
  • By default, notifications are only sent for successful deployments. Specify if notifications for failed deployments should be sent as well.
  • For email notifications: The email address(es) that should be notified.
  • For Slack notifications: The Slack webhook URLs(s) that should be notified.
  • For webhook notifications: The webhook URL(s) that should be notified.

Slack webhooks

If the webhook URL begins with https://hooks.slack.com/, a customized message will be sent to the configured channel with details about the deployment.

General-purpose webhooks

General-purpose webhook pings can used for:

  • Pinging a testing service whenever a particular environment is updated, such as page speed tests or integration testing to ensure that a checkout process is still working as expected.
  • Logging the deployment against a datastore (e.g. a Google spreadsheet).

Whatever service is receiving the ping will need to accept an HTTP POST with a JSON formatted request body with following form:

{
	"domain": "PRIMARY_DOMAIN",
    "repo": "GITHUB_ORGANISATION/GITHUB_REPOSITORY",
    "branch": "REPOSITORY_BRANCH",
    "sha": "COMMIT_SHA",
    "status":"success|failed"
}

Populated with example data:

{
	"domain": "https://example.go-vip.net",
	"repo": "wpcomvip/example",
	"branch": "develop",
	"sha": "bcb2937404b854e8f265670116d2ba69daee23a0",
	"status": "success"
}

Last updated: April 17, 2023

Relevant to

  • Node.js
  • WordPress