Ansible--常用模块使用(2)

Ansible常用模块

cron 模块

用途:cron模块⽤于设置定时任务，也⽤于管理定时任务中的环境变量
使用方法:

[root@ansible ~]# ansible-doc -s cron
- name: Manage cron.d and crontab entries
  cron:
      backup:                # (yes/on)如果设置了，则会在修改远程cron_file前备份这些文件
      cron_file:             # 自定义cron_file的文件名，使用相对路径则表示在/etc/cron.d/中，必选同时制定user选项
      minute:                # 分(0-59,*,/N),不写时默认为*
      hour:                  # 时(0-23,*,/N),不写时默认为*
      day:                   # 日(1-31,*,/N),不写时默认为*
      month:                 # 月(1-12,*,/N),不写时默认为*
      weekday:               # 周(0-6 for Sunday-Saturday,*),不写时默认为*
      disabled:              # 禁用crontab中的某个任务，要求state=present
      env:                   # (yes/on)设置一个环境变量，将添加在crontab的顶端，使用name=value定义变量名和值.
      job:                   # 需要执行的命令，如果设置了env，则表示环境变量的值，此时job="xxxx"等价于value="xxxx"
      name:                  # 描述crontab的字符串，但如果设置的是env,则name为环境变量的名称，要求state=absent，注意，若没有设置name，且state=present，则总会创建一条新的job条目，即使cron_file中已经存在同样的条目.
      reboot:                # 如果任务应该在重新启动时运行。不赞成使用此选项。用户应该使用special_time.
      special_time:          # 定时任务的别称，用于定义何时运行job条目.有效值有reboot/hourly/daily/weekly/monthly/yearly/annually
      state:                 # job或者env的状态是present(默认)还是absent，present用于创建，absent用于删除
      user:                  # 指定那个用户的crontab任务将要被修改，默认root.

示例:

1)每分钟执行一次同步阿里云的时间
[root@ansible ~]# ansible all -m cron -a "name='ntpdate aly' minute=*/1 job='/usr/sbin/ntpdate ntp1.aliyun.com'"
192.168.192.129 | CHANGED => {
    "changed": true,
    "envs": [],
    "jobs": [
        "ntpdate aly"
    ]
}
查看结果(已经创建一条同步时间的计划任务)
[root@ansible ~]# ansible all -m shell -a "crontab -l"
192.168.192.129 | CHANGED | rc=0 >>
#Ansible: ntpdate aly
*/1 * * * * /usr/sbin/ntpdate ntp1.aliyun.com

2)backup参数(备份cron文件)
[root@ansible ~]# ansible all -m cron -a "name='ntpdate aly' minute=0 hour=0 day=* month=* weekday=* backup=yes job='/usr/sbin/ntpdate ntp1.aliyun.com'"
192.168.192.129 | CHANGED => {
    "backup_file": "/tmp/crontabJOrXXY",
    "changed": true,
    "envs": [],
    "jobs": [
        "ntpdate aly"
    ]
}
上面返回的结果中包含一个backup_file，备份的文件在被控制端的/tmp下面
查看结果(可以看到计划任务改变,和被控制端的备份文件)
[root@ansible ~]# ansible all -m shell -a "crontab -l && ls -l /tmp | grep crontab"
192.168.192.129 | CHANGED | rc=0 >>
#Ansible: ntpdate aly
0 0 * * * /usr/sbin/ntpdate ntp1.aliyun.com
-rw------- 1 root root 68 Dec 27 10:47 crontabJOrXXY

3)env参数(设置环境变量)
[root@ansible ~]# ansible all -m cron -a "env=yes name='TEST' backup=yes job='echo test'"
192.168.192.129 | CHANGED => {
    "backup_file": "/tmp/crontabFgNUhH",
    "changed": true,
    "envs": [
        "TEST"
    ],
    "jobs": [
        "ntpdate aly"
    ]
}
查看结果(发现在开头多了个TEST="echo test"，也就是说明env=yes的时候name='TEST'就是变量名job='echo test'就是变量的值)
[root@ansible ~]# ansible all -m shell -a "crontab -l"
192.168.192.129 | CHANGED | rc=0 >>
TEST="echo test"
#Ansible: ntpdate aly
0 0 * * * /usr/sbin/ntpdate ntp1.aliyun.com

4)special_time参数
重启时执行任务
[root@ansible ~]# ansible all -m cron -a "name='special time reboot' special_time=reboot job='echo test'"
192.168.192.129 | CHANGED => {
    "changed": true,
    "envs": [
        "TEST"
    ],
    "jobs": [
        "ntpdate aly",
        "special time reboot"
    ]
}
查看结果
[root@ansible ~]# ansible all -m shell -a "crontab -l"
192.168.192.129 | CHANGED | rc=0 >>
TEST="echo test"
#Ansible: ntpdate aly
0 0 * * * /usr/sbin/ntpdate ntp.aliyun.com
#Ansible: special time reboot
@reboot echo test

