Rundeck集成:CLI方式集成示例介绍
作者:互联网
这篇文章介绍一下如何在Rundeck中使用Rundeck Cli,并结合具体的实例对Rundeck Cli进行操作。
概要信息
Rundeck的Cli概要信息如下表所示:
项目 | 说明 |
---|---|
官网 | http://rundeck.org |
开源/闭源 | 开源 |
源码管理地址 | https://github.com/rundeck/rundeck-cli |
License类别 | Apache 2.0 License |
开发语言 | Java,Groovy |
当前稳定版本 | v1.1.1 (2018/12/21) |
操作系统支持 | 跨平台,支持Linux/Windows/Mac |
下载地址:github release | https://github.com/rundeck/rundeck-cli/releases |
安装方式
Rundeck cli提供了yum源和apt-get源,可以在相关的Linux发行版上直接使用yum install或者apt-get install进行安装,另外更简单和灵活的方式则是直接从github release下下载所需版本的二进制jar文件,在JRE或者JDK的环境下可直接使用。以下以v1.1.1为例对安装进行简单说明。
Step 1: 下载jar文件
[root@host132 ~]# wget https://github.com/rundeck/rundeck-cli/releases/download/v1.1.1/rundeck-cli-1.1.1-all.jar
...省略
Saving to: 'rundeck-cli-1.1.1-all.jar'
100%[==============================================================================================>] 4,028,801 513KB/s in 7.8s
...省略
[root@host132 ~]#
[root@host132 ~]# ls rundeck-cli-1.1.1-all.jar
rundeck-cli-1.1.1-all.jar
[root@host132 ~]# du -k rundeck-cli-1.1.1-all.jar
3936 rundeck-cli-1.1.1-all.jar
[root@host132 ~]#
使用cli的jar文件
使用如下格式即可通过cli操作rundeck
命令格式:java -jar rundeck-cli-1.1.1-all.jar cli命令
不输入任何参数时,会输出可用的cli命令
liumiaocn:~ liumiao$ java -jar rundeck-cli-1.1.1-all.jar
No command was specified.
- RD - Rundeck API Client Tool (v1.1.1) - https://rundeck.github.io/rundeck-cli/
.:'/*/'`:,·:~·–:., ,._., ._
/::/:/:::/:::;::::::/`':.,' /::::::::::'/:/:~-.,
/·*'`·´¯'`^·-~·:–-'::;:::'`; /:-·:;:-·~·';/:::::::::`·-.
'\ '`;::'i‘ '; '`~-:;:::::::::'`,
'`; ,– ., 'i:'/ ',. '`·-:;:::::'i'‘
i i':/:::'; ;/' `'i ,_ '`;:::'¦‘
i i/:·'´ ,:'' 'i ;::/`:, i'::/
'; ' ,:, ~;'´:::'`:, _; ;:/;;;;:'; ¦'/
'i i:/\ `;::::/:'`;' /::'; ,':/::::::;' ,´
; ;/ \ '`:/::::/',/-:;_i ,'/::::;·´ ,'´
'; ,' \ '`;/' '`·. `'¯¯ ' , ·'´
`'*´ '`~·-·^'´ `' ~·- .,. -·~ ´
'
Available commands:
adhoc - Run adhoc command or script on matching nodes
executions - List running executions, attach and follow their output, or kill them
jobs - List and manage Jobs
keys - Manage Keys via the Key Storage Facility.
metrics - View metrics endpoints information
nodes - List node resources
projects - List and manage projects
retry - Run a Job based on a specific execution
run - Run a Job
scheduler - View scheduler information
system - View system information
tokens - Create, and manage tokens
users - Manage user information
Use "rd [command] help" to get help on any command.
liumiaocn:~ liumiao$
使用设定
缺省设定文件
在Unix下,可使用如下文件保存相关的设定文件内容
设定文件:~/.rd/rd.conf
环境变量方式设定
常用的环境变量如下所示:
- RD_URL: Rundeck连接URL
- RD_TOKEN: 连接TOKEN
- RD_USER:连接用户名(与RD_PASSWORD结合使用)
- RD_PASSWORD:连接密码
…
使用示例
以Project相关操作为例,进行如下说明
查询Project
- 列出所有project信息
可以看到目前有一个名为rundeck-test-project的project
liumiaocn:~ liumiao$ RD_URL=http://localhost:32044 RD_USER=admin RD_PASSWORD=admin java -jar rundeck-cli-1.1.1-all.jar projects list
# 1 Projects:
rundeck-test-project
liumiaocn:~ liumiao$
创建Project
可以使用多种方式进行project的创建,这里将相关的参数通过命令行的方式直接传入进行创建
liumiaocn:~ liumiao$ RD_URL=http://localhost:32044 RD_USER=admin RD_PASSWORD=admin java -jar rundeck-cli-1.1.1-all.jar projects create -p rundeck-test-cli-project -- --project.lable="Rundeck Test Cli Project"
# Created project:
# rundeck-test-cli-project
liumiaocn:~ liumiao$
创建之后结果确认
liumiaocn:~ liumiao$ RD_URL=http://localhost:32044 RD_USER=admin RD_PASSWORD=admin java -jar rundeck-cli-1.1.1-all.jar projects list
# 2 Projects:
rundeck-test-cli-project
rundeck-test-project
liumiaocn:~ liumiao$
Web页面结果的确认
除了创建了查询所有项目,页面可以进行的操作基本通过cli都可以进行,这里就不再一一例证
liumiaocn:~ liumiao$ RD_URL=http://localhost:32044 RD_USER=admin RD_PASSWORD=admin java -jar rundeck-cli-1.1.1-all.jar projects
No command was specified.
List and manage projects.
Available commands:
acls - Manage Project ACLs
archives - Project Archives import and export
configure - Manage Project configuration
create - Create a project
delete - Delete a project
info - Get info about a project
list - List all projects
readme - Manage Project readme
scm - Manage Project SCM
Use "projects [command] help" to get help on any command.
liumiaocn:~ liumiao$
其他内容
参考内容
https://www.rundeck.com/open-source
https://rundeck.github.io/rundeck-cli/commands/
https://rundeck.github.io/rundeck-cli/install/
https://rundeck.github.io/rundeck-cli/configuration/
标签:集成,project,cli,示例,jar,rundeck,RD,1.1,CLI 来源: https://blog.csdn.net/liumiaocn/article/details/89208749