Merge pull request #1489 from puppetlabs/release-prep

Release prep v13.0.0

CHANGELOG.md

@@ -2,28 +2,55 @@
 
 All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](http://semver.org).
 
-## [v12.0.3](https://github.com/puppetlabs/puppetlabs-mysql/tree/v12.0.3) - 2022-05-25
+## [v13.0.0](https://github.com/puppetlabs/puppetlabs-mysql/tree/v13.0.0) (2022-08-25)
 
-[Full Changelog](https://github.com/puppetlabs/puppetlabs-mysql/compare/v12.0.2...v12.0.3)
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-mysql/compare/v12.0.3...v13.0.0)
+
+### Changed
+
+- Harden db defined type [\#1484](https://github.com/puppetlabs/puppetlabs-mysql/pull/1484) ([chelnak](https://github.com/chelnak))
+
+### Added
+
+- pdksync - \(GH-cat-11\) Certify Support for Ubuntu 22.04 [\#1483](https://github.com/puppetlabs/puppetlabs-mysql/pull/1483) ([david22swan](https://github.com/david22swan))
+- \[Compatibility\] Add Raspbian OS to provider configuration [\#1481](https://github.com/puppetlabs/puppetlabs-mysql/pull/1481) ([jordi-upc](https://github.com/jordi-upc))
+- Allow excludedatabases when using file\_per\_database [\#1480](https://github.com/puppetlabs/puppetlabs-mysql/pull/1480) ([HT43-bqxFqB](https://github.com/HT43-bqxFqB))
+- pdksync - \(GH-cat-12\) Add Support for Redhat 9 [\#1477](https://github.com/puppetlabs/puppetlabs-mysql/pull/1477) ([david22swan](https://github.com/david22swan))
 
 ### Fixed
 
-- (IAC-1595) MySQL maintenance [#1472](https://github.com/puppetlabs/puppetlabs-mysql/pull/1472) ([LukasAud](https://github.com/LukasAud))
+- Harden config class [\#1487](https://github.com/puppetlabs/puppetlabs-mysql/pull/1487) ([chelnak](https://github.com/chelnak))
+- Harden service class [\#1486](https://github.com/puppetlabs/puppetlabs-mysql/pull/1486) ([chelnak](https://github.com/chelnak))
+- Harden root password class [\#1485](https://github.com/puppetlabs/puppetlabs-mysql/pull/1485) ([chelnak](https://github.com/chelnak))
+- Use MariaDB for Ubuntu 20.04 [\#1449](https://github.com/puppetlabs/puppetlabs-mysql/pull/1449) ([treydock](https://github.com/treydock))
+- Add support for mariabackup  [\#1447](https://github.com/puppetlabs/puppetlabs-mysql/pull/1447) ([rsynnest](https://github.com/rsynnest))
+
+## [v12.0.3](https://github.com/puppetlabs/puppetlabs-mysql/tree/v12.0.3) (2022-05-25)
 
-- Solve issue with repeated restarts if ssl-disable is true [#1425](https://github.com/puppetlabs/puppetlabs-mysql/pull/1425) ([markasammut](https://github.com/markasammut))
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-mysql/compare/v12.0.2...v12.0.3)
+
+### Fixed
+
+- \(IAC-1595\) MySQL maintenance [\#1472](https://github.com/puppetlabs/puppetlabs-mysql/pull/1472) ([LukasAud](https://github.com/LukasAud))
+- Solve issue with repeated restarts if ssl-disable is true [\#1425](https://github.com/puppetlabs/puppetlabs-mysql/pull/1425) ([markasammut](https://github.com/markasammut))
 
 ## [v12.0.2](https://github.com/puppetlabs/puppetlabs-mysql/tree/v12.0.2) (2022-04-19)
 
 [Full Changelog](https://github.com/puppetlabs/puppetlabs-mysql/compare/v12.0.1...v12.0.2)
 
+### Added
+
+- pdksync - \(IAC-1753\) - Add Support for AlmaLinux 8 [\#1444](https://github.com/puppetlabs/puppetlabs-mysql/pull/1444) ([david22swan](https://github.com/david22swan))
+- pdksync - \(IAC-1751\) - Add Support for Rocky 8 [\#1442](https://github.com/puppetlabs/puppetlabs-mysql/pull/1442) ([david22swan](https://github.com/david22swan))
+
 ### Fixed
 
-- add mysql_native_password plugin to authentication_string vs password [\#1441](https://github.com/puppetlabs/puppetlabs-mysql/pull/1441) ([Heidistein](https://github.com/Heidistein))
-- fix Error: Transaction store file transactionstore.yaml is corrupt [\#1429](https://github.com/puppetlabs/puppetlabs-mysql/pull/1429) ([andeman](https://github.com/andeman))
-- pdksync - \(MAINT\) Remove RHEL 5 family support [\#1369](https://github.com/puppetlabs/puppetlabs-mysql/pull/1369) ([sanfrancrisko](https://github.com/sanfrancrisko))
-- pdksync - \(MAINT\) Remove SLES 11 support [\#1370](https://github.com/puppetlabs/puppetlabs-mysql/pull/1370) ([sanfrancrisko](https://github.com/sanfrancrisko))
-- pdksync - \(GH-iac-334\) Remove Support for Ubuntu 16.04 [\#1457](https://github.com/puppetlabs/puppetlabs-mysql/pull/1457) ([david22swan](https://github.com/david22swan))
 - \(Bugfix\) Grant privileges idempotency Fix [\#1466](https://github.com/puppetlabs/puppetlabs-mysql/pull/1466) ([LukasAud](https://github.com/LukasAud))
+- pdksync - \(GH-iac-334\) Remove Support for Ubuntu 16.04 [\#1457](https://github.com/puppetlabs/puppetlabs-mysql/pull/1457) ([david22swan](https://github.com/david22swan))
+- pdksync - \(IAC-1787\) Remove Support for CentOS 6 [\#1450](https://github.com/puppetlabs/puppetlabs-mysql/pull/1450) ([david22swan](https://github.com/david22swan))
+- add mysql\_native\_password plugin to authentication\_string vs password [\#1441](https://github.com/puppetlabs/puppetlabs-mysql/pull/1441) ([Heidistein](https://github.com/Heidistein))
+- fix Error: Transaction store file transactionstore.yaml is corrupt [\#1429](https://github.com/puppetlabs/puppetlabs-mysql/pull/1429) ([andeman](https://github.com/andeman))
+- Combine multiple grants into one while checking state [\#1428](https://github.com/puppetlabs/puppetlabs-mysql/pull/1428) ([fuyar](https://github.com/fuyar))
 
 ## [v12.0.1](https://github.com/puppetlabs/puppetlabs-mysql/tree/v12.0.1) (2021-08-26)
 

REFERENCE.md

@@ -464,7 +464,6 @@ The following parameters are available in the `mysql::server` class:
 * [`config_file_mode`](#config_file_mode)
 * [`includedir`](#includedir)
 * [`install_options`](#install_options)
-* [`install_secret_file`](#install_secret_file)
 * [`manage_config_file`](#manage_config_file)
 * [`options`](#options)
 * [`override_options`](#override_options)
@@ -529,14 +528,6 @@ Passes [install_options](https://docs.puppetlabs.com/references/latest/type.html
 
 Default value: ``undef``
 
-##### <a name="install_secret_file"></a>`install_secret_file`
-
-Data type: `Any`
-
-Path to secret file containing temporary root password.
-
-Default value: `$mysql::params::install_secret_file`
-
 ##### <a name="manage_config_file"></a>`manage_config_file`
 
 Data type: `Any`
@@ -795,17 +786,26 @@ Create and manage a MySQL backup.
 
 ```puppet
 class { 'mysql::server':
-  root_password => 'password'
+  root_password           => 'password'
 }
 class { 'mysql::server::backup':
-  backupuser     => 'myuser',
-  backuppassword => 'mypassword',
-  backupdir      => '/tmp/backups',
+  backupuser              => 'myuser',
+  backuppassword          => 'mypassword',
+  backupdir               => '/tmp/backups',
+}
+```
+
+##### Create a basic MySQL backup using mariabackup:
+
+```puppet
+class { 'mysql::server':
+  root_password           => 'password'
 }
 class { 'mysql::server::backup':
-  backupmethod => 'mariabackup',
-  provider     => 'xtrabackup',
-  backupdir    => '/tmp/backups',
+  backupmethod            => 'mariabackup',
+  backupmethod_package    => 'mariadb-backup'
+  provider                => 'xtrabackup',
+  backupdir               => '/tmp/backups',
 }
 ```
 
@@ -841,6 +841,8 @@ The following parameters are available in the `mysql::server::backup` class:
 * [`install_cron`](#install_cron)
 * [`compression_command`](#compression_command)
 * [`compression_extension`](#compression_extension)
+* [`backupmethod_package`](#backupmethod_package)
+* [`excludedatabases`](#excludedatabases)
 
 ##### <a name="backupuser"></a>`backupuser`
 
@@ -1022,7 +1024,7 @@ Default value: `'/usr/bin:/usr/sbin:/bin:/sbin'`
 
 Data type: `Any`
 
-Sets the server backup implementation. Valid values are:
+Sets the server backup implementation. Valid values are: xtrabackup, mysqldump, mysqlbackup
 
 Default value: `'mysqldump'`
 
@@ -1067,6 +1069,22 @@ Configure the file extension for the compressed backup (when using the mysqldump
 
 Default value: ``undef``
 
+##### <a name="backupmethod_package"></a>`backupmethod_package`
+
+Data type: `Any`
+
+The package which provides the binary specified by the backupmethod parameter.
+
+Default value: `$mysql::params::xtrabackup_package_name`
+
+##### <a name="excludedatabases"></a>`excludedatabases`
+
+Data type: `Array[String]`
+
+Give a list of excluded databases when using file_per_database, e.g.: [ 'information_schema', 'performance_schema' ]
+
+Default value: `[]`
+
 ## Defined types
 
 ### <a name="mysqldb"></a>`mysql::db`
@@ -1090,6 +1108,7 @@ mysql::db { 'mydb':
 
 The following parameters are available in the `mysql::db` defined type:
 
+* [`name`](#name)
 * [`user`](#user)
 * [`password`](#password)
 * [`tls_options`](#tls_options)
@@ -1106,6 +1125,14 @@ The following parameters are available in the `mysql::db` defined type:
 * [`import_cat_cmd`](#import_cat_cmd)
 * [`mysql_exec_path`](#mysql_exec_path)
 
+##### <a name="name"></a>`name`
+
+The name of the database to create. Database names must:
+  * be longer than 64 characters.
+  * not contain / \ or . characters.
+  * not contain characters that are not permitted in file names.
+  * not end with space characters.
+
 ##### <a name="user"></a>`user`
 
 Data type: `Any`
@@ -1128,7 +1155,7 @@ Default value: ``undef``
 
 ##### <a name="dbname"></a>`dbname`
 
-Data type: `Any`
+Data type: `String`
 
 The name of the database to create.
 
@@ -1176,9 +1203,9 @@ Default value: ``undef``
 
 ##### <a name="sql"></a>`sql`
 
-Data type: `Optional[Variant[Array, Hash, String]]`
+Data type: `Optional[Array]`
 
-The path to the sqlfile you want to execute. This can be single file specified as string, or it can be an array of strings.
+The path to the sqlfile you want to execute. This can be an array containing one or more file paths.
 
 Default value: ``undef``
 
@@ -1208,7 +1235,7 @@ Default value: `300`
 
 ##### <a name="import_cat_cmd"></a>`import_cat_cmd`
 
-Data type: `Any`
+Data type: `Enum['cat', 'zcat', 'bzcat']`
 
 Command to read the sqlfile for importing the database. Useful for compressed sqlfiles. For example, you can use 'zcat' for .gz files.
 
@@ -1556,7 +1583,7 @@ Hash a string as mysql's "PASSWORD()" function would do it
 
 #### `mysql::password(Variant[String, Sensitive[String]] $password, Optional[Boolean] $sensitive)`
 
-The mysql::password function.
+Hash a string as mysql's "PASSWORD()" function would do it
 
 Returns: `Variant[String, Sensitive[String]]` hash
 The mysql password hash from the clear text password.

metadata.json

@@ -1,6 +1,6 @@
 {
   "name": "puppetlabs-mysql",
-  "version": "12.0.3",
+  "version": "13.0.0",
   "author": "puppetlabs",
   "summary": "Installs, configures, and manages the MySQL service.",
   "license": "Apache-2.0",