Ansible常用模块-user模块

  • Ansible常用模块-user模块已关闭评论
  • 18 views
  • A+
所属分类:ansible

一、概述

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

二、常用参数

name参数:必须参数,用于指定要操作的用户名称,可以使用别名 user

group参数:此参数用于指定用户所在的基本组。

gourps参数:此参数用于指定用户所在的附加组。注意,如果说用户已经存在并且已经拥有多个附加组,那么如果想要继续添加新的附加组,需要结合 append 参数使用,否则在默认情况下,当再次使用 groups 参数设置附加组时,用户原来的附加组会被覆盖。

append参数:如果用户原本就存在多个附加组,那么当使用 groups 参数设置附加组时,当前设置会覆盖原来的附加组设置,如果不想覆盖原来的附加组设置,需要结合 append 参数,将 append 设置为 yes,表示追加附加组到现有的附加组设置,append 默认值为 no。

shell参数:此参数用于指定用户的默认 shell。

uid参数:此参数用于指定用户的 uid 号。

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 系统中使用。

comment参数:此参数用于指定用户的注释信息。

state参数:此参数用于指定用户是否存在于远程主机中,可选值有 present、absent,默认值为 present,表示用户需要存在,当设置为 absent 时表示删除用户。

remove参数:当 state 的值设置为 absent 时,表示要删除远程主机中的用户。但是在删除用户时,不会删除用户的家目录等信息,这是因为 remove 参数的默认值为 no,如果设置为yes,在删除用户的同时,会删除用户的家目录。当 state=absent 并且 remove=yes 时,相当于执行 “userdel --remove” 命令。

password参数:此参数用于指定用户的密码。但是这个密码不能是明文的密码,而是一个对明文密码”加密后”的字符串,相当于 /etc/shadow 文件中的密码字段,是一个对明文密码进行哈希后的字符串,你可以在 python 的命令提示符下输入如下命令,生成明文密码对应的加密字符串。

import crypt; crypt.crypt('666666')

输入上述命令后,即可得到明文密码666666对应的加密字符串。

update_password参数:此参数有两个值可选,always 和 on_create,当此参数的值设置为always 时表示,如果 password 参数设置的值与用户当前的加密过的密码字符串不一致,则直接更新用户的密码,默认值即为 always,但是当此参数设置为 on_create 时,如果 password参数设置的值与用户当前的加密过的密码字符串不一致,则不会更新用户的密码字符串,保持之前的密码设定。如果是新创建的用户,即使此参数设置为 on_create,也会将用户的密码设置为 password 参数对应的值。

generate_ssh_key参数:此参数默认值为 no,如果设置为 yes,表示为对应的用户生成 ssh 密钥对,默认在用户家目录的 ./ssh 目录中生成名为 id_rsa 的私钥和名为 id_rsa.pub 的公钥,如果同名的密钥已经存在与对应的目录中,原同名密钥并不会被覆盖(不做任何操作)。

ssh_key_file参数:当 generate_ssh_key 参数的值为 yes 时,使用此参数自定义生成 ssh 私钥的路径和名称,对应公钥会在同路径下生成,公钥名以私钥名开头,以”.pub”结尾。

ssh_key_comment参数:当 generate_ssh_key 参数的值为 yes 时,在创建证书时,使用此参数设置公钥中的注释信息。但是如果同名的密钥对已经存在,则并不会修改原来的注释信息,即不做任何操作。当不指定此参数时,默认的注释信息为”ansible-generated on 远程主机的主机名”。

ssh_key_passphrase参数:当 generate_ssh_key 参数的值为 yes 时,在创建证书时,使用此参数设置私钥的密码。但是如果同名的密钥对已经存在,则并不会修改原来的密码,即不做任何操作。

ssh_key_type参数:当 generate_ssh_key 参数的值为 yes 时,在创建证书时,使用此参数设置密钥对的类型。默认密钥类型为 rsa,但是如果同名的密钥对已经存在,并不会对同名密钥做任何操作。

三、示例

1.在 ansible-demo3 主机上创建名为 ding 的用户,如果用户已经存在,则不进行任何操作。

[root@ansible-manager ~]# ansible ansible-demo3 -m user -a 'name=ding'
ansible-demo3 | SUCCESS => {
    "append": false, 
    "changed": false, 
    "comment": "", 
    "group": 1000, 
    "home": "/home/ding", 
    "move_home": false, 
    "name": "ding", 
    "shell": "/bin/bash", 
    "state": "present", 
    "uid": 1000
}

