diff --git a/docs/rolereference.rst b/docs/rolereference.rst index 5f36c34ce430a3dacf1ac52fc6719ced38726e72..bab0b80d49ea295b1442c6c84d9f4bcd6ff161f8 100644 --- a/docs/rolereference.rst +++ b/docs/rolereference.rst @@ -1180,3 +1180,37 @@ running a bare Django project): wsgi_application: django_example_com.wsgi:application https_tls_key: "{{ inventory_dir }}/tls/wsgi.example.com_https.key" https_tls_certificate: "{{ inventory_dir }}/tls/wsgi.example.com_https.pem" + + +Database Server +--------------- + +The ``database_server`` role can be used for setting-up a MariaDB database +server on destination machine. + +The role implements the following: + +* Installs MariaDB server and client. +* Configures MariaDB server and client to use *UTF-8* encoding by default. +* Sets password for the database root user. +* Deploys MariaDB client configuration in location ``/root/.my.cnf`` that + contains username and password for the root database user. + + +Parameters +~~~~~~~~~~ + +**db_root_password** (string, mandatory) + Password for the *root* database user. + + +Examples +~~~~~~~~ + +Here is an example configuration for setting-up the database server: + +.. code-block:: yaml + + --- + + db_root_password: root