创建作业并使用REST在jenkins中执行它们

时间:2013-04-09 18:25:47

标签: rest wcf jenkins jenkins-api

我正在尝试创建一个WCF REST客户端,它将与Jenkins通信并从XML文件创建作业,然后构建作业。我的理解是你可以用詹金斯做到这一点。

有人可以提供一些可以在浏览器地址栏上输入的命令来创建和构建作业吗?即:http:localhost/jenkins/createItem?name=TESTJOB沿着这些方向的东西。

5 个答案:

答案 0 :(得分:17)

通常,在解析文档时,可能需要一到两天的时间。能够访问代码或curl命令以帮助您在一小时内启动并运行是有帮助的。这是我与许多第三方软件的目标。

请参阅http://scottizu.wordpress.com/2014/04/30/getting-started-with-the-jenkins-api/上的帖子,其中列出了几个curl命令。你必须用你自己的网址替换my.jenkins.com(即JENKINS_HOST)。

例如,要创建作业,请尝试:

curl -X POST -H "Content-Type:application/xml" -d "<project><builders/><publishers/><buildWrappers/></project>" "http://JENKINS_HOST/createItem?name=AA_TEST_JOB2"

这使用通用配置。您还可以从手动创建的作业下载配置,然后将其用作模板。

curl "http://JENKINS_HOST/job/MY_JOB_NAME/config.xml" > config.xml
curl -X POST -H "Content-Type:application/xml" -d @config.xml "http://JENKINS_HOST/createItem?name=AA_TEST_JOB3" 

要执行作业(并设置字符串参数),请使用:

curl "http://JENKINS_HOST/job/MY_JOB_NAME/build"
curl "http://JENKINS_HOST/job/MY_JOB_NAME/buildWithParameters?PARAMETER0=VALUE0&PARAMETER1=VALUE1"

答案 1 :(得分:10)

请参阅Jenkins API Wiki page(包括最后的评论)。您可以使用Jenkins自己提供的文档填补空白;例如,http://JENKINS_HOST/api会为您提供创建作业的网址,而http://JENKINS_HOST/job/JOBNAME/api会为您提供触发构建的网址。

我强烈建议您避免自定义创建作业配置XML文件,而是查看Job DSL plugin之类的内容。这为您提供了一个很好的基于Groovy的DSL来以编程方式创建作业 - 更简洁,更不容易出错。

答案 2 :(得分:2)

感谢GIST - https://gist.github.com/stuart-warren/7786892

  

检查作业是否存在

curl -XGET 'http://jenkins/checkJobName?value=yourJobFolderName' --user user.name:YourAPIToken
  

使用文件夹插件

curl -s -XPOST 'http://jenkins/job/FolderName/createItem?name=yourJobName' --data-binary @config.xml -H "Content-Type:text/xml" --user user.name:YourAPIToken
  

没有文件夹插件

curl -s -XPOST 'http://jenkins/createItem?name=yourJobName' --data-binary @config.xml -H "Content-Type:text/xml" --user user.name:YourAPIToken
  

创建文件夹

curl -XPOST 'http://jenkins/createItem?name=FolderName&mode=com.cloudbees.hudson.plugins.folder.Folder&from=&json=%7B%22name%22%3A%22FolderName%22%2C%22mode%22%3A%22com.cloudbees.hudson.plugins.folder.Folder%22%2C%22from%22%3A%22%22%2C%22Submit%22%3A%22OK%22%7D&Submit=OK' --user user.name:YourAPIToken -H "Content-Type:application/x-www-form-urlencoded"

答案 3 :(得分:1)

如果您希望在视图存在的情况下在视图中创建作业。

curl -X POST -H "Content-Type:application/xml" -d @build.xml "http://jenkins_host/view/viewName/createItem?name=itemName"

build.xml filetemplate可以在作业工作区的根目录中找到

如果你想创建一个视图:

curl  -X POST -H "Content-Type:application/xml"  -d @view.xml "http://jenkins_host/createView?name=viewName"

文件view.xml的内容可以是:

<?xml version="1.0" encoding="UTF-8"?>
<hudson.model.ListView>
    <name>viewName</name>
    <filterExecutors>false</filterExecutors>
    <filterQueue>false</filterQueue>
    <properties class="hudson.model.View$PropertyList"/>
    <jobNames>
        <comparator class="hudson.util.CaseInsensitiveComparator"/>
    </jobNames>
    <jobFilters/>
    <columns>
        <hudson.views.StatusColumn/>
        <hudson.views.WeatherColumn/>
        <hudson.views.JobColumn/>
        <hudson.views.LastSuccessColumn/>
        <hudson.views.LastFailureColumn/>
        <hudson.views.LastDurationColumn/>
        <hudson.views.BuildButtonColumn/>
    </columns>
</hudson.model.ListView>

并检查视图是否存在:

curl -X POST -H "Content-Type:application/xml" "http://jenkins_host/checkViewName?value=viewName"

检查作业是否存在:

curl -X POST -H "Content-Type:application/xml" "http://jenkins_host/checkJobName?value=jobName"

答案 4 :(得分:0)

要创建工作:

curl -X POST -H "Content-Type:application/xml" -d "<project><builders/><publishers/><buildWrappers/></project>" -u username: API_Token http://JENKINS_HOST/createItem?name=AA_TEST_JOB2

要建立工作:

curl -X POST -u username:API_TOKEN http://JENKINS_HOST/job/MY_JOB_NAME/build