2.在 ansible-demo3 主机上删除名为 ding 的用户,但是不会删除 ding 用户的家目录。

[root@ansible-manager ~]# ansible ansible-demo3 -m user -a 'name=ding state=absent'
ansible-demo3 | SUCCESS => {
    "changed": true, 
    "force": false, 
    "name": "ding", 
    "remove": false, 
    "state": "absent"
}

3.在 ansible-demo3 主机上删除名为 ding 的用户,同时会删除 ding 用户的家目录等信息。如果已经不存在 ding 的用户,则不做任何操作。

[root@ansible-manager ~]# ansible ansible-demo3 -m user -a 'name=ding state=absent remove=yes'
ansible-demo3 | SUCCESS => {
    "changed": false, 
    "name": "ding", 
    "state": "absent"
}

4.指定 ansible-demo3 主机上的 ding 用户的主组为 testgroup,testgroup 组需要提前存在,当不使用 group 设置主组时,默认主组与用户名相同。

[root@ansible-manager ~]# ansible ansible-demo3 -m user -a "name=ding group=testgroup"
ansible-demo3 | SUCCESS => {
    "append": false, 
    "changed": true, 
    "comment": "", 
    "group": 1001, 
    "home": "/home/ding", 
    "move_home": false, 
    "name": "ding", 
    "shell": "/bin/bash", 
    "state": "present", 
    "uid": 1000
}

5.指定 ansible-demo3 主机上的 ding 用户的附加组为 testgroup2,testgroup2 组需要提前存在,当不使用 groups 设置附属组时,默认附加组与用户名相同。注意,为了保险起见,在不知道用户原来的附加组设定的情况下,最好将 append 参数设置为 yes,我们也可以一次性设置多个附加组,附加组之间用逗号隔开,比如groups=ding,testgroup,root 。

[root@ansible-manager ~]# ansible ansible-demo3 -m user -a "name=ding groups=testgroup2 append=yes"
ansible-demo3 | SUCCESS => {
    "append": true, 
    "changed": true, 
    "comment": "", 
    "group": 1001, 
    "groups": "testgroup2", 
    "home": "/home/ding", 
    "move_home": false, 
    "name": "ding", 
    "shell": "/bin/bash", 
    "state": "present", 
    "uid": 1000
}

6.指定 ansible-demo3 主机上的 ding 用户的过期时间为2018年12月31日。使用”date -d 2018-12-31 +%s“命令可以获取到对应日期的 unix 时间戳。

[root@ansible-manager ~]# ansible ansible-demo3 -m user -a 'name=ding expires=1546185600'
ansible-demo3 | SUCCESS => {
    "append": false, 
    "changed": true, 
    "comment": "", 
    "group": 1008, 
    "home": "/home/ding", 
    "move_home": false, 
    "name": "ding", 
    "shell": "/bin/bash", 
    "state": "present", 
    "uid": 1000
}

7.指定 ansible-demo3 主机上的 ding 用户的注释信息。

[root@ansible-manager ~]# ansible ansible-demo3 -m user -a 'name=ding comment="www.ding.com" '
ansible-demo3 | SUCCESS => {
    "append": false, 
    "changed": true, 
    "comment": "www.ding.com", 
    "group": 1008, 
    "home": "/home/ding", 
    "move_home": false, 
    "name": "ding", 
    "shell": "/bin/bash", 
    "state": "present", 
    "uid": 1000
}

8.将 ansible-demo3 主机上的 ding 用户的密码设置为666666。

首先生成666666的加密字符串:

[root@ansible-manager ~]# python
Python 2.7.5 (default, Aug  4 2017, 00:39:18) 
[GCC 4.8.5 20150623 (Red Hat 4.8.5-16)] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import crypt;crypt.crypt('666666')
'$6$ziT/sb5KRtUaxoq7$ulfHVLqVgXfmfFUYY7FppzqBQMUYd.2GLDyQwmKv4dYAd0zpgtt5JDheoO/OvvTvY53x9UShX.PtHykJEvsmG0'

使用生成的密码字符串设置用户密码:

[root@ansible-manager ~]# ansible ansible-demo3 -m user -a ' name=ding password="$6$ziT/sb5KRtUaxoq7$ulfHVLqVgXfmfFUYY7FppzqBQMUYd.2GLDyQwmKv4dYAd0zpgtt5JDheoO/OvvTvY53x9UShX.PtHykJEvsmG0" '
ansible-demo3 | SUCCESS => {
    "append": false, 
    "changed": true, 
    "comment": "www.ding.com", 
    "group": 1008, 
    "home": "/home/ding", 
    "move_home": false, 
    "name": "ding", 
    "password": "NOT_LOGGING_PASSWORD", 
    "shell": "/bin/bash", 
    "state": "present", 
    "uid": 1000
}

9.为 ansible-demo3 上的 ding 用户生成 ssh 密钥对。默认在用户家目录的 ./ssh 目录中生成名为 id_rsa 的私钥和名为id_rsa.pub 的公钥,如果已经存在同名密钥,并不会覆盖原来的密钥,即不做任何操作。

[root@ansible-manager ~]# ansible ansible-demo3 -m user -a 'name=ding generate_ssh_key=yes'
ansible-demo3 | SUCCESS => {
    "append": false, 
    "changed": true, 
    "comment": "www.ding.com", 
    "group": 1008, 
    "home": "/home/ding", 
    "move_home": false, 
    "name": "ding", 
    "shell": "/bin/bash", 
    "ssh_fingerprint": "2048 SHA256:frvx+OG3cZvXmICd5VYgOoSpkWEuDpQDwgsxzEzjgAM ansible-generated on ansible-demo3 (RSA)", 
    "ssh_key_file": "/home/ding/.ssh/id_rsa", 
    "ssh_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC8KGJh5sRo45HFvEPy7QwRTT5k+Rnc8eZWwM1iBCYbvcB6LYevB1yUojxE3ycaOnIy7oCokaPIEEsfGYo/y+Eci2TlXea/WrQs3uz8LRxowFg6ZvKODAdSLX0H6DxLP3nnFoxh2Kd5sfglJmCpefIUxNdLBTEeUBfgPfmuLVIQ/+Q7/7Fnpb8XyRsK3MtP+YAm2cLuGbyXoLjncmRcvIDjyYuFYUUoCMsvs7It7LGE+uux7teacCjHJss6O0/7QcDeCYiOUhMq7YE5OcxdMatVgDPQpGjFfPnMu4UZur3YIYlIT7Zb4u7RJWkPQmARtBqIr0dOks9TcL9U5U3XTJ8P ansible-generated on ansible-demo3", 
    "state": "present", 
    "uid": 1000
}

10.为 ansible-demo3 上的 ding 用户生成 ssh 密钥对,密钥对生成在 /opt 目录下,私钥名为 id_rsa_ding,公钥名为 id_rsa_ding.pub。

ansible ansible-demo3 -m user -a 'name=ding generate_ssh_key=yes ssh_key_file=/opt/id_rsa_ding'

11.为 ansible-demo3 上的 ding 用户生成 ssh 密钥对,同时指定公钥中的注释信息为 “www.ding.com”,此参数只能在创建密钥时使用才会生效,并不能操作同名的老密钥。

ansible ansible-demo3 -m user -a 'name=ding generate_ssh_key=yes ssh_key_comment="www.ding.com"'

12.为 ansible-demo3 上的 ding 用户生成 ssh 密钥对,同时指定私钥的密码为123456,此参数只能在创建密钥时使用才会生效,并不能操作同名的老密钥。

ansible ansible-demo3 -m user -a 'name=ding generate_ssh_key=yes ssh_key_passphrase="123456"'

13.为 ansible-demo3 上的 ding 用户生成 ssh 密钥对,同时指定密钥对的类型为 dsa,当不显式指定密钥类型时,默认类型为 rsa,此参数只能在创建密钥时使用才会生效,并不能操作同名的老密钥。

ansible ansible-demo3 -m user -a 'name=ding generate_ssh_key=yes ssh_key_type=dsa'

四、总结

本节介绍了 Ansible 常用模块之 user 模块,并举例说明如何使用,下节我们介绍 group 模块。

  • 安卓客户端下载
  • 微信扫一扫
  • weinxin
  • 微信公众号
  • 微信公众号扫一扫
  • weinxin
avatar