每小时执行一次计划任务
[root@ansible ~]# ansible all -m cron -a "name='special time reboot' special_time=hourly job='echo test'"
192.168.192.129 | CHANGED => {
    "changed": true,
    "envs": [
        "TEST"
    ],
    "jobs": [
        "ntpdate aly",
        "special time reboot"
    ]
}
查看结果
[root@ansible ~]# ansible all -m shell -a "crontab -l"
192.168.192.129 | CHANGED | rc=0 >>
TEST="echo test"
#Ansible: ntpdate aly
0 0 * * * /usr/sbin/ntpdate ntp.aliyun.com
#Ansible: special time reboot
@hourly echo test

上面发现@reboot echo test换成了@hourly echo test原因是因为两次执行的name的名字是一样的所有直接就覆盖了

5)state=absent(删除计划任务)
[root@ansible ~]# ansible all -m cron -a "name='special time reboot' backup=yes state=absent"
192.168.192.129 | CHANGED => {
    "backup_file": "/tmp/crontab02rAD6",
    "changed": true,
    "envs": [
        "TEST"
    ],
    "jobs": [
        "ntpdate aly"
    ]
}
查看结果(发现special time reboot任务已经删除了)
[root@ansible ~]# ansible all -m shell -a "crontab -l"
192.168.192.129 | CHANGED | rc=0 >>
TEST="echo test"
#Ansible: ntpdate aly
0 0 * * * /usr/sbin/ntpdate ntp.aliyun.com

service 模块

用途:service 模块可以帮助我们管理远程主机上的服务。比如，启动或停止远程主机中的 nginx 服务
使用方法:

[root@ansible ~]# ansible-doc -s service
- name: Manage services
  service:
      arguments:             # 服务命令行参数传递
      enabled:               # 设置服务为开机自启(yes/no)，默认为no
      name:                  # (必选项)指定服务名.
      pattern:               # 如果服务没有做出相应，可以通过这个参数指定使用ps或者其他方式查看服务的状态.
      runlevel:              # 设置服务启动级别
      sleep:                 # 如果服务正在"重新启动"，那么在停止和开始命令之间设置休眠时间.
      state:                 # started和stoped分别是启动和停止服务，它们是幂等操作，多次启动或者停止服务都是一样的，也就是说对于运行中的服务不会再次启动操作，同理停止也是一样的；
                             # restarted重启服务，restarted总是重读配置文件如果服务是未运⾏状态，则reloaded会启动服务(state和enabled两者⾄少要给⼀个)

示例:

以nginx服务为例做示例(这里面返回的打印的数据太多了就不放到博客了)
1)state=started(启动服务)
[root@ansible ~]# ansible all -m service -a "name=nginx state=started"

2)state=stopped(停止服务)
[root@ansible ~]# ansible all -m service -a "name=nginx state=stopped"

3)state=restarted(重启服务)
[root@ansible ~]# ansible all -m service -a "name=nginx state=restarted"

4)state=reloaded(重载服务)
[root@ansible ~]# ansible all -m service -a "name=nginx state=reloaded"

5)enabled(设置开机自启)
[root@ansible ~]# ansible all -m service -a "name=nginx enabled=yes"

systemd 模块

用途:systemd 模块可以帮助我们使用systemd管理远程主机上的服务。比如，启动或停止远程主机中的 nginx 服务
使用方法:

[root@ansible ~]# ansible-doc -s systemd
- name: Manage services
  systemd:
      daemon_reload:         # 在执行任何其他操作之前运行守护进程重新加载，以确保systemd已经读取其他更改.
      enabled:               # 设置服务为开机自启(yes/no)，默认为no
      force:                 # 是否覆盖现有符号链接(yes/on).
      masked:                # 是否将服务设置为masked状态(yes/no)，被mask的服务是无法启动的
      name:                  # 指定服务名称.
      no_block:              # 不要同步等待操作请求完成(yes/no)
      state:                 # started和stoped分别是启动和停止服务，它们是幂等操作，多次启动或者停止服务都是一样的，也就是说对于运行中的服务不会再次启动操作，同理停止也是一样的；

示例:

以nginx服务为例做示例(这里面返回的打印的数据太多了就不放到博客了)
1)state=started(启动服务)
[root@ansible ~]# ansible all -m systemd -a "name=nginx state=started"

2)state=stopped(停止服务)
[root@ansible ~]# ansible all -m systemd -a "name=nginx state=stopped"

3)state=restarted(重启服务)
[root@ansible ~]# ansible all -m systemd -a "name=nginx state=restarted"

4)state=reloaded(重载服务)
[root@ansible ~]# ansible all -m systemd -a "name=nginx state=reloaded"

5)enabled(设置开机自启)
[root@ansible ~]# ansible all -m systemd -a "name=nginx enabled=yes"

user 模块

用途:user 模块可以帮助我们管理远程主机上的用户，比如创建用户、修改用户、删除用户、为用户创建密钥对等操作
使用方法:

