Ansible常用模块，ad-hoc命令集与命令详细介绍

分手后的思念是犯贱 2021-10-18 16:54 367阅读 0赞

Ansible 默认提供了很多模块来供我们使用。在 Linux 中，我们可以通过 ansible-doc -l 命令查看到当前 ansible 都支持哪些模块，通过 ansible-doc -s 模块名 又可以查看该模块有哪些参数可以使用。  
官网文档：[http://docs.ansible.com/ansible/latest/list\_of\_all\_modules.html][http_docs.ansible.com_ansible_latest_list_of_all_modules.html]

Ansible常用模块
    
    1、ping模块
    2、raw模块
    3、yum模块
    4、apt模块
    5、pip模块
    6、synchronize模块
    7、template模块
    8、copy模块
    9、user 模块与group模块
    10、service 模块
    11、get_url 模块
    12、fetch模块
    13、file模块
    14、unarchive模块
    15、command 模块和shell

**1、ping模块**

检查指定节点机器是否还能连通，用法很简单，不涉及参数，主机如果在线，则回复pong![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70][]

**2、raw模块**

执行原始的命令，而不是通过模块子系统。在任何情况下，使用shell或命令模块是合适的。给定原始的参数直接通过配置的远程shell运行。可返回标准输出、错误输出和返回代码。此模块没有变更处理程序支持。  
这个模块不需要远程系统上的Python，就像脚本模块一样。此模块也支持Windows目标。

**3、yum模块**

这个模块是RedHat / CentOS作为远端节点的OS的时候，用的最多的。Yum是啥就不多说了，RedHat / CentOS包管理工具
    使用`yum’软件包管理器管理软件包，其选项有：
    – config_file：yum的配置文件 （optional）
    – disable_gpg_check：关闭gpg_check （optional）
    – disablerepo：不启用某个源 （optional）
    – enablerepo：启用某个源（optional）
    – name：要进行操作的软件包的名字，默认最新的程序包，指明要安装的程序包，可以带上版本号，也可以传递一个url或者一个本地的rpm包的路径
    – state：状态（present，absent，latest），表示是安装还卸载
    present:默认的，表示为安装
    lastest: 安装为最新的版本
    absent：表示删除

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 1][]

![20190812231113356.png][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 2][]

**4 template模块**

基于模板方式生成一个文件复制到远程主机（template使用Jinjia2格式作为文件模版，进行文档内变量的替换的模块。它的每次使用都会被ansible标记为”changed”状态。）  
– backup： 如果原目标文件存在，则先备份目标文件  
– src：在ansible控制器上的Jinja2格式化模板的路径。 这可以是相对或绝对的路径。  
– dest：将模板渲染到远程机器上的位置。  
force：是否强制覆盖，默认为yes  
– owner：目标文件属主  
– group：目标文件属组  
– mode：目标文件的权限模式，模式可以被指定为符号模式（例如，u + rwx或u = rw，g = r，o = r）。  
**5 copy模块**

在远程主机执行复制操作文件。  
– src：要复制到远程主机的文件在本地的地址，可以是绝对路径，也可以是相对路径。如果路径是一个目录，它将递归复制。在这种情况下，如果路径使用”/”来结尾，则只复制目录里的内容，如果没有使用”/”来结尾，则包含目录在内的整个内容全部复制，类似于rsync。  
– content：用于替代”src”,可以直接设定指定文件的值  
– dest：必选项。要将源文件复制到的远程主机的绝对路径，如果源文件是一个目录，那么该路径也必须是个目录  
– directory\_mode：递归的设定目录的权限，默认为系统默认权限  
– force：如果目标主机包含该文件，但内容不同，如果设置为yes，则强制覆盖，如果为no，则只有当目标主机的目标位置不存在该文件时，才复制。默认为yes  
– others：所有的file模块里的选项都可以在这里使用

**6 user 模块与group模块**

user模块是请求的是useradd, userdel, usermod三个指令，goup模块请求的是groupadd, groupdel, groupmod 三个指令。  
（1）user模块

– home：指定用户的家目录，需要与createhome配合使用。  
– groups：指定用户的属组。  
– uid：指定用的uid。  
– password：指定用户的密码。  
注意：指定password参数时，不能使用明文密码，因为后面这一串密码会被直接传送到被管理主机的/etc/shadow文件中，所以需要先将密码字符串进行加密处理。然后将得到的字符串放到password中即可。    
– name：指定用户名。  
– createhome：是否创建家目录 yes|no。  
– system：是否为系统用户。  
– remove：当state=absent时，remove=yes则表示连同家目录一起删除，等价于userdel -r。  
– state：是创建还是删除。（present，absent）  
– shell：指定用户的shell环境。  
– generate\_ssh\_key：是否为相关用户生成SSH密钥。 这不会覆盖现有的SSH密钥。  
– ssh\_key\_bits：可选择指定要创建的SSH密钥中的位数。  
– ssh\_key\_passphrase：设置SSH密钥的密码。 如果没有提供密码，SSH密钥将默认没有密码。  
– ssh\_key\_file：指定SSH密钥文件名（可选）。 如果这是一个相对的文件名，那么它将是相对于用户的主目录。  
– ssh\_key\_type：指定要生成的SSH密钥的类型（可选）。 可用的SSH密钥类型将取决于目标主机上的实现。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 3][]

加密方式添加用户

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 4][]

![20190812231502921.png][]

加密字符串可以自定义aaaaaaa“

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 5][]

![20190812231555160.png][]  
（2）group模块

– gid：指定用的gid。  
– name：指定用户名。  
– state：是创建还是删除。（present，absent）  
– system：如果是，则表示创建的组是系统组。

**7 service 模块**

用于管理服务，记得针对Centos7就不要使用这个模块了。  
– arguments：给命令行提供一些选项  
– enabled：是否开机启动 yes|no, 要求状态（state）和启用（enabled）中至少有一个。  
– name：必选项，服务名称  
– runlevel：运行级别  
– sleep：如果执行了restarted，在则stop和start之间沉睡几秒钟  
– state：对当前服务执行启动，停止、重启、重新加载等操作（started,stopped,restarted,reloaded）  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 6][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 7][]

关闭服务后。server2的80端口消失。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 8][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 9][]

**8 get\_url 模块**

该模块主要用于从http、ftp、https服务器上下载文件（类似于wget），主要有如下选项：  
– sha256sum：下载完成后进行sha256 check；  
– timeout：下载超时时间，默认10s  
– url：下载的URL  
– url\_password、url\_username：主要用于需要用户名密码进行验证的情况  
– dest：将文件下载到哪里的绝对路径。如果dest是目录，则使用服务器提供的文件名，或者如果没有提供，将使用远程服务器上的URL的基本名称。  
– headers：以格式“key：value，key：value”为请求添加自定义HTTP标头。

**9 pip模块**

用于管理Python库依赖项，为了使用pip模块，必须提供参数name或者requirements  
– chdir： 执行pip命令前cd进入的目录  
– name：要安装的Python库的名称或远程包的URL。  
– requirements：一个pip requirements.txt文件的路径，它应该是远程系统的本地文件，如果使用chdir选项，则可以将文件指定为相对路径。  
– version：指定的Python库的安装版本。  
– extra\_args：额外的参数传递给pip。  
– executable：显式可执行文件或可执行文件的路径名，用于为系统中安装的特定版本的Python运行pip。 例如pip-3.3，如果系统中安装了Python 2.7和3.3，并且想要为Python 3.3安装运行pip。 它不能与“virtualenv”参数一起指定（在2.1中添加）。 默认情况下，它将采用适用于python解释器的版本。 pip3在python 3上，pip2或pip在python 2上。  
– virtualenv：要安装到的virtualenv目录的可选路径。 它不能与’executable’参数一起指定（在2.1中添加）。 如果virtualenv不存在，则将在安装软件包之前创建它。 可选的virtualenv\_site\_packages，virtualenv\_command和virtualenv\_python选项会影响virtualenv的创建。  
– virtualenv\_command：用于创建虚拟环境的命令或路径名。 例如pyvenv，virtualenv，virtualenv2，~/bin /virtualenv，/usr/local/bin/virtualenv。  
– virtualenv\_python：用于创建虚拟环境的Python可执行文件。 例如python3.5，python2.7。 未指定时，将使用用于运行ansible模块的Python版本。 当virtualenv\_command使用pyvenv或-m venv模块时，不应使用此参数。  
– state：状态（present，absent，latest， forcereinstall），表示是安装还卸载  
present:默认的，表示为安装  
lastest: 安装为最新的版本  
absent：表示删除  
forcereinstall：“forcereinstall”选项仅适用于可ansible 2.1及更高版本。

**10 synchronize模块**

– 使用rsync同步文件，将主控方目录推送到指定节点的目录下，其参数如下：  
– delete： 删除不存在的文件，delete=yes 使两边的内容一样（即以推送方为主），默认no  
– src： 要同步到目的地的源主机上的路径; 路径可以是绝对的或相对的。如果路径使用”/”来结尾，则只复制目录里的内容，如果没有使用”/”来结尾，则包含目录在内的整个内容全部复制  
– dest：目的地主机上将与源同步的路径; 路径可以是绝对的或相对的。  
– dest\_port：默认目录主机上的端口 ，默认是22，走的ssh协议。  
– mode: push或pull，默认push，一般用于从本机向远程主机上传文件，pull 模式用于从远程主机上取文件。  
– rsync\_opts：通过传递数组来指定其他rsync选项。  
**11  fetch模块**

它用于从远程机器获取文件，并将其本地存储在由主机名组织的文件树中。  
– src：远程系统上要获取的文件。 这必须是一个文件，而不是一个目录。 后续版本可能会支持递归提取。  
– dest：保存文件的目录。 例如，如果dest目录是/backup，在主机host.example.com上命名为/ etc/profile的src文件将被保存到/backup/host.example.com/etc/profile。  
– flat：允许您覆盖将目标文件添加到主机名/ path / to / file的默认行为。

**12 file模块**

file模块主要用于远程主机上的文件操作，file模块包含如下选项：  
– force：需要在两种情况下强制创建软链接，一种是源文件不存在但之后会建立的情况下；另一种是目标软链接已存在,需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no  
– group：定义文件/目录的属组  
– mode：定义文件/目录的权限  
– owner：定义文件/目录的属主  
– path：必选项，定义文件/目录的路径  
– recurse：递归的设置文件的属性，只对目录有效  
– src：要被链接的源文件的路径，只应用于state=link的情况  
– dest：被链接到的路径，只应用于state=link的情况  
– state：  
directory：如果目录不存在，创建目录  
file：即使文件不存在，也不会被创建  
link：创建软链接  
hard：创建硬链接  
touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间  
absent：删除目录、文件或者取消链接文件  
**13 unarchive模块**

用于解压文件，模块包含如下选项：  
– copy：在解压文件之前，是否先将文件复制到远程主机，默认为yes。若为no，则要求目标主机上压缩包必须存在。  
– creates：指定一个文件名，当该文件存在时，则解压指令不执行  
– dest：远程主机上的一个路径，即文件解压的绝对路径。  
– group：解压后的目录或文件的属组  
– list\_files：如果为yes，则会列出压缩包里的文件，默认为no，2.0版本新增的选项  
– mode：解压后文件的权限  
– src：如果copy为yes，则需要指定压缩文件的源路径  
– owner：解压后文件或目录的属主

** 14 command 模块和shell script模块**

用于在各被管理节点运行指定的命令  
shell和command的区别：shell模块可以特殊字符，而command是不支持

（1）command模块

– chdir：在运行命令之前，切换到此目录。

（2）shell模块

– chdir：在运行命令之前，切换到此目录。  
– executable：更改用于执行命令的shell（bash，sh）。 应该是可执行文件的绝对路径。

（3）script模块

其是将管理端的shell 在被管理主机上执行，其原理是先将shell 复制到远程主机，再在远程主机上执行，原理类似于raw模块，“This module does not require python on the remote system, much like the raw module.” 。

**15、apt模块**

这个模块是ubuntu作为远端节点的OS的时候，用的最多的。Apt是啥就不多说了，Ubuntu/Debian的包管理工具。  
– deb： 用于安装远程机器上的.deb后缀的软件包（optional）  
– install\_recommends：这个参数可以控制远程电脑上是否只是下载软件包，还是下载后安装，默认参数为true,设置为false的时候只下载软件包，不安装  
– update\_cache： 当这个参数为yes的时候等于apt-get update（optional）  
– name： apt要下载的软件包名字，支持name=git=1.6 这种制定版本的模式  
– state：状态（present，absent，latest），表示是安装还卸载  
present:默认的，表示为安装  
lastest: 安装为最新的版本  
absent：表示删除

### **Ansible命令** ###

其中options参数主要有：  
参数     说明  
\-a     ‘Arguments’, —args=’Arguments’ 命令行参数  
\-m     NAME, —module-name=NAME 执行模块的名字，默认使用 command 模块，所以如果是只执行单一命令可以不用 -m参数  
\-i  PATH,     —inventory=PATH 指定库存主机文件的路径,默认为/etc/ansible/hosts.  
\-u Username，     —user=Username 执行用户，使用这个远程用户名而不是当前用户  
\-U     —sud-user=SUDO\_User sudo到哪个用户，默认为 root  
\-k     —ask-pass 登录密码，提示输入SSH密码而不是假设基于密钥的验证  
\-K     —ask-sudo-pass 提示密码使用sudo  
\-s     —sudo sudo运行  
\-S     —su 用 su 命令  
\-l     —list 显示所支持的所有模块  
\-s     —snippet 指定模块显示剧本片段  
\-f     —forks=NUM 并行任务数。NUM被指定为一个整数,默认是5。 \#ansible testhosts -a “/sbin/reboot” -f 10 重启testhosts组的所有机   器，每次重启10台  
—private-key=PRIVATE\_KEY\_FILE     私钥路径，使用这个文件来验证连接  
\-v     —verbose 详细信息  
all     针对hosts 定义的所有主机执行  
\-M MODULE\_PATH,     —module-path=MODULE\_PATH 要执行的模块的路径，默认为/usr/share/ansible/  
—list-hosts     只打印有哪些主机会执行这个 playbook 文件，不是实际执行该 playbook 文件  
\-o —one-line     压缩输出，摘要输出.尝试一切都在一行上输出。  
\-t Directory,     —tree=Directory 将内容保存在该输出目录,结果保存在一个文件中在每台主机上。  
\-B     后台运行超时时间  
\-P     调查后台程序时间  
\-T Seconds,     —timeout=Seconds 时间，单位秒s  
\-P NUM,     —poll=NUM 调查背景工作每隔数秒。需要- b  
\-c Connection,     —connection=Connection 连接类型使用。可能的选项是paramiko(SSH),SSH和地方。当地主要是用于crontab或启动。  
—tags=TAGS     只执行指定标签的任务 例子:ansible-playbook test.yml –tags=copy 只执行标签为copy的那个任务  
—list-tasks     列出所有将被执行的任务  
\-C,     —check 只是测试一下会改变什么内容，不会真正去执行;相反,试图预测一些可能发生的变化  
—syntax-check     执行语法检查的剧本,但不执行它  
\-l SUBSET,     —limit=SUBSET 进一步限制所选主机/组模式 –limit=192.168.0.15 只对这个ip执行  
—skip-tags=SKIP\_TAGS     只运行戏剧和任务不匹配这些值的标签 —skip-tags=copy\_start  
\-e EXTRA\_VARS,     —extra-vars=EXTRA\_VARS 额外的变量设置为键=值或YAML / JSON  
\-l     —limit 对指定的 主机/组 执行任务 —limit=192.168.0.10，192.168.0.11 或 -l 192.168.0.10，192.168.0.11 只对这个2个ip执行任务

[http_docs.ansible.com_ansible_latest_list_of_all_modules.html]: https://blog.csdn.net/pushiqiang/article/details/78249665
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70]: /images/20211018/b0bd96af7a9a4875978b3bd9ee634f45.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 1]: /images/20211018/55bd28d72e1f4cbbb9c98a134f267181.png
[20190812231113356.png]: /images/20211018/3908109ba2344566ad8e288338e06ea1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 2]: /images/20211018/573f924ab24a4d8da363e6aa49a99088.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 3]: /images/20211018/dba44611d7b3462fb37e1aac5d849d62.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 4]: /images/20211018/0de7787980f444129e188814b7d7f2ef.png
[20190812231502921.png]: /images/20211018/d306b138641a42018f783f7faaac1c58.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 5]: /images/20211018/5bd5d5bab8544765911bc4c3a1e3d245.png
[20190812231555160.png]: /images/20211018/71e7aa72030e4bae90dee3310479dae1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 6]: /images/20211018/fb5823396c334f16ad92997fefdf2720.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 7]: /images/20211018/61f59c0d03ef41af922525783b540e79.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 8]: /images/20211018/c09bcca9e0a3470dab17bd8db0248ac6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3ZhbnZhbl8_size_16_color_FFFFFF_t_70 9]: /images/20211018/dd328b0e9cc34f518944aed2717dcd70.png