本文主要是介绍Cruise的API简介－－Properties篇，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
Cuise提供了一些Restful Url，方便用户来使用Cruise。目前这些Restful Url覆盖三个方面
（一）关于Artifacts的操作
例如查看某个job有哪些Artifacts，以及通过API下载这些Artifacts，向某个已完成的Job上传某些文件。
（二）关于Properties的操作
例如查看某个job有哪些属性，它们的值是什么，以及为某个job增加一个属性，做为一个Comment等。
（三）关于配置管理的操作
目前，Cruise可以通过Restful API增加Pipeline。
——————————————————————————————————
Cruise为JOB提供的标准属性包括：
- cruise_agent -- 该JOB是在该Agent上运行的
- cruise_job_duration -- 运行该JOB所用的总时间
- cruise_job_result -- 运行的结果（passed or failed）
- cruise_pipeline_label -- 该JOB所在Pipeline的标签
- cruise_timestamp_01_scheduled -- 该JOB被scheduled的时间
- cruise_timestamp_02_assigned -- 该JOB被分配给agent的时间
- cruise_timestamp_03_preparing -- 该JOB开始checking out source code 的时间
- cruise_timestamp_04_building -- 该JOB开始执行的时间
- cruise_timestamp_05_completing -- 该JOB执行完成，开始发送Artifacts的时间
- cruise_timestamp_06_completed -- 该JOB在Agent上完全结束的时间
下面是相应API的格式
| Method | URL format | HTTPVerb | Explanation |
|---|---|---|---|
| list | http://[server]/cruise/properties/[pipeline]/[label]/[stage]/[job] | GET | 列出属于该pipeline下该stage下这个job的所有属性（html格式） |
| list | http://[server]/cruise/properties/[pipeline]/[label]/[stage]/[job].csv | GET | 列出属于该pipeline下该stage下这个job的所有属性（CSV格式） |
| list | http://[server]/cruise/properties/[pipeline]/[label]/[stage]/[job].json | GET | 列出属于该pipeline下该stage下这个job的所有属性（json格式） |
| show | http://[server]/cruise/properties/[pipeline]/[label]/[stage]/[job]/[propertyname] | GET | 得到某个属性具体的值. |
| create | http://[server]/cruise/properties/[pipeline]/[label]/[stage]/[job]?[propertyname]=[propertyvalue] | POST | 创建一个属性并赋予其值. |
其中
- ［ label］可以是 'latest', 'lastgood', 'history' ，也可以是某个具体的label。
- 名字和Label是大小写敏感的，所以要与配置文件中的完全一样。
示例：（所以示例基于以下假设信息）
- 使用Curl（a command line tool for rowansferring files with URL syntax）作为演示工具。
- Cruise的URL是 http://cruiseserver.com:8153/ .
- 需要登录，用户名是 jez ，密码是 badger 。
该Pipeline的配置如下所示：
- <pipeline name="foo" labeltemplete="foo-1.0-${COUNT}">
- <material>
- <svn url="...."/>
- </material>
- <stage name="DEV">
- <job name="UnitTest">
- <tasks>
- <ant target="ut"/>
- </tasks>
- <artifacts>
- <artifact src="coverage" dest="coveragereport.html"/>
- </artifacts>
- </job>
- </stage>
- <stage name="UATest">
- <job name="UAT">
- <tasks>
- <ant target="all-UAT"/>
- </tasks>
- <artifacts>
- <artifact src="report" dest="UAreport.html"/>
- <artifact src="target" dest="pkg/foo.war"/>
- </artifacts>
- </job>
- </stage>
- </pipeline>
得到最后一次成功的Job的属性值列表并以Json格式返回，可以使用下面的命令
- curl -u jez:badger http://cruiseserver.com:8153/cruise/properties/foo/lastgood/DEV/UnitTest.json
得到Label为‘foo-1.0-1243’的UnitTest的属性值列表并以csv格式返回，可以使用下面的命令
- curl -u jez:badger http://cruiseserver.com:8153/cruise/properties/foo/foo-1.0-1243/DEV/UnitTest.csv
得到所有的UnitTest的属性值，可以使用下面的命令
- curl -u jez:badger http://cruiseserver.com:8153/cruise/properties/foo/history/DEV/UnitTest.csv
得到Label为‘foo-1.0-1243’的UnitTest下属性'Cruise_agent'的值，可以使用下面的命令
- curl -u jez:badger http://cruiseserver.com:8153/cruise/properties/foo/foo-1.0-1243/DEV/UnitTest/Cruise_agent
如果要定义一个属性，名为myproperty，值为‘showcase for I29’，可以使用下面的命令
- curl -u jez:badger -d "value=Showcase for I29" http://10.18.3.168:8153/cruise/properties/foo/latest/DEV/UnitTest/myproperty
这篇关于Cruise的API简介－－Properties篇的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
