自动化运维工具--ansible详解（常用模块篇）

阳光穿透心脏的1/2处 2023-06-06 12:24 41阅读 0赞

## 1、主机连通性测试 ##

我们使用`ansible web -m ping`命令来进行主机连通性测试，效果如下：

[root@server ~]# ansible web -m ping
    172.17.0.3 | SUCCESS => {
        "ansible_facts": {
            "discovered_interpreter_python": "/usr/bin/python"
        }, 
        "changed": false, 
        "ping": "pong"
    }
    172.17.0.4 | SUCCESS => {
        "ansible_facts": {
            "discovered_interpreter_python": "/usr/bin/python"
        }, 
        "changed": false, 
        "ping": "pong"
    }
    172.17.0.6 | SUCCESS => {
        "ansible_facts": {
            "discovered_interpreter_python": "/usr/bin/python"
        }, 
        "changed": false, 
        "ping": "pong"
    }
    172.17.0.5 | SUCCESS => {
        "ansible_facts": {
            "discovered_interpreter_python": "/usr/bin/python"
        }, 
        "changed": false, 
        "ping": "pong"
    }

这样就说明我们的主机是连通状态的。接下来的操作才可以正常进行。

### 2、command 模块 ###

这个模块可以直接在远程主机上执行命令，并将结果返回本主机。  
　　举例如下：

[root@server ~]# ansible web -m command -a 'ss -ntl'
    172.17.0.5 | CHANGED | rc=0 >>
    State      Recv-Q Send-Q Local Address:Port               Peer Address:Port              
    LISTEN     0      128          *:22                       *:*                  
    LISTEN     0      128       [::]:22                    [::]:*                  
    
    172.17.0.6 | CHANGED | rc=0 >>
    State      Recv-Q Send-Q Local Address:Port               Peer Address:Port              
    LISTEN     0      128          *:22                       *:*                  
    LISTEN     0      128       [::]:22                    [::]:*                  
    
    172.17.0.4 | CHANGED | rc=0 >>
    State      Recv-Q Send-Q Local Address:Port               Peer Address:Port              
    LISTEN     0      128          *:22                       *:*                  
    LISTEN     0      128       [::]:22                    [::]:*                  
    
    172.17.0.3 | CHANGED | rc=0 >>
    State      Recv-Q Send-Q Local Address:Port               Peer Address:Port              
    LISTEN     0      128          *:22                       *:*                  
    LISTEN     0      128       [::]:22                    [::]:*

命令模块接受命令名称，后面是空格分隔的列表参数。给定的命令将在所有选定的节点上执行。它不会通过shell进行处理，比如$HOME和操作如"<"，">"，"|"，";"，"&" 工作（需要使用（shell）模块实现这些功能）。注意，该命令不支持`| 管道命令`。  
　　下面来看一看该模块下常用的几个命令：

> chdir　　　 \# 在执行命令之前，先切换到该目录 cd  
> executable \# 切换shell来执行命令，需要使用命令的绝对路径  
> free\_form 　 \# 要执行的Linux指令，一般使用Ansible的-a参数代替。  
> creates 　 \# 一个文件名，当这个文件存在，则该命令不执行,可以用来做判断  
> removes \# 一个文件名，这个文件不存在，则该命令不执行

下面我们来看看这些命令的执行效果：

[root@server ~]# ansible web -m command -a 'chdir=/data/ ls'  #先切换到/data/ 目录，再执行“ls”命令
    192.168.37.122 | SUCCESS | rc=0 >>
    aaa.jpg
    fastdfs
    mogdata
    tmp
    web
    wKgleloeYoCAMLtZAAAWEekAtkc497.jpg
    
    192.168.37.133 | SUCCESS | rc=0 >>
    aaa.jpg
    fastdfs
    mogdata
    tmp
    web
    wKgleloeYoCAMLtZAAAWEekAtkc497.jpg
    [root@server ~]# ansible web -m command -a 'creates=/data/aaa.jpg ls'  #如果/data/aaa.jpg存在，则不执行“ls”命令
    192.168.37.122 | SUCCESS | rc=0 >>                                                                              
    skipped, since /data/aaa.jpg exists
    
    192.168.37.133 | SUCCESS | rc=0 >>
    skipped, since /data/aaa.jpg exists
    [root@server ~]# ansible web -m command -a 'removes=/data/aaa.jpg cat /data/a' #如果/data/aaa.jpg存在，则执行“cat /data/a”命令
    192.168.37.122 | SUCCESS | rc=0 >>
    hello
    
    192.168.37.133 | SUCCESS | rc=0 >>
    hello