[root@ansible ~]# ansible-doc -s user
- name: Manage user accounts
  user:
      append:                # 如果用户原本就存在多个附加组，那么当使用 groups 参数设置附加组时，当前设置会覆盖原来的附加组设置
                             # 如果不想覆盖原来的附加组设置，需要结合 append 参数，将 append 设置为 yes，表示追加附加组到现有的附加组设置，append 默认值为 no.
      comment:               # 设置用户的描述信息
      create_home:           # 创建家⽬录，或者已有的⽤户但家⽬录不存在也会创建。设置为no则不创建家⽬录
      expires:               # 此参数用于指定用户的过期时间，相当于设置 /etc/shadow 文件中的的第8列
                             # 比如，你想要设置用户的过期日期为2018年12月31日，那么你首先要获取到2018年12月31日的 unix 时间戳，使用命令 “date -d 2018-12-31 +%s” 获取到的时间戳为1546185600，
                             # 所以，当设置 expires=1546185600 时，表示用户的过期时间为2018年12月31日0点0分，
                             # 设置成功后，查看远程主机的 /etc/shadow 文件，对应用户的第8八列的值将变成17895（表示1970年1月1日到2018年12月31日的天数，unix 时间戳的值会自动转换为天数，我们不用手动的进行换算，
                             # 目前此参数只支持在 Linux 和 FreeBSD 系统中使用。
      force:                 # 强制删除用户、用户目录,只在state=absent中生效，相当于userdel --force命令
      generate_ssh_key:      # 是否为相关用户生成SSH密钥。这将“不会”覆盖现有SSH密钥.
      group:                 # 设置⽤户的primary group(主组).
      groups:                # 将⽤户加⼊到辅助组列表中。如果设置"groups="，则会将此⽤户从所有辅助组中移除
      home:                  # 指定要创建的家⽬录路径
      move_home:             # 如果设置为yes，则"home="则表⽰将家⽬录移动到此选项指定的路径下
      name:                  # (必选项)要创建、修改、移除的⽤户名.
      non_unique:            # 当与 -u 选项一起使用时，该选项允许将用户ID更改为非唯一值
      password:              # 设置⽤户密码。此处只能使⽤加密密码作为值.
      password_lock:         # 锁定用户的密码(等价于usermod -L命令)这个选项并不总是意味着用户不能通过其他方法登录。这个选项没有禁用用户，只锁定密码.
      remove:                # 配合'state=absent'时，等价于'userdel --remove'，即删除家⽬录和邮件列表
      seuser:                # 在启用selinux的系统上设置seuser类型.
      shell:                 # 设置⽤户的shell
      ssh_key_bits:          # 当 generate_ssh_key 参数的值为 yes 时，使用此参数指定要创建的SSH密钥中的位数.
      ssh_key_comment:       # 当 generate_ssh_key 参数的值为 yes 时，在创建证书时，使用此参数设置公钥中的注释信息。但是如果同名的密钥对已经存在，则并不会修改原来的注释信息，即不做任何操作。
                             # 当不指定此参数时，默认的注释信息为”ansible-generated on 远程主机的主机名.
      ssh_key_file:          # 当 generate_ssh_key 参数的值为 yes 时，使用此参数自定义生成 ssh 私钥的路径和名称，对应公钥会在同路径下生成，公钥名以私钥名开头，以”.pub”结尾.
      ssh_key_passphrase:    # 当 generate_ssh_key 参数的值为 yes 时，在创建证书时，使用此参数设置私钥的密码。但是如果同名的密钥对已经存在，则并不会修改原来的密码，即不做任何操作.
      ssh_key_type:          # 当 generate_ssh_key参数的值为yes时，在创建证书时，使用此参数设置密钥对的类型。默认密钥类型为 rsa，但是如果同名的密钥对已经存在，并不会对同名密钥做任何操作.
      state:                 # 创建⽤户(present)还是删除⽤户(absent)。默认为present.
      system:                # 设置为yes表⽰创建⼀个系统⽤户，只能⽤于创建，不能⽤于修改已有⽤户为系统⽤户
      uid:                   # 设置用户的UID
      update_password:       # user是幂等模块，"always"将总是修改密码。"on_create"将只在创建⽤户时设置密码

示例:

1)name参数(创建用户)
创建名为brian的用户，如果用户已经存在，则不进行任何操作
[root@ansible ~]# ansible all -m user -a "name=brian"
192.168.192.129 | CHANGED => {
    "changed": true,
    "comment": "",
    "create_home": true,
    "group": 1000,
    "home": "/home/brian",
    "name": "brian",
    "shell": "/bin/bash",
    "state": "present",
    "system": false,
    "uid": 1000
}

2)state=absent参数(删除用户但不删除目录)
删除名为brian的用户，但是不会删除 brian 用户的家目录
[root@ansible ~]# ansible all -m user -a "name=brian state=absent"
192.168.192.129 | CHANGED => {
    "changed": true,
    "force": false,
    "name": "brian",
    "remove": false,
    "state": "absent"
}

3)state=absent remove=yes参数(删除用户并删除用户目录)
删除名为brian的用户，同时会删除brian用户的家目录等信息。如果已经不存在brian的用户，则不做任何操作
[root@ansible ~]# ansible all -m user -a "name=brian state=absent remove=yes"
192.168.192.129 | SUCCESS => {
    "changed": false,
    "name": "brian",
    "state": "absent"
}

