Rundeck集成：WebApi方式集成示例介绍
这篇文章介绍一下如何在Rundeck中使用Rundeck Rest Api，并结合具体的实例进行操作。
Web Api
Rundeck提供了较好的对外暴露的WebApi，可以进行更方便地集成而不需要cli。而诸如curl则基本上是所有linux的标配，另外程序之中也可以直接使用Api，rundeck的api相关信息可参看如下：
- https://docs.rundeck.com/docs/api/index.html#index
XML 和 JSON支持
API支持XML和JSON方式，虽然一些export/import的功能也支持YAML或者文本格式（text/plain）,整体在所有API级别上还是使用XML和JSON方式。而在version 14，全部支持JSON格式，而只有一个例外（/api/V/project/[PROJECT]/jobs/export）。
- 使用方式
可以通过设定HTTP Header的Accept为application/json来获取json方式的返回结果。
当Accept没有指定的时候，返回结果同POST或者PUT的request中的方式一样，或者会返回缺省的XML方式的请求。
认证方法
Rundeck对api的使用可以通过用户名和密码或者 token的方式来进行。
用户名密码方式
首先需要需要向如下URL进行用户名和密码的post操作
- $RUNDECK_SERVER_URL/j_security_check
- j_username: 用户名
- j_password: 密码
注：实际就是登录的过程保存于session之中
使用token方式
这种方式首先需要生成token，使用生成的token，可以使用如下两种方式来进行使用。
- 方式1: 在HTTP Header中将token设定到X-Rundeck-Auth-Token中
- 方式2: 在url中通过参数authtoken传入
生成token
首先需要设定token，可以通过GUI先行生成相关token，登录之后在右上角的user profile的界面进行token的添加
根据如下信息创建token
可以看到如下token的信息
点击show token获取token内容
查询project的列表信息
- 缺省方式：返回XML的结果
liumiaocn:~ liumiao$ curl http://localhost:32044/api/30/projects?authtoken=vcopxmhraTC9vlNw1p5VJTlxNhQcVNbc
<result success='true' apiversion='30'><projects count='2'><project><name>rundeck-test-cli-projectname><description>description>project><project><name>rundeck-test-projectname><description>This project is to introduce Rundeck functiondescription>project>projects>
result>liumiaocn:~ liumiao$
- 设定Accept：指定返回json格式
liumiaocn:~ liumiao$ curl http://localhost:32044/api/1/projects?authtoken=vcopxmhraTC9vlNw1p5VJTlxNhQcVNbc -H "Accept: application/json" |jq .
...省略
[{"url": "http://localhost:32044/api/30/project/rundeck-test-cli-project","name": "rundeck-test-cli-project","description": ""},{"url": "http://localhost:32044/api/30/project/rundeck-test-project","name": "rundeck-test-project","description": "This project is to introduce Rundeck function"}
]
liumiaocn:~ liumiao$
创建Project
事前准备
准备如下Json格式的project创建信息
liumiaocn:~ liumiao$ cat rundeck-project.json
{ "name": "rundeck-test-webapi-project", "config": { "project.lable":"Rundeck Test WebApi Project" }
}
liumiaocn:~ liumiao$
创建Project
liumiaocn:~ liumiao$ curl -H "Content-Type: application/json" -X POST --data-binary "@rundeck-project.json" http://localhost:32044/api/30/projects?authtoken=vcopxmhraTC9vlNw1p5VJTlxNhQcVNbc
{"url":"http://localhost:32044/api/30/project/rundeck-test-webapi-project","name":"rundeck-test-webapi-project","description":"","config":{"service.FileCopier.default.provider":"jsch-scp","project.ssh-keypath":"/home/rundeck/.ssh/id_rsa","service.NodeExecutor.default.provider":"jsch-ssh","project.lable":"Rundeck Test WebApi Project","project.name":"rundeck-test-webapi-project","project.ssh-authentication":"privateKey","resources.source.1.type":"local"}}liumiaocn:~ liumiao$
liumiaocn:~ liumiao$
创建信息确认
liumiaocn:~ liumiao$ curl http://localhost:32044/api/30/projects?authtoken=vcopxmhraTC9vlNw1p5VJTlxNhQcVNbc
<projects count='3'><project url='http://localhost:32044/api/30/project/rundeck-test-cli-project'><name>rundeck-test-cli-projectname><description>description>project><project url='http://localhost:32044/api/30/project/rundeck-test-project'><name>rundeck-test-projectname><description>This project is to introduce Rundeck functiondescription><label>Rundeck Test Projectlabel>project><project url='http://localhost:32044/api/30/project/rundeck-test-webapi-project'><name>rundeck-test-webapi-projectname><description>description>project>
projects>liumiaocn:~ liumiao$
通过Web GUI进行确认
Project详细信息确认
确认创建的Project详细信息
liumiaocn:~ liumiao$ curl http://localhost:32044/api/30/project/rundeck-test-webapi-project?authtoken=vcopxmhraTC9vlNw1p5VJTlxNhQcVNbc -H "Accept: application/json" |jq .% Total % Received % Xferd Average Speed Time Time Time CurrentDload Upload Total Spent Left Speed
100 457 0 457 0 0 11146 0 --:--:-- --:--:-- --:--:-- 11425
{"url": "http://localhost:32044/api/30/project/rundeck-test-webapi-project","name": "rundeck-test-webapi-project","description": "","config": {"service.FileCopier.default.provider": "jsch-scp","project.ssh-keypath": "/home/rundeck/.ssh/id_rsa","service.NodeExecutor.default.provider": "jsch-ssh","project.lable": "Rundeck Test WebApi Project","project.name": "rundeck-test-webapi-project","project.ssh-authentication": "privateKey","resources.source.1.type": "local"}
}
liumiaocn:~ liumiao$
其他内容
- https://liumiaocn.blog.csdn.net/article/details/89135773
参考内容
https://www.rundeck.com/open-source
本文来自互联网用户投稿，文章观点仅代表作者本人，不代表本站立场，不承担相关法律责任。如若转载，请注明出处。 如若内容造成侵权/违法违规/事实不符，请点击【内容举报】进行投诉反馈！