jenkins-cicd

Jenkins CI/CD Skill

Purpose

Manage Jenkins CI/CD pipelines for network automation workflows. This skill provides operational workflows for monitoring job and build status, triggering builds with parameters, analyzing build logs for troubleshooting, and tracking SCM changes across Jenkins projects.

The Jenkins MCP server is an official Jenkins plugin running natively inside Jenkins via Streamable HTTP transport — netclaw connects to it as a remote HTTP client.

Golden Rule

Never trigger a build or modify build metadata without explicit operator confirmation. All write operations (triggerBuild, updateBuild) require human-in-the-loop approval per Constitution XIV. Always read current state before proposing any write action (Constitution II — Read-Before-Write).

---

Workflow 1: Pipeline and Build Monitoring (US1 — MVP)

Monitor Jenkins job status, build results, queue state, and pipeline run history.

Steps

1. List all jobs — Use getJobs with optional pagination (offset, limit) and regex name filter to discover available jobs.

   Tool: getJobs
   Parameters: { "nameFilter": "deploy-.*", "offset": 0, "limit": 25 }
   

2. Get job details — Use getJob with the full job name (supports folder paths like folder1/folder2/job-name) to retrieve job configuration, last build number, and health status.

   Tool: getJob
   Parameters: { "fullName": "network-automation/deploy-network-config" }
   

3. Get build details — Use getBuild with job name and build number to retrieve result, duration, timestamp, parameters, and causes.

   Tool: getBuild
   Parameters: { "jobFullName": "deploy-network-config", "buildNumber": 42 }
   

4. Check queue status — Use getQueueItem to inspect queued build requests — waiting reason, position, estimated start time.

   Tool: getQueueItem
   Parameters: { "queueId": 1234 }
   

5. View pipeline run history — Use getPipelineRuns to list pipeline execution history with status, duration, and branch info.

   Tool: getPipelineRuns
   Parameters: { "jobFullName": "deploy-network-config" }