xolyu.mariadb

Überblick Versionen Einblicke

mariadb

Installiert und konfiguriert den MariaDB-Datenbankserver. Erstellt Datenbanken und Nutzer.

Voraussetzungen

Systempaket python3-mysqldb – für die MySQL-Module von Ansible mysql_user und mysql_db.

Um die Pakete automatisch sicherzustellen, siehe die Variable php_ensure_requirements.

Abhängigkeiten

Community.Mysql Sammlung

Rollenspezifische Variablen

mariadb_ensure_requirements
Stellt die Installation der in den Voraussetzungen aufgelisteten Pakete sicher.
Typ: bool
Standard: nein
mariadb_enabled_on_startup
Definiert, ob der MariaDB-Dienst aktiviert werden soll.
Typ: bool
Standard: ja
mariadb_secure_installation
Bestimmt, ob der Abschnitt „sichere Installation“ ausgeführt werden soll, ähnlich wie das Skript „secure_installation“ von MariaDB.
Auswahl: on_install, always, never
Standard: on_install
mariadb_config_style
Bestimmt den Konfigurationsstil.
single_cnf bedeutet, dass nur die globale mariadb.cnf-Datei ausgefüllt wird, Include-Dateien nicht verändert werden, während included_cnf die Existenz des Verzeichnisses mariadb.conf.d sichert und die Include-Dateien zusätzlich zu einer minimalen Konfiguration von mariadb.cnf verwaltet. Bei none wird keine Konfiguration durchgeführt.
Auswahl: single_cnf, included_cnf, none
Standard: single_cnf
mariadb_root_username
Benutzername des MariaDB-Rootbenutzers. Normalerweise sollte dies root sein.
Typ: str
Standard: root
mariadb_root_password
Passwort für den MariaDB-Rootbenutzer.
Typ: str
Standard: nicht festgelegt
mariadb_root_auth_by_unix_socket
Bestimmt, ob das Authentifizierungs-Plugin unix_socket für den Root-Benutzer aktiviert ist oder nicht.
Typ: bool
Standard: ja
mariadb_root_home
Heimatverzeichnis des Root-Benutzers. Dieser Wert wird nur verwendet, wenn das Root-Passwort ohne unix_socket-Auth verwendet wird, sodass die Datei .my.cnf mit Authentifizierungsbenutzernamen und Passwort im Heimatverzeichnis des Roots gespeichert wird.
Typ: str
Standard: /root
mariadb_root_auth_update
Die Authentifizierungsmethoden für Root werden bei der Installation oder wenn diese Variable auf true gesetzt ist, festgelegt.
Im Falle der Authentifizierung mit einem Passwort bedeutet dies, dass dies nur einmal während der Installation vorhanden sein muss, nicht mehr danach, oder nur wenn es geändert wird.
Typ: bool
Standard: nein
mariadb_admin_username
Benutzername eines Admin-Benutzers neben dem Root-Benutzer.
Dies könnte ein Admin-Benutzer für Ansible sein, damit Ansible administrative Änderungen an der Datenbank vornehmen kann, ohne als Root zu handeln.
Typ: str
Standard: nicht festgelegt
mariadb_admin_password
Passwort des Admin-Benutzers.
Typ: str
Standard: nicht festgelegt
mariadb_admin_sysuser
Systembenutzername für den Benutzer, von dem die Datenbank als Admin verwendet werden soll.
Typ: str
Standard: nicht festgelegt
mariadb_admin_home
Heimatverzeichnis des Systembenutzers. Die Datei .my.cnf mit den Authentifizierungsdaten des Datenbank-Admin-Benutzers wird in diesem Verzeichnis gespeichert.
Typ: str
Standard: nicht festgelegt
mariadb_config
Beschreibt die Konfiguration für MariaDB, organisiert in einzelnen Dateien im Falle von included_cnf.
Typ: Dict von Dict von Dict
Standard: siehe defaults/main.yml
```
mariadb_config:
  {cnf_file}:
    $state: present  # present, disabled, absent
    {section}:
      {option}: {value}
```
- cnf_file: Name der Datei (ohne Erweiterung) im Verzeichnis mariadb.conf.d (siehe Variable mariadb_configs_dir).
  Besondere Namen:
  - global_cnf wird für die Konfiguration der globalen mariadb.cnf-Datei verwendet, im Falle des Konfigurationsstils included_cnf.
  - single_cnf wird als Grundlage für die einzelne (globale) mariadb.cnf-Datei verwendet, im Falle des Konfigurationsstils single_cnf.