### 3、shell 模块 ###

shell模块可以在远程主机上调用shell解释器运行命令，支持shell的各种功能，例如管道等。

[root@server ~]# ansible web -m shell -a 'cat /etc/passwd |grep "root"'
    172.17.0.6 | CHANGED | rc=0 >>
    root:x:0:0:root:/root:/bin/bash
    operator:x:11:0:operator:/root:/sbin/nologin
    
    172.17.0.5 | CHANGED | rc=0 >>
    root:x:0:0:root:/root:/bin/bash
    operator:x:11:0:operator:/root:/sbin/nologin
    
    172.17.0.4 | CHANGED | rc=0 >>
    root:x:0:0:root:/root:/bin/bash
    operator:x:11:0:operator:/root:/sbin/nologin
    
    172.17.0.3 | CHANGED | rc=0 >>
    root:x:0:0:root:/root:/bin/bash
    operator:x:11:0:operator:/root:/sbin/nologin

只要是我们的shell命令，都可以通过这个模块在远程主机上运行，这里就不一一举例了。

### 4、copy 模块 ###

这个模块用于将文件复制到远程主机，同时支持给定内容生成文件和修改权限等。  
　　其相关选项如下：

> `src`　　　　 \#被复制到远程主机的本地文件。可以是绝对路径，也可以是相对路径。如果路径是一个目录，则会递归复制，用法类似于"rsync"  
> `content`　　\#用于替换"src"，可以直接指定文件的值  
> `dest`　　　 \#必选项，将源文件复制到的远程主机的**绝对路径**  
> `backup`　　　\#当文件内容发生改变后，在覆盖之前把源文件备份，备份文件包含时间信息  
> `directory_mode`　　　　\#递归设定目录的权限，默认为系统默认权限  
> `force`　　　　\#当目标主机包含该文件，但内容不同时，设为"yes"，表示强制覆盖；设为"no"，表示目标主机的目标位置不存在该文件才复制。默认为"yes"  
> `others`　　　　\#所有的 file 模块中的选项可以在这里使用

用法举例如下：  
**① 复制文件：**

[root@server ~]# ansible web -m copy -a 'src=~/hello dest=/data/hello' 
    192.168.37.122 | SUCCESS => {
        "changed": true, 
        "checksum": "22596363b3de40b06f981fb85d82312e8c0ed511", 
        "dest": "/data/hello", 
        "gid": 0, 
        "group": "root", 
        "md5sum": "6f5902ac237024bdd0c176cb93063dc4", 
        "mode": "0644", 
        "owner": "root", 
        "size": 12, 
        "src": "/root/.ansible/tmp/ansible-tmp-1512437093.55-228281064292921/source", 
        "state": "file", 
        "uid": 0
    }
    192.168.37.133 | SUCCESS => {
        "changed": true, 
        "checksum": "22596363b3de40b06f981fb85d82312e8c0ed511", 
        "dest": "/data/hello", 
        "gid": 0, 
        "group": "root", 
        "md5sum": "6f5902ac237024bdd0c176cb93063dc4", 
        "mode": "0644", 
        "owner": "root", 
        "size": 12, 
        "src": "/root/.ansible/tmp/ansible-tmp-1512437093.74-44694985235189/source", 
        "state": "file", 
        "uid": 0
    }

**② 给定内容生成文件，并制定权限**

[root@server ~]# ansible web -m copy -a 'content="I am keer\n" dest=/data/name mode=666'
    192.168.37.122 | SUCCESS => {
        "changed": true, 
        "checksum": "0421570938940ea784f9d8598dab87f07685b968", 
        "dest": "/data/name", 
        "gid": 0, 
        "group": "root", 
        "md5sum": "497fa8386590a5fc89090725b07f175c", 
        "mode": "0666", 
        "owner": "root", 
        "size": 10, 
        "src": "/root/.ansible/tmp/ansible-tmp-1512437327.37-199512601767687/source", 
        "state": "file", 
        "uid": 0
    }
    192.168.37.133 | SUCCESS => {
        "changed": true, 
        "checksum": "0421570938940ea784f9d8598dab87f07685b968", 
        "dest": "/data/name", 
        "gid": 0, 
        "group": "root", 
        "md5sum": "497fa8386590a5fc89090725b07f175c", 
        "mode": "0666", 
        "owner": "root", 
        "size": 10, 
            "src": "/root/.ansible/tmp/ansible-tmp-1512437327.55-218104039503110/source", 
        "state": "file", 
        "uid": 0
    }

