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. ", "stderr_lines": [ "Shared connection to 192.168.161.51 closed." ], "stdout": "helloworld ", "stdout_lines": [ "helloworld" ] } 其中,test.sh内容为输出helloworld字符窜
chdir参数 : 此参数的作用就是指定一个远程主机中的目录,在执行对应的脚本之前,会先进入到 chdir 参数指定的目录中。
creates参数 :使用此参数指定一个远程主机中的文件,当指定的文件存在时,就不执行对应脚本,可参考 command 模块中的解释。
removes参数 :使用此参数指定一个远程主机中的文件,当指定的文件不存在时,就不执行对应脚本,可参考 command 模块中的解释。