Common errors in DevOps Change Velocity
Identify the root cause of errors that occur in DevOps Change Velocity, and see the corresponding steps that might resolve them.
Tool connection
This table lists the steps required to resolve the errors that might occur when you select the Submit or Connect button after entering the tool details in the tool connection process:
| Message | Action |
|---|---|
| Tool cannot be created because the tool name has not been entered. Enter the tool name, and try again. | Re-enter the tool name. |
| Tool cannot be created because the tool integration has not been selected. Select the correct tool integration value, and try again. | Select the correct tool integration value. |
| Tool cannot be created because the tool URL is invalid or incorrect. Re-enter the tool URL, and try again. | Re-enter the tool URL. |
| Tool cannot be created because the platform version cannot be determined. Create the glide.buildtag.last sys property, and try again. |
|
| Tool cannot be created because the associated CreateDevOps tool connection is invalid. Create a valid connection alias, and try again. |
A user with connection_admin role can configure an HTTP connection.
|
| Tool cannot be created because the CreateDevOpsTool alias credentials are incorrect. Update the credential record, and try again. |
|
| Tool cannot be created because the connection URL of the CreateDevOpsTool alias is incorrect. Use the following URL: https://<instancename>.service-now.com,and try again. |
|
| To create a connection alias, you need the connection\_admin role. Contact your system administrator. | This error occurs if the connection alias field is empty for a tool record. To create the tool connection, you need a connection alias. Only a user having theconnection_admin role can create a connection alias. You must reach out to a user having this role, like an administrator, and get the connection alias created. |
| Tool cannot be created because the <toolname> tool name already exists. Enter a different name, and try again. | Use a different name for the tool. |
| Tool cannot be created because the <toolname> does not have a valid MID server configuration. Configure a valid MID server, and try again. | 1. If you are using the workspace, check if the mid server is running and reachable. 2. If you are using the catalog and record producer, check if the mid server is running and reachable with application as DevOps and Capability as REST. |
| Tool cannot be created because there are no connection and credentials aliases available for DevOps Data Model scope. Create a new connection and credential alias, and try again. | This error occurs for OAuth authentication.
|
| Tool cannot be created due to a technical issue while creating the credential record. |
|
| Tool cannot be created because credential and domain combination for an active record already exists. | This error occurs for OAuth authentication. 1. Use a different credential. 2. Check if the existing credential is used by any active connection. |
| Tool cannot be created due to a technical issue while creating the connection record. |
|
| Tool cannot be created because of the following reasons: - The validate subflow is not configured, and - An integration capability record with the same subflow name does not exist for the associated tool integration. Configure the subflow, and create the integration capability record with the Validate action and a subflow name for the tool integration, and try again. | This error occurs only for custom tool integrations.
For more information, see Create a DevOps tool integration. Image omitted: validate-associate-subflow.png Integration Capabilities related tab</p>
|
| Tool cannot be created due to a connectivity issue. Check the <validate\_subflow\_name> subflow for more details, and try again. |
|
| Tool authorization credentials are invalid. Enter valid credentials, and try again. | Re-enter the correct username/password for the tool. |
| Tool cannot be created because there is no response received from the server. Enter a valid tool URL or Check if server is up and running, and try again. | 1. Re-enter the tool URL. 2. Check the mid server. |
| The connection URL is incorrect, check theURL and try again. | Re-enter the tool URL. |
| Tool cannot be connected because the GitHub app slug name is incorrect. Enter the correct GitHub app slug name and try again. | You can find the GitHub app slug name on the settings page of your GitHub app. The GitHub app slug name is the URL-friendly name of your GitHub app. For example, if you have created a GitHub app with the name Test App, the corresponding URL-friendly GitHub app slug name will be test-app. In your GitHub url - "https://github.com/settings/apps/test-app", "test-app" is the GitHub app slug name. For more information, see GitHub documentation. |
| Password value is too long and could be truncated after encryption. Please either reduce password length or increase field size. | From 18th January 2023, Jira has extended the length of API tokens for Atlassian accounts. You must increase the maximum password value to more than 255 in the discovery\_credentials table to accommodate the extended character length. For more information, see the KB1269878 kb article and Atlassian documentation. |
| Unexpected behaviour from remote host: Circular redirect to 'https://bitbucket.org/account/signin/?next=%2F...%2Frest%2Fapi%2F1.0%2Fusers'. | This error might occur if you try to connect to a BitBucket Cloud instance. BitBucket Cloud is not supported. You must use a BitBucket Server instance to connect to ServiceNow DevOps. Connect to your BitBucket instance via an MID server. A MID server is required if your tool instance is hosted on-prem. For more information about MID server, see MID Server selection |
| Mismatch in tool URL: Tool URL entered in ServiceNow: https://<URL of the Jenkins instance you entered> Tool URL entered in Jenkins: https://<Jenkins location URL entered in Jenkins> In Jenkins, under Manage Jenkins > System, check that your configured Jenkins URL is the same as the Tool URL entered here. See the troubleshooting tool on-boarding errors. | This error occurs when the Jenkins URL entered in DevOps is different from the Jenkins URL entered in your Jenkins instance. From your Jenkins instance, navigate to Manage Jenkins > System > Jenkins Location. The Jenkins URL entered here must match the URL of the Jenkins instance entered in DevOps. |
Tool permissions
This section lists the steps required to resolve tool permission errors when you create a DevOps tool using workspace playbooks. Tool permission check guidelines are displayed in a pop-up when you connect to a tool from the workspace.
Action
If any permission is missing, perform the following steps:
- Update the permissions for the provided credentials in the external DevOps tool. Select Refresh in the pop-up to perform the checks again.
- Close the pop-up, use different credentials, and select Connect again. The permission check pop-up appears with results of the newly entered credentials.
Review the impact column, and if the impact does not affect your use-case, select Continue anyway. If all permission checks are successful:
Select Continue to progress to the next step in the playbook.
- If errors show up in the result, try again by selecting Refresh.
- If the error persists, update the Tool permission check timeout per record (in milliseconds) property and try again.
- Tool permission check timeout property
During the tool connection process, the system performs permission validations in the foreground, and restricts the tool connection page. For every permission validation, a REST API call is made to external tools to evaluate the availability of the permission. The REST API response time may vary based on your network settings. To avoid delays, you can specify how long the system should wait to get a response from an external tool before marking the permission as an error. You can specify this time using the Tool permission check timeout per record (in milliseconds) property (sn_devops.permission_check_timeout). If you find that some of the permission checks are resulting in an error, try increasing the timeout value, and select Refresh in the Permissions pop-up.
Tool notification
This table lists the steps required to resolve errors that might occur in scenarios such as retrieving commit details, pipeline execution details, pull request details, test summaries:
| Reason | Action | |||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Authorization credentials are either invalid or do not have the minimum required permissions. |
|