Integrate with ServiceNow change management
Azure Pipelines
Azure Pipelines and ServiceNow bring an integration of Azure Pipelines with ServiceNow Change Management to enhance collaboration between development and IT teams. By including change management in CI/CD pipelines, teams can reduce the risks associated with changes and follow service management methodologies such as ITIL, while gaining all DevOps benefits from Azure Pipelines.
This topic covers:
- Configuring ServiceNow for integrating with Azure Pipelines
- Including ServiceNow change management process as a release gate
- Monitoring change management process from releases
- Keeping ServiceNow change requests updated with deployment result
Prerequisites
This tutorial extends the tutorial Use approvals and gates. You must have completed that tutorial first.
You'll also need a non-developer instance of ServiceNow to which applications can be installed from the store.
Configure the ServiceNow instance
Install the Azure Pipelines application on your ServiceNow instance. You'll require Hi credentials to complete the installation. Refer to the documentation for more details on getting and installing applications from the ServiceNow store.
Create a new user in ServiceNow and grant it the
x_mioms_azpipeline.pipelinesExecution
role.
Set up the Azure DevOps organization
Install the ServiceNow Change Management extension on your Azure DevOps organization.
Follow the instructions to "Get it Free"
Create a new ServiceNow service connection in the Azure DevOps project used for managing your releases. Enter the user name and password for the service account created in ServiceNow.
Configure a release pipeline
In your release pipeline, add a pre-deployment gate for ServiceNow Change Management.
Select the ServiceNow service connection you created earlier and enter the values for the properties of the change request.
Inputs for the gate:
- Short description: A summary of the change.
- Description: A detailed description of the change.
- Category: The category of the change. For example,
Hardware
,Network
,Software
. - Priority: The priority of the change.
- Risk: The risk level for the change.
- Impact: The effect that the change has on the business.
- Configuration Item: The configuration item (CI) that the change applies to.
- Assignment group: The group that the change is assigned to.
- Schedule of change request: The schedule of the change.
The date and time should be in the UTC format yyyy-MM-ddTHH:mm:ssZ. For example,
2018-01-31T07:56:59Z
- Additional change request parameters: Additional properties of the change request you want set.
Name must be the field name (not the label) prefixed with
u_
. For example,u_backout_plan
. The value must be a valid to be accepted value in ServiceNow. Invalid entries are ignored.
Gate success criteria:
- Desired state: The gate will succeed, and the pipeline continues when the change request status is the same as the value you specify.
Gate output variables:
- CHANGE_REQUEST_NUMBER : Number of the change request created in ServiceNow.
- CHANGE_SYSTEM_ID : System ID of the change request created in ServiceNow.
The ServiceNow gate produces output variables. You must specify the reference name to be able to use these output variables in the deployment workflow. Gate variables can be accessed by using PREDEPLOYGATE as a prefix. For example, when the reference name is set to
gate1
, the change number can be obtained as$(PREDEPLOYGATE.gate1.CHANGE_REQUEST_NUMBER)
.At the end of your deployment process, add an agentless phase with a task to update the status of the change after deployment.
Inputs for Update change request task:
- Change request number: The number of the change request that you want to update.
- Updated status of change request : The status of the change request that you want to update.
- Close code and notes: Closure information for the change request.
- Additional change request parameters: Additional properties of the change request you want to set.
Execute a release
Create a new release from the configured release pipeline in Azure DevOps
After completing the Dev stage, the pipeline creates a new change request in ServiceNow for the release and waits for it to reach the desired state.
The values defined as gate parameters will be used. You can get the change number that was created from the logs.
The ServiceNow change owner will see the release in the queue as a new change.
The release that caused the change to be requested can be tracked from the Azure DevOps Pipeline metadata section of the change.
The change goes through its normal life cycle: Approval, Scheduled, and more until it is ready for implementation.
When the change is ready for implementation (it is in the Implement state), the release in Azure DevOps proceeds. The gates status will be as shown here:
After the deployment, the change request is closed automatically.
FAQs
Q: What versions of ServiceNow are supported?
A: The integration is compatible with Kingston and London versions of ServiceNow.
Q: What types of change request can be managed with the integration?
A: Only normal change requests are currently supported with this integration.
Q: How do I set additional change properties?
A: You can specify additional change properties of the change request in the Additional change request parameters field.
The properties are specified as key-value pairs in JSON format, the name being the field name (not the label)
prefixed with u_
in ServiceNow and a valid value.
Q: Can I update custom fields in the change request with additional change request parameters?
A: If custom fields are defined in ServiceNow for the change requests, mapping of the custom fields in import set transform map must be added. See ServiceNow Change Management Extension for details.
Q: I don't see drop-down values populated for Category, Status, and others. What should I do?
A: Change Management Core and Change Management - State Model plugins must be active on your ServiceNow instance for the drop-downs to work. See Upgrade change management and Update change request states for more details.
Related topics
- Approvals and gates overview
- Manual intervention
- Use approvals and gates to control your deployment
- Stages
- Triggers
See also
- Video: Deploy quicker and safer with gates in Azure Pipelines
- Configure your release pipelines for safe deployments
- Tutorial: Use approvals and gates to control your deployment
- Twitter sentiment as a release gate
- GitHub issues as a release gate
- Author custom gates. Library with examples
Help and support
- See our troubleshooting page.
- Report any problems on Developer Community, get advice on Stack Overflow, and get support via our Support page.
Feedback
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.
Loading feedback...