ProdPass - Record Deployment
Record deployments from Azure Pipelines in ProdPass.
About ProdPass
ProdPass is a platform for managing the path to production: environments and the versions running in them, releases and their gates, deployment windows and history. This extension keeps it up to date from your pipelines.
Key features
The task records the version deployed to an instance (or a component of it), the outcome and the release it belongs to, so release gates such as Deployed to pre-prod update automatically. The ProdPass URL and token are stored once in a secure service connection. If nothing is recorded the task fails with the reason, and retries never record a deployment twice. Works with YAML and Classic pipelines.
Setup
- In ProdPass, open Integrations › Deployment tools, add a connection and copy its URL and token.
- In Azure DevOps, add Project settings › Service connections › New service connection › ProdPass with that URL and token.
Examples
- task: ProdPassDeployment@1
inputs:
connectedServiceName: ProdPass
instance: order-service.uat2
version: '1.5.0'
With a release, reporting the job's real outcome:
- task: ProdPassDeployment@1
condition: always()
inputs:
connectedServiceName: ProdPass
instance: Nextgen.preprod
version: '2.0.0'
release: REL-00002
project: KYC-UPG
status: auto
Main inputs
| Input |
Description |
connectedServiceName |
The ProdPass service connection. |
instance |
Instance code. Or use target: systemEnvironment with system and environment. |
component |
Optional component code. |
version |
The version deployed. |
status |
succeeded (default), failed, in_progress, rolled_back or auto. |
release, project |
Optional release (REL-00002) and project codes. |
More options (reference, link, times, event ID, timeout) are under Advanced.
Troubleshooting
| Message |
Fix |
ProdPass rejected the token (HTTP 401) |
Update the service connection's token; check the ProdPass connection is turned on. |
ProdPass did not record the deployment: no instance matches "…" |
The instance code doesn't exist in ProdPass (codes are case-sensitive). |
ProdPass rejected the deployment (HTTP 400): … |
A field is invalid; the message names it. |
Could not reach ProdPass … no answer within 30s |
The agent can't reach ProdPass; for a private ProdPass, use a self-hosted agent. |
Support
support@prodpass.ai