我们现在可以去查看一下我们生成的文件及其权限：

[root@server ~]# ansible web -m shell -a 'ls -l /data/'
    192.168.37.122 | SUCCESS | rc=0 >>
    total 28
    -rw-rw-rw-   1 root root   12 Dec  6 09:45 name
    
    192.168.37.133 | SUCCESS | rc=0 >>
    total 40
    -rw-rw-rw- 1 root     root       12 Dec  5 09:45 name

可以看出我们的name文件已经生成，并且权限为666。  
**③ 关于覆盖**  
　　我们把文件的内容修改一下，然后选择覆盖备份：

[root@server ~]# ansible web -m copy -a 'content="I am keerya\n" backup=yes dest=/data/name mode=666'
    192.168.37.122 | SUCCESS => {
        "backup_file": "/data/name.4394.2017-12-06@09:46:25~", 
        "changed": true, 
        "checksum": "064a68908ab9971ee85dbc08ea038387598e3778", 
        "dest": "/data/name", 
        "gid": 0, 
        "group": "root", 
        "md5sum": "8ca7c11385856155af52e560f608891c", 
        "mode": "0666", 
        "owner": "root", 
        "size": 12, 
        "src": "/root/.ansible/tmp/ansible-tmp-1512438383.78-228128616784888/source", 
        "state": "file", 
        "uid": 0
    }
    192.168.37.133 | SUCCESS => {
        "backup_file": "/data/name.5962.2017-12-05@09:46:24~", 
        "changed": true, 
        "checksum": "064a68908ab9971ee85dbc08ea038387598e3778", 
        "dest": "/data/name", 
        "gid": 0, 
        "group": "root", 
        "md5sum": "8ca7c11385856155af52e560f608891c", 
        "mode": "0666", 
        "owner": "root", 
        "size": 12, 
        "src": "/root/.ansible/tmp/ansible-tmp-1512438384.0-170718946740009/source", 
        "state": "file", 
        "uid": 0
    }

现在我们可以去查看一下：

[root@server ~]# ansible web -m shell -a 'ls -l /data/'
    192.168.37.122 | SUCCESS | rc=0 >>
    total 28
    -rw-rw-rw-   1 root root   12 Dec  6 09:46 name
    -rw-rw-rw-   1 root root   10 Dec  6 09:45 name.4394.2017-12-06@09:46:25~
    
    192.168.37.133 | SUCCESS | rc=0 >>
    total 40
    -rw-rw-rw- 1 root     root       12 Dec  5 09:46 name
    -rw-rw-rw- 1 root     root       10 Dec  5 09:45 name.5962.2017-12-05@09:46:24~

可以看出，我们的源文件已经被备份，我们还可以查看一下`name`文件的内容：

[root@server ~]# ansible web -m shell -a 'cat /data/name'
    192.168.37.122 | SUCCESS | rc=0 >>
    I am keerya
    
    192.168.37.133 | SUCCESS | rc=0 >>
    I am keerya

证明，这正是我们新导入的文件的内容。

### 5、file 模块 ###

该模块主要用于设置文件的属性，比如创建文件、创建链接文件、删除文件等。  
　　下面是一些常见的命令：

> `force`　　\#需要在两种情况下强制创建软链接，一种是源文件不存在，但之后会建立的情况下；另一种是目标软链接已存在，需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no  
> `group`　　\#定义文件/目录的属组。后面可以加上`mode`：定义文件/目录的权限  
> `owner`　　\#定义文件/目录的属主。后面必须跟上`path`：定义文件/目录的路径  
> `recurse`　　\#递归设置文件的属性，只对目录有效，后面跟上
> 
> `src`： \# 被链接的源文件路径，只应用于`state=link`的情况  
> `dest`　　\#被链接到的路径，只应用于`state=link`的情况  
> `state`　　\#状态，有以下选项：
> 
> `directory`：如果目录不存在，就创建目录  
> `file`：即使文件不存在，也不会被创建  
> `link`：创建软链接  
> `hard`：创建硬链接  
> `touch`：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间  
> `absent`：删除目录、文件或者取消链接文件