- section: Der INI-Bereich in der Konfigurationsdatei von MariaDB.
  Besondere Namen:
  - $state ist der Status der Konfigurationsdatei. Standard ist present, weitere Optionen sind disabled und absent.
  - $header wird oben von allen Abschnitten in der cnf-Datei ausgegeben, wird aber nicht automatisch als Kommentar konvertiert.
- option: Option im Abschnitt.
- value: Wert für die Option.
  Besondere Werte:
  - Wenn der Wert eine Liste ist, wird die Option für jedes Listenelement wiederholt.
  - $set oder eine leere Zeichenkette (Länge == 0) bedeutet, dass die Option ohne Wert gesetzt wird.
  - $unset bedeutet, dass die Option nicht in der cnf-Datei vorhanden sein wird.
  - $var(VAR_NAME) bedeutet, dass zur Evaluierungszeit eine Abfrage für die Variable VAR_NAME durchgeführt wird.
mariadb_config_extra_1, mariadb_config_extra_2, mariadb_config_extra_3
Genau dasselbe wie mariadb_config. Diese Variablen ermöglichen eine zusätzliche Anreicherung der Konfiguration, ohne alles vollständig neu definieren zu müssen. Die zusätzlichen Variablen überschreiben zuvor definierte Werte, wobei eine höhere Zahl eine niedrigere übersteuert.
Wenn ein vorher festgelegter Wert entfernt werden soll, kann dies mit dem speziellen Wert $unset geschehen.
Standard: nicht festgelegt
mariadb_packages
Liste der Pakete, die für den MariaDB-Server installiert werden sollen.
Typ: Liste von str
Standard: hängt vom OS ab, Standard siehe vars/[OS-family].yml
mariadb_config_file
Pfad zur globalen mariadb.cnf-Datei.
Typ: str
Standard: hängt vom OS ab, Standard siehe vars/[OS-family].yml
mariadb_configs_dir
Pfad zum Include-Verzeichnis für die cnf-Dateien.
Typ: str
Standard: hängt vom OS ab, Standard siehe vars/[OS-family].yml
mariadb_socket
Pfad zur Socket-Datei der MariaDB-Serverinstanz.
Typ: str
Standard: hängt vom OS ab, Standard siehe vars/[OS-family].yml
mariadb_pid_file
Pfad zur PID-Datei der MariaDB-Serverinstanz.
Typ: str
Standard: hängt vom OS ab, Standard siehe vars/[OS-family].yml
mariadb_bind_address
Bind-Adresse für den MariaDB-Server.
Wird in der Standardkonfiguration mit dem Wert $var(...) verwendet.
Typ: str
Standard: 127.0.0.1
mariadb_datadir
Wird verwendet, um das Datenverzeichnis mit den Berechtigungen sicherzustellen.
Im Falle einer Änderung vom Standard muss es zur Konfiguration hinzugefügt werden, z.B. datadir: $var(mariadb_datadir).
Typ: str
Standard: /var/lib/mysql
mariadb_encoding
Zeichencodierungs-Einstellungen für die MariaDB-Konfiguration.
Wird in der Standardkonfiguration mit dem Wert $var(...) verwendet.
Typ: str
Standard: utf8mb4
mariadb_collation
Sortierungseinstellungen für die MariaDB-Konfiguration.
Wird in der Standardkonfiguration mit dem Wert $var(...) verwendet.
Typ: str
Standard: utf8mb4_general_ci

mariadb_databases
BESCHREIBUNG
Typ: Liste von Dicts
Standard: []

mariadb_databases:
  - name: beispiel
    encoding: utf8
    collation: utf8_general_ci
    state: present  # present, absent

mariadb_users
BESCHREIBUNG
Typ: Liste von Dicts
Standard: []

mariadb_users:
  - name: beispiel
    host: 'localhost'
    password: TOP_secret
    priv: '*.*:USAGE'
    state: present  # present, absent
    append_privs: no  # no, yes
    encrypted: no  # no, yes