4)group参数(为用户指定组)
指定brian用户的主组为yunwei，yunwei组需要提前存在，当不使用group设置主组时，默认主组与用户名相同
创建yunwei组
[root@ansible ~]# ansible all -m shell -a "groupadd yunwei"

[root@ansible ~]# ansible all -m user -a "name=brian group=yunwei"
192.168.192.129 | CHANGED => {
    "changed": true,
    "comment": "",
    "create_home": true,
    "group": 1000,
    "home": "/home/brian",
    "name": "brian",
    "shell": "/bin/bash",
    "state": "present",
    "system": false,
    "uid": 1000
}

5)groups参数(为用户添加附加组)、append参数(设置yes可添加多个附加组)
指定brian用户的附加组为python，python组需要提前存在，当不使用groups设置附属组时，默认附加组与用户名相同。
注意，为了保险起见，在不知道用户原来的附加组设定的情况下，最好将append参数设置为yes我们也可以一次性设置多个附加组，附加组之间用逗号隔开
创建python组
[root@ansible ~]# ansible all -m shell -a "groupadd python"

[root@ansible ~]# ansible all -m user -a "name=brian groups=python append=yes"
192.168.192.129 | CHANGED => {
    "append": true,
    "changed": true,
    "comment": "",
    "group": 1001,
    "home": "/home/brian",
    "move_home": false,
    "name": "brian",
    "shell": "/bin/bash",
    "state": "present",
    "uid": 1000
}

6)expires参数(设置用户的过期时间)
指定brian用户的过期时间为2018年12月31日。使用"date -d 2018-12-31 +%s"命令可以获取到对应日期的unix时间戳
获取unix时间戳
[root@ansible ~]# date -d 2018-12-31 +%s
1546185600

[root@ansible ~]# ansible all -m user -a "name=brian expires=1546185600"
192.168.192.129 | CHANGED => {
    "append": false,
    "changed": true,
    "comment": "",
    "group": 1001,
    "home": "/home/brian",
    "move_home": false,
    "name": "brian",
    "shell": "/bin/bash",
    "state": "present",
    "uid": 1000
}

7)comment参数(指定用户的注释信息)
指定brian用户的注释信息
[root@ansible ~]# ansible all -m user -a "name=brian comment='my name is zhujingzhi'"
192.168.192.129 | CHANGED => {
    "append": false,
    "changed": true,
    "comment": "my name is zhujingzhi",
    "group": 1001,
    "home": "/home/brian",
    "move_home": false,
    "name": "brian",
    "shell": "/bin/bash",
    "state": "present",
    "uid": 1000
}

8)password参数(为用户设置密码)
将brian用户的密码设置为hahahaha
给hahahaha加密
[root@ansible ~]# python
Python 2.7.5 (default, Jul 13 2018, 13:06:57)
[GCC 4.8.5 20150623 (Red Hat 4.8.5-28)] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import crypt
>>> crypt.crypt('hahahaha')
'$6$Zfj8DrWsbhwHSpCq$vuWpw.5FX97egYaWEUTavkP3ahi294yO5brO9qm3XDdvjM0hJKwaoXt7ue/9ZRIm8sYzgxsGZdKi8Qxdk3xDD.'

[root@ansible ~]# ansible all -m user -a 'name=brian password="$6$Zfj8DrWsbhwHSpCq$vuWpw.5FX97egYaWEUTavkP3ahi294yO5brO9qm3XDdvjM0hJKwaoXt7ue/9ZRIm8sYzgxsGZdKi8Qxdk3xDD."'
192.168.192.129 | CHANGED => {
    "append": false,
    "changed": true,
    "comment": "my name is zhujingzhi",
    "group": 1001,
    "home": "/home/brian",
    "move_home": false,
    "name": "brian",
    "password": "NOT_LOGGING_PASSWORD",
    "shell": "/bin/bash",
    "state": "present",
    "uid": 1000
}

9)generate_ssh_key参数(生成ssh密钥对)
为brian用户生成ssh密钥对。默认在用户家目录的./ssh 目录中生成名为 id_rsa 的私钥和名为 id_rsa.pub 的公钥，如果已经存在同名密钥，并不会覆盖原来的密钥，即不做任何操作
[root@ansible ~]# ansible all -m user -a "name=brian generate_ssh_key=yes"
192.168.192.129 | CHANGED => {
    "append": false,
    "changed": true,
    "comment": "my name is zhujingzhi",
    "group": 1001,
    "home": "/home/brian",
    "move_home": false,
    "name": "brian",
    "shell": "/bin/bash",
    "ssh_fingerprint": "2048 SHA256:67RLzlQYCjfOctm7K4cXrd+ctuTl6WEGW0oboP9/4Qc ansible-generated on ansible_node1 (RSA)",
    "ssh_key_file": "/home/brian/.ssh/id_rsa",
    "ssh_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC5OKH1DicFwXMVhJioQyYAt3I/C+axJ8qG4lynUMxXQNRa1NCGXPcnBXDUATAwfzG7O5itRrFOGZracMb63B9WrhkPzWPiJHjv9fRAibuydmro0al6GkUqU/Ma2UME1c+OWKR5HrhGHU/8KfD/EHcsaSmeI0G5qWsstNzzjsxpCTDL/cGWK841s1UE6n4dHs+fxp0r7NDqzB4HceTIKZKdB0ScetchMCHJzBpV+nu3uqacgZrTRp1T5EHIXjoS9D+NeH5/9YVevTrlMqBks8RdGjXeds8G3LyqQMdjR2X5WPW0+cS8oECtEPY1xERPdgbN7c643Xh2oXDoEBMZ/GfT ansible-generated on ansible_node1",
    "state": "present",
    "uid": 1000
}

