mysql_user - 从MySQL数据库添加或删除用户。

概要

  • 从MySQL数据库添加或删除用户。

选项

参数需要默认选择注释
append_privs
(1.4 加入)
no no
  • yes
  • no
将priv定义的权限附加到此用户的现有权限,而不是覆盖现有的权限。
check_implicit_admin
(1.3 加入)
no no
  • yes
  • yes
检查mysql是否允许以root / nopassword身份登录,然后再尝试提供的凭据。
CONFIG_FILE
(2.0 加入)
no 〜/ .my.cnf  
指定要从中读取用户和密码的配置文件。
connect_timeout
(2.1 加入)
no 30  
连接到MySQL服务器时的连接超时。
encrypted(加密)
(2.0 加入)
no no
  • yes
  • no
表示'密码'字段是一个`mysql_native_password`哈希值
host
 
no localhost  
the 'host' part of the MySQL username
host_all
(2.1加入)
no no
  • yes
  • no
覆盖host选项,使给定用户对所有主机名进行ansible应用更改。创建用户时不能使用此选项
login_host
 
no localhost  
运行数据库的主机。
login_password
 
no    
用于验证的密码。
login_port
 
no 3306  
MySQL服务器端口。如果使用login_port,则需要将login_host定义为其他本地主机。
login_unix_socket
 
no    
到本地连接的Unix域套接字的路径。
login_user
 
no    
用于验证的用户名。
name
 
yes    
添加或删除的用户名称(角色)
password
 
no    
设置用户密码。
priv
 
no    
MySQL特权字符串格式为:db.table:priv1,priv2
可以通过使用正斜杠分隔每个特权来指定多个权限:db.table:priv/db.table:priv
该格式基于MySQL GRANT语句。
数据库和表名可以引用,MySQL风格。
如果使用列权限,则该priv1,priv2部分必须与SHOW GRANT语句完全相同如果不遵循,模块将始终报告更改。它包括通过permission(SELECT(col1,col2)而不是SELECT(col1SELECT(col2))分组列)。
SQL_LOG_BIN
(2.1加入)
no yes
  • yes
  • no
是否应该为连接启用或禁用二进制日志记录。
ssl_ca
(2.0加入)
no    
证书颁发机构(CA)证书的路径。此选项(如果使用)必须指定与服务器使用的相同的证书。
ssl_cert
(2.0加入)
no    
客户端公钥证书的路径。
ssl_key
(2.0加入)
no    
客户端私钥的路径。
state no present
  • present
  • absent
用户是否应该存在 absent时删除用户。
update_password
(2.0加入)
no always
  • always
  • on_create
如果不同,always将更新密码。 on_create只会为新创建的用户设置密码。

例子

# Removes anonymous user account for localhost
- mysql_user:
    name: ''
    host: localhost
    state: absent

# Removes all anonymous user accounts
- mysql_user:
    name: ''
    host_all: yes
    state: absent

# Create database user with name 'bob' and password '12345' with all database privileges
- mysql_user:
    name: bob
    password: 12345
    priv: '*.*:ALL'
    state: present

# Create database user with name 'bob' and previously hashed mysql native password '*EE0D72C1085C46C5278932678FBE2C6A782821B4' with all database privileges
- mysql_user:
    name: bob
    password: '*EE0D72C1085C46C5278932678FBE2C6A782821B4'
    encrypted: yes
    priv: '*.*:ALL'
    state: present

# Creates database user 'bob' and password '12345' with all database privileges and 'WITH GRANT OPTION'
- mysql_user:
    name: bob
    password: 12345
    priv: '*.*:ALL,GRANT'
    state: present

# Modify user Bob to require SSL connections. Note that REQUIRESSL is a special privilege that should only apply to *.* by itself.
- mysql_user:
    name: bob
    append_privs: true
    priv: '*.*:REQUIRESSL'
    state: present

# Ensure no user named 'sally'@'localhost' exists, also passing in the auth credentials.
- mysql_user:
    login_user: root
    login_password: 123456
    name: sally
    state: absent

# Ensure no user named 'sally' exists at all
- mysql_user:
    name: sally
    host_all: yes
    state: absent

# Specify grants composed of more than one word
- mysql_user:
    name: replication
    password: 12345
    priv: "*.*:REPLICATION CLIENT"
    state: present

# Revoke all privileges for user 'bob' and password '12345'
- mysql_user:
    name: bob
    password: 12345
    priv: "*.*:USAGE"
    state: present

# Example privileges string format
# mydb.*:INSERT,UPDATE/anotherdb.*:SELECT/yetanotherdb.*:ALL

# Example using login_unix_socket to connect to server
- mysql_user:
    name: root
    password: abc123
    login_unix_socket: /var/run/mysqld/mysqld.sock

# Example of skipping binary logging while adding user 'bob'
- mysql_user:
    name: bob
    password: 12345
    priv: "*.*:USAGE"
    state: present
    sql_log_bin: no

# Example .my.cnf file for setting the root password
# [client]
# user=root
# password=n<_665{vS43y

注意

  • MySQL服务器的默认login_user为“root”,无密码。为了将此用户作为幂等playboot的一部分,您必须至少创建两个任务:首先必须更改root用户的密码,而不提供任何login_user / login_password详细信息。第二个必须删除包含新的根凭证的〜/ .my.cnf文件。然后,通过从文件读取新的凭据,随后的游戏将成功。
  • 目前,只支持mysql_native_password加密密码散列模块。
  • 需要远程主机上的MySQLdb Python包。对于Ubuntu,这和apt-get install python-mysqldb一样简单。(请参阅apt。)对于CentOS / Fedora,这与yum安装MySQL-python一样简单。(见yum。)
  • 无论login_passwordlogin_user你逝去的凭据是必需的。如果不存在,则模块将尝试从中读取凭据~/.my.cnf,最后回到使用MySQL默认登录的“root”,没有密码。

状态

该模块被标记为预览,这意味着它不能保证具有向后兼容的界面。

支持

这个模块是没有核心提交者监督的社区维护的。

有关这是什么意思的更多信息,请阅读模块支持

为了帮助开发模块,如果您有这样的倾向,请阅读社区信息和贡献测试可编程开发模块