Ansible community.mysql.mysql_user: agrega o elimina un usuario de un ejemplo de base de datos MySQL

Nota

Este complemento es parte del colección community.mysql (versión 1.2.0).

Para instalarlo use: ansible-galaxy collection install community.mysql.

Para usarlo en un libro de jugadas, especifique: community.mysql.mysql_user.

• Sinopsis
• Requisitos
• Parámetros
• Notas
• Ver también
• Ejemplos de

Sinopsis

• Agrega o elimina un usuario de una base de datos MySQL.

Requisitos

Los siguientes requisitos son necesarios en el host que ejecuta este módulo.

• PyMySQL (Python 2.7 y Python 3.X), o
• MySQLdb (Python 2.x)

Parámetros

Notas

Nota

• El servidor MySQL se instala por defecto login_user de root y sin contraseña. Para proteger a este usuario como parte de un libro de jugadas idempotente, debe crear al menos dos tareas: 1) cambiar la contraseña del usuario raíz, sin proporcionar ninguna login_user/contraseña de inicio de sesión detalles, 2) soltar un ~/.my.cnf archivo que contiene las nuevas credenciales de root. Las ejecuciones posteriores del libro de jugadas se realizarán correctamente al leer las nuevas credenciales del archivo.
• Actualmente, solo hay soporte para mysql_native_password módulo hash de contraseña cifrada.
• Soporta (check_mode).
• Requiere el paquete PyMySQL (Python 2.7 y Python 3.X) o MySQL-python (Python 2.X) instalado en el host remoto. El paquete de Python se puede instalar con apt-get install python-pymysql (Ubuntu; consulte ansible.builtin.apt) o yum install python2-PyMySQL (RHEL / CentOS / Fedora; ver ansible.builtin.yum). También puede usar dnf install python2-PyMySQL para versiones más nuevas de Fedora; ver ansible.builtin.dnf.
• Asegúrese de tener la biblioteca PyMySQL o MySQLdb instalada en la máquina de destino para el intérprete de Python que Ansible usa, por ejemplo, si es Python 3, debe instalar la biblioteca para Python 3. También puede cambiar el intérprete. Para más información, ver https://docs.ansible.com/ansible/latest/reference_appendices/interpreter_discovery.html.
• Ambos login_password y login_user son necesarios cuando se pasan las credenciales. Si no hay ninguno presente, el módulo intentará leer las credenciales de ~/.my.cnfy, finalmente, vuelva a utilizar el inicio de sesión predeterminado de MySQL de ‘root’ sin contraseña.
• Si hay problemas con las conexiones locales, utilice login_unix_socket = / ruta / a / mysqld / socket en lugar de login_host = localhost podría ayudar. Como ejemplo, la instalación predeterminada de MariaDB de la versión 10.4 y posteriores usa el complemento de autenticación unix_socket de manera predeterminada que sin usar login_unix_socket = / var / run / mysqld / mysqld.sock (la ruta predeterminada) provoca el error Host '127.0.0.1' is not allowed to connect to this MariaDB server.
• Alternativamente, puede usar la biblioteca mysqlclient en lugar de MySQL-python (MySQLdb) que es compatible con Python 2.X y Python> = 3.5. Ver https://pypi.org/project/mysqlclient/ cómo instalarlo.

Ver también

Ver también

community.mysql.mysql_info

La documentación oficial sobre el community.mysql.mysql_info módulo.

Control de acceso de MySQL y referencia de administración de cuentas

Referencia completa de la documentación de control de acceso y administración de cuentas de MySQL.

Referencia de privilegios proporcionados por MySQL

Referencia completa de la documentación de privilegios proporcionada por MySQL.

Ejemplos de

- name: Removes anonymous user account for localhost
  community.mysql.mysql_user:
    name: ''
    host: localhost
    state: absent

- name: Removes all anonymous user accounts
  community.mysql.mysql_user:
    name: ''
    host_all: yes
    state: absent

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

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

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

- name: Create user with password, all database privileges and 'WITH GRANT OPTION' in db1 and db2
  community.mysql.mysql_user:
    state: present
    name: bob
    password: 12345dd
    priv:
      'db1.*': 'ALL,GRANT'
      'db2.*': 'ALL,GRANT'

# Note that REQUIRESSL is a special privilege that should only apply to *.* by itself.
# Setting this privilege in this manner is supported for backwards compatibility only.
# Use 'tls_requires' instead.
- name: Modify user to require SSL connections
  community.mysql.mysql_user:
    name: bob
    append_privs: yes
    priv: '*.*:REQUIRESSL'
    state: present

- name: Modify user to require TLS connection with a valid client certificate
  community.mysql.mysql_user:
    name: bob
    tls_requires:
      x509:
    state: present

- name: Modify user to require TLS connection with a specific client certificate and cipher
  community.mysql.mysql_user:
    name: bob
    tls_requires:
      subject: '/CN=alice/O=MyDom, Inc./C=US/ST=Oregon/L=Portland'
      cipher: 'ECDHE-ECDSA-AES256-SHA384'

- name: Modify user to no longer require SSL
  community.mysql.mysql_user:
    name: bob
    tls_requires:

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

# check_implicit_admin example
- name: >
    Ensure no user named 'sally'@'localhost' exists, also passing in the auth credentials.
    If mysql allows root/nopassword login, try it without the credentials first.
    If it's not allowed, pass the credentials
  community.mysql.mysql_user:
    check_implicit_admin: yes
    login_user: root
    login_password: 123456
    name: sally
    state: absent

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

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

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

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

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

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

- name: Create user 'bob' authenticated with plugin 'AWSAuthenticationPlugin'
  community.mysql.mysql_user:
    name: bob
    plugin: AWSAuthenticationPlugin
    plugin_hash_string: RDS
    priv: '*.*:ALL'
    state: present

- name: Limit bob's resources to 10 queries per hour and 5 connections per hour
  community.mysql.mysql_user:
    name: bob
    resource_limits:
      MAX_QUERIES_PER_HOUR: 10
      MAX_CONNECTIONS_PER_HOUR: 5

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

Autores

• Jonathan Mainguy (@Jmainguy)
• Benjamin Malynovytch (@bmalynovytch)
• Lukasz Tomaszkiewicz (@tomaszkiewicz)