ServiceNow DevOps CI/CD Spoke Guide

Architecture Overview

Implementation Steps

// Test connection script for validation
var rm = new sn_ws.RESTMessageV2();
rm.setHttpMethod('GET');
rm.setEndpoint('https://jenkins.company.com/api/json');
rm.setBasicAuth('username', 'api_token');
var response = rm.execute();
gs.info('Connection test result: ' + response.getStatusCode());

// Pipeline discovery script example
var pipeline = new GlideRecord('devops_pipeline');
pipeline.initialize();
pipeline.name = 'Production Deployment Pipeline';
pipeline.source_system = sys_connection_id;
pipeline.external_id = 'prod-deploy-job';
pipeline.change_integration_enabled = true;
pipeline.insert();

(function process(request, response) {
    var payload = request.body.data;
    var deployment = new GlideRecord('devops_deployment');
    deployment.addQuery('external_build_id', payload.build_id);
    deployment.query();
    if (deployment.next()) {
        deployment.status = payload.status;
        deployment.end_time = new GlideDateTime();
        deployment.update();
    }
    response.setStatus(200);
    return 'Success';
})(request, response);

// Change approval automation script
var change = new GlideRecord('change_request');
change.addQuery('correlation_id', pipeline_execution_id);
change.query();
if (change.next()) {
    if (all_gates_passed && change.risk == 'low') {
        change.approval = 'approved';
        change.state = 'authorized';
        change.update();
    }
}

// DORA metrics calculation script
var calculator = new GlideRecord('devops_deployment');
calculator.addQuery('created_on', '>=', gs.daysAgoStart(30));
calculator.query();
var deploymentCount = calculator.getRowCount();
var failureRate = new GlideAggregate('devops_deployment');
failureRate.addQuery('status', 'failed');
failureRate.addQuery('created_on', '>=', gs.daysAgoStart(30));
failureRate.addAggregate('COUNT');
failureRate.query();
var changeFailureRate = failureRate.next() ? (failureRate.getAggregate('COUNT') / deploymentCount) * 100 : 0;

// Deployment record creation
var deployment = new GlideRecord('devops_deployment');
deployment.initialize();
deployment.pipeline = pipeline_sys_id;
deployment.environment = 'production';
deployment.version = build_version;
deployment.change_request = change_sys_id;
deployment.configuration_items = affected_ci_list;
deployment.status = 'in_progress';
deployment.start_time = new GlideDateTime();
var deployment_id = deployment.insert();

// Integration health check script
var healthCheck = new sn_ws.RESTMessageV2();
healthCheck.setHttpMethod('GET');
healthCheck.setEndpoint(pipeline_api_endpoint + '/health');
healthCheck.setRequestHeader('Authorization', 'Bearer ' + api_token);
var response = healthCheck.execute();
if (response.getStatusCode() != 200) {
    gs.eventQueue('devops.integration.failure', null, 'Pipeline API health check failed: ' + response.getBody());
}

Common Use Cases

Troubleshooting

Pro Tips

• →Implement custom business rules on devops_deployment table to automatically link deployments to related incidents and problems based on timing correlation and affected CIs, providing faster root cause analysis during outages. Use deployment time windows and CI relationships to build sophisticated correlation logic that can identify deployment-related issues even when they manifest hours after the actual deployment.
• →Set up advanced Performance Analytics breakdowns that segment DevOps metrics by application portfolio, team, technology stack, and deployment type to identify specific improvement opportunities. Create custom PA indicators that combine ServiceNow data with external tool metrics to provide comprehensive DevOps maturity scoring across your organization.
• →Configure dynamic approval workflows that adjust change approval requirements based on deployment risk scoring, historical success rates, and real-time monitoring data from APM tools. Use ServiceNow's Flow Designer to create conditional approval paths that automatically escalate to different approval groups based on deployment impact analysis and business service criticality.
• →Implement webhook payload encryption and signature validation in your scripted REST APIs to ensure secure communication between CI/CD tools and ServiceNow, especially when handling sensitive deployment information. Store webhook secrets in encrypted credential records and validate message integrity before processing pipeline status updates.
• →Create custom DevOps health monitoring dashboards that track integration uptime, API response times, webhook delivery success rates, and pipeline discovery job performance to proactively identify and resolve integration issues. Set up automated health checks that test end-to-end integration flows and alert administrators before business users notice problems.

Known Limitations

• —The DevOps spoke requires Integration Hub Professional licensing and consumes flow execution capacity with each pipeline interaction, potentially requiring capacity planning for high-volume deployment environments. Each webhook delivery and pipeline discovery operation counts against your monthly flow execution quota, which may require upgrading to higher-tier licenses for organizations with frequent deployments.
• —Real-time pipeline status updates depend on reliable webhook delivery from CI/CD tools, and temporary network issues or tool outages can cause data synchronization gaps in ServiceNow. The spoke includes retry mechanisms, but extended outages may require manual data reconciliation or re-triggering of pipeline discovery jobs to maintain accurate deployment tracking.
• —Performance Analytics for DevOps metrics requires the PA plugin and additional licensing, and historical data collection is limited by PA data retention policies and aggregation capabilities. Complex metric calculations across large deployment datasets may require custom scheduled scripts and can impact instance performance during processing windows.

Frequently Asked Questions