puppet-percona

Table of Contents

1. Description
2. Setup - The basics of getting started with percona
   • Beginning with percona
3. Usage - Configuration options and additional functionality
4. Reference - An under-the-hood peek at what the module is doing and how
   • Public Classes
   • Private Classes
   • Parameters
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module

Description

This module installs, configures, and manages the Percona products.

Setup

Beginning with percona

To configure the percona::repo with default parameters, declare the percona::repo class.

include 'percona::repo'

Usage

Configuring modules

class { 'percona::repo':
  percona_release_basearch_enabled => 0,
  percona_release_noarch_enabled   => 0,
}

Configuring modules from Hiera

---
# default off
percona::repo::percona_release_basearch_enabled: 0
percona::repo::percona_release_noarch_enabled: 0

Reference

Public Classes

• percona::repo: Configure the Percona repository and import the GPG keys.
• percona::toolkit: Install and configures percona-toolkit.
• percona::xtrabackup: Install and configures percona-xtrabackup.

Private Classes

• percona::rpm_gpg_key: Import the RPM GPG key for the Percona.

Parameters

Class: percona::toolkit

• ensure: What state the package should be in. Default to installed.

Class: percona::xtrabackup

• ensure: What state the package should be in. Default to installed.
• version: Specify package version. Valid options: a string. Default to undef.

Limitations

This module has been tested on:

• RedHat Enterprise Linux 5, 6, 7
• CentOS 5, 6, 7
• Scientific Linux 5, 6, 7
• Ubuntu 12.04, 14.04, 16.04
• Debian 6, 7, 8

Development

Running tests

The STNS puppet module contains tests for both rspec-puppet (unit tests) and beaker-rspec (acceptance tests) to verify functionality. For detailed information on using these tools, please see their respective documentation.

Testing quickstart

• Unit tests:

$ bundle install
$ bundle exec rake all

• Acceptance tests:

# Set your DOCKER_HOST variable
$ eval "$(docker-machine env default)"

# Run beaker acceptance tests
$ BEAKER_set=centos7 bundle exec rake beaker