Jenkins is the most popular Open Source Continuous Integration system. This Library will help you interact with Jenkins in a more developer-friendly way.
These are some of the features that are currently implemented:
- Get information on test-results of completed/failed build
- Ability to query Nodes, and manipulate them. Start, Stop, set Offline.
- Ability to query Jobs, and manipulate them.
- Get Plugins, Builds, Artifacts, Fingerprints
- Validate Fingerprints of Artifacts
- Get Current Queue, Cancel Tasks
- etc. For all methods go to GoDoc Reference.
go get github.com/bndr/gojenkins
import "github.com/bndr/gojenkins"
jenkins, err := gojenkins.CreateJenkins("http:https://localhost:8080/", "admin", "admin").Init()
if err != nil {
panic("Something Went Wrong")
}
build, err := jenkins.GetJob("job_name").GetLastSuccessfulBuild()
if err != nil {
panic("Job Does Not Exist")
}
duration := build.GetDuration()
job, err := jenkins.GetJob("jobname")
if err != nil {
panic("Job does not exist")
}
job.Rename("SomeotherJobName")
configString := `<?xml version='1.0' encoding='UTF-8'?>
<project>
<actions/>
<description></description>
<keepDependencies>false</keepDependencies>
<properties/>
<scm class="hudson.scm.NullSCM"/>
<canRoam>true</canRoam>
<disabled>false</disabled>
<blockBuildWhenDownstreamBuilding>false</blockBuildWhenDownstreamBuilding>
<blockBuildWhenUpstreamBuilding>false</blockBuildWhenUpstreamBuilding>
<triggers class="vector"/>
<concurrentBuild>false</concurrentBuild>
<builders/>
<publishers/>
<buildWrappers/>
</project>`
j.CreateJob(configString, "someNewJobsName")
API Reference: https://godoc.org/github.com/bndr/gojenkins
For all of the examples below first create a jenkins object
import "github.com/bndr/gojenkins"
jenkins, _ := gojenkins.CreateJenkins("http:https://localhost:8080/", "admin", "admin").Init()
or if you don't need authentication:
jenkins, _ := gojenkins.CreateJenkins("http:https://localhost:8080/").Init()
nodes := jenkins.GetAllNodes()
for _, node := range nodes {
// Fetch Node Data
node.Poll()
if node.IsOnline() {
fmt.Println("Node is Online")
}
}
jobName := "someJob"
builds, err := jenkins.GetAllBuildIds(jobName)
if err != nil {
panic(err)
}
for _, build := range builds {
buildId := build.Number
data, err := jenkins.GetBuild(jobName, buildId)
if err != nil {
panic(err)
}
if "SUCCESS" == data.GetResult() {
fmt.Println("This build succeeded")
}
}
// Get Last Successful/Failed/Stable Build for a Job
job, err := jenkins.GetJob("someJob")
if err != nil {
panic(err)
}
job.GetLastSuccessfulBuild()
job.GetLastStableBuild()
tasks := jenkins.GetQueue()
for _, task := range tasks {
fmt.Println(task.GetWhy())
}
job, _ := jenkins.GetJob("job")
build, _ := job.GetBuild(1)
artifacts := build.GetArtifacts()
for _, a := range artifacts {
a.SaveToDir("/tmp")
}
job, _ := jenkins.GetJob("job")
job.Poll()
build, _ := job.getBuild(1)
build.Poll()
go test
All Contributions are welcome. The todo list is on the bottom of this README. Feel free to send a pull request.
Although the basic features are implemented there are many optional features that are on the todo list.
- Kerberos Authentication
- CLI Tool
- Rewrite some (all?) iterators with channels
Apache License 2.0