06-Ansible常用模块-command模块

一、概述

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

• 使用 command 模块在远程主机中执行命令时，不会经过远程主机的 shell 处理。
• 使用 command 模块时，如果需要执行的命令中含有重定向、管道符等操作时，这些符号也会失效，比如”<”, “>”, “|”, “;” 和 “&” 这些符号。
• 如果你需要这些功能，可以参考后面介绍的 shell 模块。还有一点需要注意，如果远程节点是 window操作系统，则需要使用 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。
• chdir参数 : 此参数的作用就是指定一个目录，在执行对应的命令之前，会先进入到 chdir 参数指定的目录中。
• creates参数 ： 看到 creates，你可能会从字面上理解这个参数，但是使用这个参数并不会帮助我们创建文件，它的作用是当指定的文件存在时，就不执行对应命令，比如，如果
  /testdir/test文件存在，就不执行我们指定的命令。
• removes参数 ： 与 creates 参数的作用正好相反，它的作用是当指定的文件不存在时，就不执行对应命令，比如，如果 /testdir/tests 文件不存在，就不执行我们指定的命令，此参数并不会帮助我们删除文件。

三、示例

1、 在group1主机上执行 ls 命令，使用的是 root 用户默认情况下，ls 出的结果是 group1主机中 root 用户家目录中的文件列表。

[root@Ansible ~]# ansible group1 -m command -a "ls"
192.168.0.161 | CHANGED | rc=0 >>
1.txt
anaconda-ks.cfg
apache-maven-3.6.3
apache-maven-3.6.3-bin.tar.gz
192.168.0.160 | CHANGED | rc=0 >>
1.txt
anaconda-ks.cfg

2、chdir 参数表示执行命令之前，进入到指定的目录中，查看group1主机上 /test 目录中的文件列表。

[root@Ansible ~]# ansible group1 -m command -a "chdir=/test ls"
192.168.0.161 | CHANGED | rc=0 >>
t1.txt
192.168.0.160 | CHANGED | rc=0 >>
t1.txt

3、192.168.0.160主机编写测试文件

[root@CentOSA test]# mkdir /test02
[root@CentOSA test]# echo "CentOSA">>/test02/t1.txt
[root@CentOSA test]# cd /test02
[root@CentOSA test02]# ls
t1.txt

creates如下命令表示/test02/t1.txt文件存在于远程主机中，则不执行对应命令。/test02/t1.txt不存在，才执行”echo test02”命令。

[root@Ansible ~]# ansible group1 -m command -a "creates=/test02/t1.txt echo test02"
192.168.0.160 | SUCCESS | rc=0 >>
skipped, since /test02/t1.txt exists
192.168.0.161 | CHANGED | rc=0 >>
test02

4、removes如下命令表示/test02/t1.txt 文件不存在于远程主机中，则不执行对应命令。/test02/t1.txt存在，才执行”echo test”命令。

[root@Ansible ~]# ansible group1 -m command -a "removes=/test02/t1.txt echo test02"       
192.168.0.160 | CHANGED | rc=0 >>
test02
192.168.0.161 | SUCCESS | rc=0 >>
skipped, since /test02/t1.txt does not exist