hfm / puppet-percona

puppet-percona module installs, configures, and manages the Percona products.

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

1. Limitations - OS compatibility, etc.
2. 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

puppet-percona's Issues

add pmm-client ?

Hello,
Is the management of the pmm-client ( https://www.percona.com/doc/percona-monitoring-and-management/install.html#installing-on-red-hat-or-centos ) in your roadmap ?

GPG validation of packages ignored.

puppet-percona/manifests/xtrabackup.pp

Line 34 in b159df6

install_options => ['--allow-unauthenticated'],

This is extremely unsafe, do not do this. Please fix the apt gpg key:

puppet-percona/manifests/repo/apt.pp

Line 14 in b159df6

id => '430BDF5C56E7C94E848EE60C1C4CBDCDCD2EFD2A',

Change to:

id => '4D1BB29D63D98E422B2113B19334A25F8507EFA5',
server => 'keyserver.ubuntu.com'