Publishing a deployment record

Deployment records inform DevOps Insights about the deployments that are made during the deployment process. This record contains the application name, build ID, environment name, status of the deployment, and more.

Before you begin

Publish a build record.

Uploading a deployment record

The application name and build ID in the deployment record must match the ones that are used in the build record for a specific build. In the deployment job, use the following script to upload a deployment record. The --env flag identifies the deployment environment.

#!/bin/bash

#install the DevOps Insights plugin
ibmcloud plugin install -f doi

# Login to IBMCloud if you are not already logged in.  Assumes that $API_KEY environment variable has been set as a secured property
ibmcloud login --apikey $API_KEY --no-region

ibmcloud doi deployrecord-publish --logicalappname="$MY_APP_NAME" --buildnumber="$MY_BUILD_NUMBER" --env staging --status pass

Viewing deployment frequency

When the deployment job completes, the pipeline publishes a message to DevOps Insights that the specified build and app was deployed.

From the IBM Cloud console, click the menu icon , and select Resource List.
Select your toolchain.
From your toolchain's Overview page, on the IBM Cloud tools card, click DevOps Insights.
Click Deployment Frequency.

Next steps

Publish test results.