ansible笔记（5）- 命令类模块

command模块

一、功能

　　command 模块可以帮助我们在远程主机上执行命令。

　　注意：使用 command 模块在远程主机中执行命令时，不会经过远程主机的 shell 处理，在使用 command 模块时，如果需要执行的命令中含有重定向、管道符等操作时，这些符号也会失效，比如”<”, “>”, “|”, “;” 和 “&” 这些符号，如果你需要这些功能，可以参考后面介绍的 shell 模块。还有一点需要注意，如果远程节点是 windows 操作系统，则需要使用 win_command 模块。

　　执行 ansible 时，不加 -m 默认使用 command ，可以在 /etc/ansible/ansible.cfg 中修改。

# default module name for /usr/bin/ansible
#module_name = command

 

二、命令参数

　　free_form参数 ：必须参数，指定需要远程执行的命令。需要说明一点，free_form 参数与其他参数（如果想要使用一个参数，那么则需要为这个参数赋值，也就是name=value模式）并不相同。比如，当我们想要在远程主机上执行 ls 命令时，我们并不需要写成”free_form=ls” ，这样写反而是错误的，因为并没有任何参数的名字是 free_form，当我们想要在远程主机中执行 ls 命令时，直接写成 ls 即可。因为 command 模块的作用是执行命令，所以，任何一个可以在远程主机上执行的命令都可以被称为 free_form。

[root@tlur31drk8wk ~]# ansible all -m command -a "ls"
192.168.161.22 | SUCCESS | rc=0 >>
anaconda-ks.cfg
dead.letter
Desktop
Documents
Downloads

　　chdir参数 : 此参数的作用就是指定一个目录，在执行对应的命令之前，会先进入到 chdir 参数指定的目录中。

[root@tlur31drk8wk ~]# ansible all -m command -a "chdir=/opt ls"
192.168.161.97 | SUCCESS | rc=0 >>
1.sh
hdltmp
hdltmp_20190625.zip

　　creates参数 ：看到 creates，你可能会从字面上理解这个参数，但是使用这个参数并不会帮助我们创建文件，它的作用是当指定的文件存在时，就不执行对应命令，比如，如果 /testdir/test文件存在，就不执行我们指定的命令。

[root@tlur31drk8wk ~]# ansible all -m command -a "creates=/opt/1.sh echo hello"
192.168.161.97 | SUCCESS | rc=0 >>
skipped, since /opt/1.sh exists

[root@tlur31drk8wk ~]# ansible all -m command -a "creates=/opt/2.sh echo hello" 
192.168.161.5 | SUCCESS | rc=0 >>
hello

　　removes参数 ：与 creates 参数的作用正好相反，它的作用是当指定的文件不存在时，就不执行对应命令，比如，如果 /testdir/tests 文件不存在，就不执行我们指定的命令，此参数并不会帮助我们删除文件。

[root@tlur31drk8wk ~]# ansible all -m command -a "removes=/opt/1.sh echo hello"         
192.168.161.97 | SUCCESS | rc=0 >>
hello

[root@tlur31drk8wk ~]# ansible all -m command -a "removes=/opt/2.sh echo hello" 
192.168.161.149 | SUCCESS | rc=0 >>
skipped, since /opt/2.sh does not exist

 

shell模块

 

一、功能

　　shell 模块可以帮助我们在远程主机上执行命令。与 command 模块不同的是，shell 模块在远程主机中执行命令时，会经过远程主机上的 /bin/sh 程序处理。

 

二、命令参数

　　其中chdir、creates、removes参数与command中的对应参数使用方式相同，不进行举例。

　　free_form参数 ：必须参数，指定需要远程执行的命令，但是并没有具体的一个参数名叫free_form，具体解释参考 command 模块。

[root@tlur31drk8wk ~]# ansible all -m shell -a "ls"                                 
192.168.161.5 | SUCCESS | rc=0 >>
anaconda-ks.cfg
dead.letter
Desktop

　　chdir参数 : 此参数的作用就是指定一个目录，在执行对应的命令之前，会先进入到 chdir 参数指定的目录中。

　　creates参数 ：使用此参数指定一个文件，当指定的文件存在时，就不执行对应命令，可参考command 模块中的解释。

　　removes参数 ：使用此参数指定一个文件，当指定的文件不存在时，就不执行对应命令，可参考 command 模块中的解释。

　　executable参数：默认情况下，shell 模块会调用远程主机中的 /bin/sh 去执行对应的命令，通常情况下，远程主机中的默认 shell 都是 bash。如果你想要使用其他类型的 shell 执行命令，则可以使用此参数指定某种类型的 shell 去执行对应的命令。指定 shell 文件时，需要使用绝对路径。

 

scrpit模块

一、功能

　　script 模块可以帮助我们在远程主机上执行 ansible 管理主机上的脚本，也就是说，脚本一直存在于 ansible 管理主机本地，不需要手动拷贝到远程主机后再执行。

 

 

二、命令参数

　　其中chdir、creates、removes参数与command中的对应参数使用方式相同，不进行举例。

　　free_form参数 ：必须参数，指定需要执行的脚本，脚本位于 ansible 管理主机本地，并没有具体的一个参数名叫 free_form，具体解释请参考 command 模块。

[root@tlur31drk8wk ~]# ansible all -m script -a "test.sh"
192.168.161.51 | SUCCESS => {
    "changed": true, 
    "rc": 0, 
    "stderr": "Shared connection to 192.168.161.51 closed.\r\n", 
    "stderr_lines": [
        "Shared connection to 192.168.161.51 closed."
    ], 
    "stdout": "helloworld\r\n", 
    "stdout_lines": [
        "helloworld"
    ]
}

其中，test.sh内容为输出helloworld字符窜

　　chdir参数 : 此参数的作用就是指定一个远程主机中的目录，在执行对应的脚本之前，会先进入到 chdir 参数指定的目录中。

　　creates参数 ：使用此参数指定一个远程主机中的文件，当指定的文件存在时，就不执行对应脚本，可参考 command 模块中的解释。

　　removes参数 ：使用此参数指定一个远程主机中的文件，当指定的文件不存在时，就不执行对应脚本，可参考 command 模块中的解释。