ansible的command模块

ansible的command模块

微信搜索 zze_coding 或扫描 👉 二维码关注我的微信公众号获取更多资源推送:

此文章为「ansible笔记(2)之常用模块」的子文章。

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

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

参数说明:

  • free_form:必须参数,指定需要远程执行的命令,需要说明一点,free_form 参数与其他参数并不相同,在之前的模块示例中,如果想要使用一个参数,那么则需要为这个参数赋值,举个例子,之前的示例模块中,大多都有 path 参数,当我们需要指定要操作的文件时,通常需要对 path 参数赋值,比如,path=/testdir/test,表示我们想要操作 /testdir/test 文件,但是 free_form 参数则不同,free_form 并不是一个实际存在的参数名,比如,当我们想要在远程主机上执行 ls 命令时,我们并不需要写成 free_form=ls,这样写反而是错误的,因为并没有任何参数的名字是 free_form,当我们想要在远程主机中执行 ls 命令时,直接写成 ls 即可,这就是 free_form 参数的含义,因为 command 模块的作用是执行命令,所以,任何一个可以在远程主机上执行的命令都可以被称为 free_form
  • chdir:此参数的作用就是指定一个目录,在执行对应的命令之前,会先进入到 chdir 参数指定的目录中;
  • creates:看到 creates,你可能会从字面上理解这个参数,但是使用这个参数并不会帮助我们创建文件,它的作用是当指定的文件存在时,就不执行对应命令,比如,如果 /testdir/test 文件存在,就不执行我们指定的命令;
  • removes:与 creates 参数的作用正好相反,它的作用是当指定的文件不存在时,就不执行对应命令,比如,如果 /testdir/tests 文件不存在,就不执行我们指定的命令,此参数并不会帮助我们删除文;

例 1:使用如下命令,表示在客户机上执行 ls 命令,因为我使用的是 root 用户,所以默认情况下,ls 出的结果是客户机中 root 用户家目录中的文件列表。

$ ansible all -m command -a "ls"

例 2:chdir 参数表示执行命令之前,会先进入到指定的目录中,所以如下命令表示查看客户机上 /testdir 目录中的文件列表。

$ ansible all -m command -a "chdir=/testdir ls"

例 3:如下命令表示 /testdir/test 文件如果存在于远程主机中,则不执行对应命令,如果不存在,才执行 echo test 命令。

$ ansible all -m command -a "creates=/testdir/test echo test"

例 4:如下命令表示 /testdir/test 文件如果不存在于远程主机中,则不执行对应命令,如果存在,才执行 echo test 命令。

$ ansible all -m command -a "removes=/testdir/test echo test"

Copyright: 采用 知识共享署名4.0 国际许可协议进行许可

Links: https://www.zze.xyz/archives/ansible-module-command.html

Buy me a cup of coffee ☕.