saltstack-formulas/mysql-formula
1
0
Fork 0
mirror of https://github.com/saltstack-formulas/mysql-formula.git synced 2025-04-16 01:30:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Install the MySQL client and/or server
122 commits 3 branches 23 tags 951 KiB
Find a file
Wolodja Wentland c2c1e3959e Ensure that debconf-utils is installed on Debian systems 
debconf.set which is used in mysql.server has a dependency on debconf-utils. If
it is not installed the password will not be set and is cumbersome to change
later on.
2014-11-25 17:54:04 +00:00
mysql Ensure that debconf-utils is installed on Debian systems 2014-11-25 17:54:04 +00:00
scripts Add scripted parsing of all mysql options 2014-10-10 16:43:15 +10:00
import_users.py Use a dict instead of a list for users 2014-11-02 00:57:27 -04:00
LICENSE Add LICENSE. 2013-07-27 22:58:38 +02:00
pillar.example Use a dict instead of a list for users 2014-11-02 00:57:27 -04:00
README.rst Add remove test database state 2014-10-14 13:28:33 +10:00

README.rst

mysql

Install the MySQL client and/or server.

Available states

mysql

Meta-state that includes all server packages in the correct order.

This meta-state does not include mysql.remove_test_database; see below for details.

mysql.client

Install the MySQL client package.

mysql.server

Install the MySQL server package and start the service.

Debian OS family supports setting MySQL root password during install via debconf.

Note

If no root password is provided in the pillar, a random one will be created. Because Hydrogen doesn't have easy access to a random function (test.rand_str isn't introduced until Helium), instead, we use the not-at-all random grains.server_id. As this is cryptographically insecure, future formula versions should use the newly available random.get_str method.

mysql.database

Create and manage MySQL databases.

mysql.python

Install mysql python bindings.

mysql.user

Create and manage MySQL database users with definable GRANT privileges.

The state accepts MySQL hashed passwords or clear text. Hashed password have priority.

Note

See the salt.states.mysql_user docs for additional information on configuring hashed passwords.

Make sure to quote the passwords in the pillar so YAML doesn't throw an exception.

mysql.remove_test_database

Warning

Do not use this state if your MySQL instance has a database in use called test. If you do, it will be irrevocably removed!

Remove the database called test, normally created as part of a default MySQL installation. This state is not included as part of the meta-state above as this name may conflict with a real database.

Updating the supported parameters

The supported_params.yaml file contains the full listing of options that are acceptable in the MySQL options file. On occassion, especially on new releases of MySQL, this file may need to be updated. To update, run the supplied script (requires Python 3.x):

./scripts/parse_supported_params.py -o ./mysql/supported_params.yaml

This script will scrape the options from the official MySQL documentation online, and thus requires web access. Scraping is inherently brittle, though this script has been defensively coded, where possible.

Once the supported_params.yaml file has been updated, commit the result to the repository.

Support for new applications

To add support for configuration of other MySQL applications, add the URL and section identifier into the relevant section of the script. Consult the comments in the code to determine where your section should be added.