10)ssh_key_file参数(指定密钥生成的路径)
为brian用户生成ssh密钥对，密钥对生成在/opt目录下，私钥名为 id_rsa_brian，公钥名为 id_rsa_brian.pub
[root@ansible ~]# ansible all -m user -a "name=brian generate_ssh_key=yes ssh_key_file=/opt/id_rsa_brian"
192.168.192.129 | CHANGED => {
    "append": false,
    "changed": true,
    "comment": "my name is zhujingzhi",
    "group": 1001,
    "home": "/home/brian",
    "move_home": false,
    "name": "brian",
    "shell": "/bin/bash",
    "ssh_fingerprint": "2048 SHA256:/A0hgTZ4GA7qMKhikPe+QMJiAlKHmzk560IaMC5uRHI ansible-generated on ansible_node1 (RSA)",
    "ssh_key_file": "/opt/id_rsa_brian",
    "ssh_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCSlNUc0TCduB6CqHr65zyC4MN/UI36DsdQB9JgBNT2MymoV9oCgcrg6m5TcuOcyv57BqZg1/l78LMHg9bCL0cn+EC3Pv7lNVgTGIRlRLFsXCnvVIbQ7nwygH1mqRR2VxNY5RsrxLSnvCADdTuc+AQ7Y7/5CMI3BLHAUju8VbfVSUfluUoR4V+ifT0zHPPbN9GWSTVBWgwPqsB6huw5odFJoY20AxTKzT5TZDLSFk1SVWV/T3knndBReHwM+OSYu7UTCCf5cI+3OImDDBscEr4GLEGfxSOXepUqI0EoYZrqhWUeuFWvSzvcJwX3Z+rz9UA1kv68wWtw/mPtaszX94Pp ansible-generated on ansible_node1",
    "state": "present",
    "uid": 1000
}

11)ssh_key_comment参数(指定公钥中的注释信息)
为brian用户生成ssh密钥对，同时指定公钥中的注释信息为"www.brian.com"，此参数只能在创建密钥时使用才会生效，并不能操作同名的老密钥
[root@ansible ~]# ansible all -m user -a "name=brian generate_ssh_key=yes ssh_key_comment='brian ssh-rsa'"
192.168.192.129 | CHANGED => {
    "append": false,
    "changed": true,
    "comment": "my name is zhujingzhi",
    "group": 1001,
    "home": "/home/brian",
    "move_home": false,
    "name": "brian",
    "shell": "/bin/bash",
    "ssh_fingerprint": "2048 SHA256:jDU5RLudX3WcDKDM6C/4yUO2K0sGgVI/g/EkIPcUfB4 brian ssh-rsa (RSA)",
    "ssh_key_file": "/home/brian/.ssh/id_rsa",
    "ssh_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQD1/JVoM14IRpTWxAbiOrvnvgxfTQQyErC3w4lfbATdldeaz2cZt1Ancq5xycyFMf++1UFNevPAKmlfTH37aFclVR2cH3jL/LZZefpjDvIeXb3GPYW6lDautrB/AuMgYwkhgfT8fj6/Zx+/Uq/PWCSXmkGUqT8bkM3hjF1kKc0HtUMljK3dLgJgluSifFSHSl8NO7575HxzY+KVXTzGFJmXwwRssHkoJq38kRqua2DMzBWjBd9LcYRSa2wHwfXK12fJVEMx6xIUqPljLFslDfL++NiDeMtf9dP9Dp7+/3/o2XW3CWanjTcDLLT8cbzKC4j2MvmTTIXmXG6SiQ98deNp brian ssh-rsa",
    "state": "present",
    "uid": 1000
}

