https://github.com/voxpupuli/puppet-dbbackup
configure dump scripts for mysql, postgres and ldap
https://github.com/voxpupuli/puppet-dbbackup
archlinux-puppet-module centos-puppet-module hacktoberfest ldap linux-puppet-module mysql postgresql puppet puppet-module
Last synced: about 2 months ago
JSON representation
configure dump scripts for mysql, postgres and ldap
- Host: GitHub
- URL: https://github.com/voxpupuli/puppet-dbbackup
- Owner: voxpupuli
- License: agpl-3.0
- Created: 2020-10-19T11:35:48.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-02-05T10:10:40.000Z (3 months ago)
- Last Synced: 2025-03-15T07:38:56.180Z (2 months ago)
- Topics: archlinux-puppet-module, centos-puppet-module, hacktoberfest, ldap, linux-puppet-module, mysql, postgresql, puppet, puppet-module
- Language: Ruby
- Homepage:
- Size: 163 KB
- Stars: 0
- Watchers: 43
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# puppet-dbbackup
[](https://github.com/voxpupuli/puppet-dbbackup/actions?query=workflow%3ACI)
[](https://github.com/voxpupuli/puppet-dbbackup/actions/workflows/release.yml)
[](https://forge.puppetlabs.com/puppet/dbbackup)
[](https://forge.puppetlabs.com/puppet/dbbackup)
[](https://forge.puppetlabs.com/puppet/dbbackup)
[](https://forge.puppetlabs.com/puppet/dbbackup)
[](http://www.puppetmodule.info/m/puppet-dbbackup)
[](LICENSE)
## Table of Contents
* [Overview](#overview)
* [Example configuration](#example-configuration)
* [Tests](#tests)
* [Contributions](#contributions)
* [License and Author](#license-and-author)
## Overview
This is a module for deploying a backup solution for mysql,postgresql and LDAP databases.
It configures two things, the `dump_databases` script in `/usr/local/bin/`, and
a sytemd timer+service to start it. multiple parameters are exposed to
configure the history you want to keep and also the backup interval. All
parameters have [puppet-strings](https://puppet.com/docs/puppet/latest/puppet_strings.html)
documentation in the [REFERENCE.md](REFERENCE.md). Dependingon the database you
backup, multiple CLI tools are required:
* psql
* pg_dumpall
* mysql
* mysqldump
* slapcat
* pigz
The script always assumes that it's executed on the same machine that runs the
database. The dependencies aren't managed by this module.
## Example configuration
You can simply include the class and it will do dumps every 1 hour and never
delete them:
```puppet
include dbbackup
```
you can also configure parameter via Hiera or Puppet DSL. An example:
```yaml
dbbackup::backuphistory: 730
dbbackup::destination: '/var/dumps'
dbbackup::interval: '2h'
```
## Tests
This module has several unit tests and linters configured. You can execute them
by running:
```sh
bundle exec rake test
```
Detailed instructions are in the [CONTRIBUTING.md](.github/CONTRIBUTING.md)
file.
## Contributions
Contribution is fairly easy:
* Fork the module into your namespace
* Create a new branch
* Commit your bugfix or enhancement
* Write a test for it (maybe start with the test first)
* Create a pull request
Detailed instructions are in the [CONTRIBUTING.md](.github/CONTRIBUTING.md)
file.
## License and Author
This module was originally written by [Tim Meusel](https://github.com/bastelfreak).
It's licensed with [AGPL version 3](LICENSE).