用法举例如下：  
**① 创建目录：**

[root@server ~]# ansible web -m file -a 'path=/data/app state=directory'
    192.168.37.122 | SUCCESS => {
        "changed": true, 
        "gid": 0, 
        "group": "root", 
        "mode": "0755", 
        "owner": "root", 
        "path": "/data/app", 
        "size": 6, 
        "state": "directory", 
        "uid": 0
    }
    192.168.37.133 | SUCCESS => {
        "changed": true, 
        "gid": 0, 
        "group": "root", 
        "mode": "0755", 
        "owner": "root", 
        "path": "/data/app", 
        "size": 4096, 
        "state": "directory", 
        "uid": 0
    }

我们可以查看一下：

[root@server ~]# ansible web -m shell -a 'ls -l /data'
    192.168.37.122 | SUCCESS | rc=0 >>
    total 28
    drwxr-xr-x   2 root root    6 Dec  6 10:21 app
    
    192.168.37.133 | SUCCESS | rc=0 >>
    total 44
    drwxr-xr-x 2 root     root     4096 Dec  5 10:21 app

可以看出，我们的目录已经创建完成。  
**② 创建链接文件**

[root@server ~]# ansible web -m file -a 'path=/data/bbb.jpg src=aaa.jpg state=link'
    192.168.37.122 | SUCCESS => {
        "changed": true, 
        "dest": "/data/bbb.jpg", 
        "gid": 0, 
        "group": "root", 
        "mode": "0777", 
        "owner": "root", 
        "size": 7, 
        "src": "aaa.jpg", 
        "state": "link", 
        "uid": 0
    }
    192.168.37.133 | SUCCESS => {
        "changed": true, 
        "dest": "/data/bbb.jpg", 
        "gid": 0, 
        "group": "root", 
        "mode": "0777", 
        "owner": "root", 
        "size": 7, 
        "src": "aaa.jpg", 
        "state": "link", 
        "uid": 0
    }
    [root@server ~]# ansible web -m file -a 'path=/root/dd.jpg src=/root/app1 state=hard'
    172.17.0.3 | SUCCESS => {
        "changed": true, 
        "dest": "/root/dd.jpg", 
        "gid": 0, 
        "group": "root", 
        "mode": "0644", 
        "owner": "root", 
        "size": 5, 
        "src": "/root/app1", 
        "state": "hard", 
        "uid": 0
    }
    172.17.0.4 | SUCCESS => {
        "changed": true, 
        "dest": "/root/dd.jpg", 
        "gid": 0, 
        "group": "root", 
        "mode": "0644", 
        "owner": "root", 
        "size": 5, 
        "src": "/root/app1", 
        "state": "hard", 
        "uid": 0
    }

我们可以去查看一下：

[root@server ~]# ansible web -m shell -a 'ls -l /data'
    192.168.37.122 | SUCCESS | rc=0 >>
    total 28
    -rw-r--r--   1 root root 5649 Dec  5 13:49 aaa.jpg
    lrwxrwxrwx   1 root root    7 Dec  6 10:25 bbb.jpg -> aaa.jpg
    
    192.168.37.133 | SUCCESS | rc=0 >>
    total 44
    -rw-r--r-- 1 root     root     5649 Dec  4 14:44 aaa.jpg
    lrwxrwxrwx 1 root     root        7 Dec  5 10:25 bbb.jpg -> aaa.jpg

我们的链接文件已经创建成功。  
**③ 删除文件**

[root@server ~]# ansible web -m file -a 'path=/data/a state=absent'
    192.168.37.122 | SUCCESS => {
        "changed": true, 
        "path": "/data/a", 
        "state": "absent"
    }
    192.168.37.133 | SUCCESS => {
        "changed": true, 
        "path": "/data/a", 
        "state": "absent"
    }

我们可以查看一下：

[root@server ~]# ansible web -m shell -a 'ls /data/a'
    192.168.37.122 | FAILED | rc=2 >>
    ls: cannot access /data/a: No such file or directory
    
    192.168.37.133 | FAILED | rc=2 >>
    ls: cannot access /data/a: No such file or directory

发现已经没有这个文件了。