12)ssh_key_passphrase参数(指定私钥的密码)
为brian用户生成ssh密钥对，同时指定私钥的密码为123456，此参数只能在创建密钥时使用才会生效，并不能操作同名的老密钥
[root@ansible ~]# ansible all -m user -a "name=brian generate_ssh_key=yes ssh_key_passphrase='123456'"
192.168.192.129 | CHANGED => {
    "append": false,
    "changed": true,
    "comment": "my name is zhujingzhi",
    "group": 1001,
    "home": "/home/brian",
    "move_home": false,
    "name": "brian",
    "shell": "/bin/bash",
    "ssh_fingerprint": "2048 SHA256:kv2+zW6bqC8YAPazS7YvVtK4gz5uFCglfqmm9AoAfi0 ansible-generated on ansible_node1 (RSA)",
    "ssh_key_file": "/home/brian/.ssh/id_rsa",
    "ssh_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC6RAfCIyGz9kLF2KGBSOk6cQZb7O+tkOxwqJmxGE7bqKwgAprX917C7mj6ugIADeFeRtnP3/0oU0TLl4m0mFepVDEzGfZTRIR7Op1M6QCvveOJM/eP92vUv9TIKPY83iAaog7+l6/ZItBVWqC3OKmKHpuiZeH06dayq805lrYA+3jUagCKZSmevejyFTuVMYQJEZ77afWnJqtnCgUE6Mc/H5eD8ffPZgey3FEs+OTPA96N85gfZ6j+wT5AqPNPhmE7+I/Z6tZUnnPMGbHUhp53/TSMcIV5MZIPEcCpJq0KIFYR6xp2uW6aFhkQ58DhDwkHvFE34IVpnJMCoA8fesvn ansible-generated on ansible_node1",
    "state": "present",
    "uid": 1000
}

13)ssh_key_type参数(指定加密类型)
为brian用户生成ssh密钥对，同时指定密钥对的类型为dsa，当不显式指定密钥类型时，默认类型为rsa，此参数只能在创建密钥时使用才会生效，并不能操作同名的老密钥
[root@ansible ~]# ansible all -m user -a "name=brian generate_ssh_key=yes ssh_key_type=dsa"
192.168.192.129 | CHANGED => {
    "append": false,
    "changed": true,
    "comment": "my name is zhujingzhi",
    "group": 1001,
    "home": "/home/brian",
    "move_home": false,
    "name": "brian",
    "shell": "/bin/bash",
    "ssh_fingerprint": "1024 SHA256:R5H7/BUdOIku2uWdp6UVSmibTqbq3mXCQKkPWhHWsAQ ansible-generated on ansible_node1 (DSA)",
    "ssh_key_file": "/home/brian/.ssh/id_dsa",
    "ssh_public_key": "ssh-dss AAAAB3NzaC1kc3MAAACBAM9iCp0cVUWqutnrlLWgFMms4cGaxR8bPgCa/Sec+OPbA3LjO/UwoYhyxCDu7eCCjUNcNwhEzssl3jtQRaCEzGV4rjO4mJaPkfCLpnDnYbKuWd9zio6vz4TU/qGJoG6Z5gpRqyv0TPKRw+FB10eL283/9/RJ49ZGWnf/v+hnF/DJAAAAFQDhz74tTItuAowX8VtzLTFKJXjhjwAAAIA8X7MxjCBvK38qICDCvjfsSU+WA5uWP1doyf7CQ/PEF3j0aPXe+rd4u1WRpNqkYxTQiZVr+uVQ4NqPAdvszkWpQ86tIW36rTXecLX6dbr59Gd/0uEpvIFagbPK0RPB+F8Z/LudQvcz+qqwAO+JMUR3FGBOT7nL9ZlPeocXhetpkQAAAIBUbmWo/IDFp3mVx7cYkqJH94RG1YJ/HE77SUFF/doAZmpvRVK4IttBojGDeEnPNsN49cHXVY/pGKquGoLMMKI3qJBuYDsd2YUSxRGRIdbDyRWMAPQkC6W+/tSFFSrrHndpUtzPtI4rNZX5w/wbcxxEMsPDsxYcQB1VRhIf2+YiWQ== ansible-generated on ansible_node1",
    "state": "present",
    "uid": 1000
}

authorized_key 模块

用途:添加或删除SSH授权密钥
使用方法:

[root@ansible ~]# ansible-doc -s authorized_key
- name: Adds or removes an SSH authorized key
  authorized_key:
      comment:               # 更改公钥上的注释。重写注释在从GitHub或GitLab中提取注释等情况下非常有用。如果没有指定注释，则保留现有注释
      exclusive:             # 是否移除authorized_keys文件中其它非指定key.
      follow:                # 是否遵循目的机器中的文件系统链接(可选值为:yes|on)
      key:                   # (必选项)公钥路径，可以是本地⽂件，可以是url地址
      key_options:           # 附加到key中的字符串 不加参数会删除上次带参数时添加的字符串
      manage_dir:            # 是否创建或修改⽬标authorized_keys所在⽬录的所有者和权限。默认为yes 使用自定义的目标路径时，必选设置为no或者false.
      path:                  # authorized_keys所在的⽬录，默认为家⽬录下的.ssh⽬录中
      state:                 # present/absent，是否将密钥添加到⽬标authorized_keys⽂件中,state=present表示添加;state=absent表示删除
      user:                  # (必选项)添加到远程哪个⽤户下的authorized_keys⽂件
      validate_certs:        # 这只适用于使用https url作为密钥源的情况。如果设置为“no”，则不会验证SSL证书.

示例:

正在更新中。。。。。请等待

debug 模块

用途:⽤于输出⾃定义的信息，类似于echo、print等输出命令。ansible中的debug主要⽤于输出变量值、表达式值，以及⽤于when条件判断时。使⽤⽅式⾮常简单
使用方法:

[root@ansible ~]# ansible-doc -s debug
- name: Print statements during execution
  debug:
      msg:                   # 输出⾃定义信息。如果省略，则输出普通字符.
      var:                   # 指定待调试的变量。只能指定变量，不能指定⾃定义信息，且变量不能加{{}}包围，⽽是直接的变量名.
      verbosity:             # 控制debug运⾏的调试级别，有效值为⼀个数值N

示例:

1) msg参数(输出⾃定义信息)
[root@ansible ~]# ansible all -m debug -a "msg='i want to print this messages'"
192.168.192.129 | SUCCESS => {
    "msg": "i want to print this messages"
}

2) var参数(指定待调试的变量)
[root@ansible ~]# ansible all -m debug -a "var=ansible_eth0.ipv4.address"
192.168.192.129 | SUCCESS => {
    "ansible_eth0.ipv4.address": "VARIABLE IS NOT DEFINED!"
}

3) verbosity(控制debug运⾏的调试级别)
[root@ansible ~]# ansible all -m debug -a "verbosity=3"
192.168.192.129 | SKIPPED

archive 模块

用途:创建一个或多个文件或树的压缩存档
使用方法:

[root@ansible ~]# ansible-doc -s archive
- name: Creates a compressed archive of one or more files or trees
  archive:
      dest:                  # ⽬标归档⽂件名。除⾮path指定要压缩的是单⽂件，否则需要dest选项.
      exclude_path:          # 要从归档文件中排除的文件的远程绝对路径
      format:                # 指定压缩格式，默认为gz格式.
      group:                 # ⽂件/⽬录的所属组.
      mode:                  # 设置⽂件/⽬录的的权限，⽀持'0644'或'u+rwx'或'u=rw,g=r,o=r'等格式
      owner:                 # ⽂件/⽬录的所属者
      path:                  # (必选项) 要压缩的⽂件，可以是绝对路径，也可以是glob统配的路径，还可以是⽂件列表
      remove:                # 压缩后删除源⽂件
      unsafe_writes:         # 是否以不安全的方式进行，可能导致数据损坏(unsafe_writes=yes|on).

示例:

正在更新中。。。。。请等待

unarchive 模块

用途:复制归档压缩文件后解压
使用方法:

[root@ansible ~]# ansible-doc -s unarchive
- name: Unpacks an archive after (optionally) copying it from the local machine.
  unarchive:
      creates:               # 如果指定的⽂件存在则不执⾏该任务。可⽤于实现幂等性
      decrypt:               # 此选项使用vault控制源文件的自动解密
      dest:                  # (必选项) 远程机器上需要被解包的归档⽂件，要求是绝对路径
      exclude:               # 列出解包过程中想要忽略的⽬录和⽂件
      extra_opts:            # 通过传入数组指定其他选项
      group:                 # ⽂件/⽬录的所属组.
      keep_newer:            # 在解包过程中，如果⽬标路径中和包中有同名⽂件，且⽐包中的⽂件更新，则保留新的⽂件
      list_files:            # 设置为true时，将返回归档⽂件中的⽂件列表
      mode:                  # 设置⽂件/⽬录的的权限，⽀持'0644'或'u+rwx'或'u=rw,g=r,o=r'等格式
      owner:                 # ⽂件/⽬录的所属者
      remote_src:            # 设置为yes表⽰远程主机上已有⽬标归档⽂件，即不再从本地复制归档⽂件到远端，直接在远端解包,默认no.
      src:                   # (必选项)如果remote_src=no,将复制本地归档⽂件到远端，可相对路径也可绝对路径.如果remote_src=yes, 将解包远程已存在的归档⽂件,如果remote_src=yes且src中包含了"://",将指挥远程主机从url中下载⽂件并解包
      unsafe_writes:         # 是否以不安全的方式进行，可能导致数据损坏(unsafe_writes=yes|on)
      validate_certs:        # 这只适用于使用https url作为密钥源的情况。如果设置为“no”，则不会验证SSL证书

示例:

正在更新中。。。。。请等待

get_url 模块

用途:类似于wget和curl的功能，可以进行下载以及webapi交互等操作
使用方法:

[root@ansible ~]# ansible-doc -s get_url
- name: Downloads files from HTTP, HTTPS, or FTP to node
  get_url:
      backup:                # 下载⽂件时同时创建⼀个名称中包含时间戳的备份⽂件
      dest:                  # (必选项)⽂件保存路径，必须为绝对路径。
                             # 如果dest是⼀个⽬录，则使⽤url的base name作为⽂件名
                             # 如果dest是⼀个⽬录，则'force'选项不⽣效
                             # 如果dest是⼀个⽬录，则总是会下载⽬标⽂件，但只在已存在的⽂件变化了才会替换旧⽂件
      force:                 # 如果设置为yes，且dest不是⼀个⽬录时，则总是会下载⽂件，但只在已存在的⽂件变化了才会替换旧⽂件，如果设置为no(默认)，则只会在⽬录路径下不存在该⽂件时才会进⾏下载
      force_basic_auth:      # 此选项在初始请求时强制基本身份验证标头.
      group:                 # ⽂件/⽬录的所属组.
      headers:               # 以字典格式向请求添加自定义HTTP头(key=value格式)
      mode:                  # 设置⽂件/⽬录的的权限，⽀持'0644'或'u+rwx'或'u=rw,g=r,o=r'等格式.
      others:                # 模块接受的所有参数
      owner:                 # ⽂件/⽬录的所属者
      sha256sum:             # 如果将SHA-256校验和传递给该参数，则在下载后计算目标文件摘要，以确保其完整性并验证传输成功。这个选项不赞成使用。使用“校验和”代替.
      timeout:               # 请求url时的超时时间，默认10秒钟.
      tmp_dest:              # 下载时临时存放⽬录，在任务执⾏完成前会删除下载的临时⽂件
      unsafe_writes:         # 是否以不安全的方式进行，可能导致数据损坏(unsafe_writes=yes|on)
      url:                   # (required) 要下载的url路径，(http|https|ftp)://[user[:pass]]@host.domain[:port]/path
                             # 还⽀持file格式的路径，实现复制功能。file:///path/to/file
      url_password:          # 用于HTTP基本身份验证的密码。如果没有指定“url_username”参数，则不会使用“url_password”参数
      url_username:          # 用于HTTP基本身份验证的用户名。对于允许空密码的站点，可以在不使用“url_password”的情况下使用此参数
      use_proxy:             # 如果no，它将不使用代理，即使在目标主机上的环境变量中定义了代理.
      validate_certs:        # 如果no，SSL证书将不被验证。这应该只在使用自签名证书的个人控制站点上使用

示例:

正在更新中。。。。。请等待

wait_for 模块

用途:⽤于判断任务在满⾜什么条件的情况下会继续。主要⽤来判断端⼝是否开启、⽂件是否存在、⽂件中是否存在某些字符串
使用方法:

[root@ansible ~]# ansible-doc -s wait_for
- name: Waits for a condition before continuing
  wait_for:
      active_connection_states:   # 被算作活动连接的TCP连接状态列表.
      connect_timeout:            # 在关闭和重试之前等待连接发生的最大秒数.
      delay:                      # 在检查操作进⾏之前等待的秒数
      exclude_hosts:              # 在寻找处于“耗尽”状态的活动TCP连接时要忽略的主机或ip的列表
      host:                       # 等待这个主机处于启动状态，默认为127.0.0.1.
      msg:                        # 这将覆盖来自无法满足所需条件的故障的正常错误消息.
      path:                       # 这个⽂件是否已经存在
      port:                       # 等待这个端⼝已经开放.
      search_regex:               # 在⽂件中进⾏正则匹配
      sleep:                      # 两次检查之间sleep的秒数，默认1秒
      state:                      # present/started/stopped/absent/drained.默认started
                                  # 当检查的是⼀个端⼝时：
                                  # started:保证端⼝是开放的
                                  # stopped:保证端⼝是关闭的
                                  # 当检查的是⼀个⽂件时：
                                  # present/started:在检查到⽂件存在才会继续
                                  # absent:检查到⽂件被移除后才会继续
      timeout:                    # 检查的等待超时时间(秒数，默认300).

示例:

正在更新中。。。。。请等待

group 模块

用途:添加或删除组
使用方法:

[root@ansible ~]# ansible-doc -s group
- name: Add or remove groups
  group:
      gid:                   # 用于指定组的gid
      name:                  # (必选项) 用于指定要操作的组名称
      state:                 # 用于指定组的状态，两个值可选，present，absent，默认为 present，设置为absent 表示删除组。
      system:                # 如果是yes，表示指定的组是系统组

示例:

1) name参数(创建组)
创建kaifa组
[root@ansible ~]# ansible all -m group -a "name=kaifa"
192.168.192.129 | CHANGED => {
    "changed": true,
    "gid": 1002,
    "name": "kaifa",
    "state": "present",
    "system": false
}

2) state=absent参数(删除组)
删除成功的前提是不能有用户把被删除的组当成主组
[root@ansible ~]# ansible all -m group -a "name=kaifa state=absent"
192.168.192.129 | CHANGED => {
    "changed": true,
    "name": "kaifa",
    "state": "absent"
}

3) gid参数(指定组的gid)
[root@ansible ~]# ansible all -m group -a "name=kaifa gid=6666"
192.168.192.129 | CHANGED => {
    "changed": true,
    "gid": 6666,
    "name": "kaifa",
    "state": "present",
    "system": false
}

4) system参数(将组设置成为系统组)
[root@ansible ~]# ansible all -m group -a "name=admin system=yes"
192.168.192.129 | CHANGED => {
    "changed": true,
    "gid": 992,
    "name": "admin",
    "state": "present",
    "system": true
}