Merge pull request #79 from echocat/develop

backmerge for release 1.9.0

Author: dwerder

.travis.yml

@@ -2,6 +2,7 @@
 sudo: false
 language: ruby
 cache: bundler
+env: BUNDLE_PATH=.bundle
 bundler_args: --without system_tests
 before_install: rm Gemfile.lock || true
 script: bundle exec rake validate lint spec 

CHANGELOG.md

@@ -1,3 +1,13 @@
+## 2016-06-24 - 1.9.0 (Feature/Bugfix release)
+
+#### Bugfixes:
+
+- (734defe) redis-check-dump was renamed to redis-check-rdb in redis version 3.2
+
+#### Features:
+
+- (123f474) Add initial cluster support to redis::server
+
 ## 2016-04-08 - 1.8.1 (Bugfix release)
 
 #### Bugfixes:

README.md

@@ -6,6 +6,7 @@
 2. [Setup - The basics of getting started with redis](#setup)
     * [Beginning with redis - Installation](#beginning-with-redis)
     * [Run multiple instances on same host](#run-multiple-instances-on-same-host)
+    * [Create a cluster-enabled instance](#Create a cluster-enable instance)
     * [Setting up sentinel with two monitors](#setting-up-sentinel-with-two-monitors)
 3. [Usage - The class and defined types available for configuration](#usage)
     * [Classes and Defined Types](#classes-and-defined-types)
@@ -139,6 +140,36 @@ node 'redis-slave.my.domain' {
 }
 ```
 
+###Create a cluster-enable instance
+
+Please note that right now you can only create cluster-enabled instances
+but you cannot configure a Redis Cluster only with this module. You should
+still use `redis-trib.rb` from Redis source distribution or configure it
+by hand with redis cluster commands. Moreover, the cluster mode will be enabled 
+only for Redis >= 3.0
+
+A simple example of a cluster-enabled instance, with a timeout of 5 seconds to
+detect if another node is dead.
+
+```puppet
+node 'redis-cluster.my.domain' {
+
+  # install latest stable build.
+  class { 'redis::install': }
+
+  redis::server {
+    'cluster-instance':
+      redis_memory         => '1g',
+      redis_ip             => '0.0.0.0',
+      redis_port           => 6379,
+      running              => true,
+      enabled              => true,
+      cluster_enabled      => true,
+      cluster_node_timeout => '5000',
+  }
+}
+```
+
 ### Example using Hiera
 
     redis::install::redis_package: true
@@ -402,6 +433,28 @@ Configure Redis slave replication timeout in seconds. Default: 60 (number)
 
 Configure Redis replication ping slave period in seconds. Default: 10 (number)
 
+##### Cluster Options
+
+#####`cluster_enabled`
+
+Enable Redis Cluster. Supported only in Redis 3.x. Default: false
+
+#####`cluster_node_timeout`
+
+Timeout in ms to declare a node as failed.
+
+#####`cluster_slave_validity_factor`
+
+Configure slave validity factor. Please read the Redis documentation to learn more about this parameter.
+
+#####`cluster_migration_barrier`
+
+Slaves migrate to orphaned masters only if there are still at least this given number of other working slaves for their old master.
+
+#####`cluster_require_full_coverage`
+
+By default Redis Cluster nodes stop accepting queries if they detect there is at least an hash slot uncovered.
+
 ####Defined Type: `redis::sentinel`
 
 Used to configure sentinel instances. You can setup multiple sentinel servers

manifests/install.pp

@@ -31,19 +31,20 @@
   $download_tool     = $::redis::params::download_tool,
   $redis_user        = $::redis::params::redis_user,
   $redis_group       = $::redis::params::redis_group,
-  $download_base     = $::redis::params::download_base,
-) inherits redis {
-  if ( $redis_package == true ) {
+  $download_base     = $::redis::params::download_base,) inherits redis {
+  if ($redis_package == true) {
     case $::operatingsystem {
-      'Debian', 'Ubuntu': {
-        package { 'redis-server' : ensure => $redis_version, }
-        service { 'redis-server' :
+      'Debian', 'Ubuntu' : {
+        package { 'redis-server': ensure => $redis_version, }
+
+        service { 'redis-server':
           ensure    => stopped,
           subscribe => Package['redis-server']
         }
       }
-      'Fedora', 'RedHat', 'CentOS', 'OEL', 'OracleLinux', 'Amazon', 'Scientific', 'SLES': {
-        package { 'redis' : ensure => $redis_version, }
+      'Fedora', 'RedHat', 'CentOS', 'OEL', 'OracleLinux', 'Amazon', 'Scientific', 'SLES' : {
+        package { 'redis': ensure => $redis_version, }
+
         # The SLES DatabaseServer repository installs a conflicting logrotation configuration
         if $::operatingsystem == 'SLES' {
           file { '/etc/logrotate.d/redis':
@@ -52,30 +53,29 @@
           }
         }
       }
-      'Gentoo': {
-        package { 'dev-db/redis' : ensure => $redis_version, }
+      'Gentoo'           : {
+        package { 'dev-db/redis': ensure => $redis_version, }
       }
-      default: {
+      default            : {
         fail('The module does not support this OS.')
       }
     }
   } else {
-
     # install necessary packages for build.
     case $::operatingsystem {
-      'Debian', 'Ubuntu': {
+      'Debian', 'Ubuntu' : {
         ensure_packages('build-essential')
         Package['build-essential'] -> Anchor['redis::prepare_build']
       }
-      'Fedora', 'RedHat', 'CentOS', 'OEL', 'OracleLinux', 'Amazon', 'Scientific', 'Sles': {
+      'Fedora', 'RedHat', 'CentOS', 'OEL', 'OracleLinux', 'Amazon', 'Scientific', 'Sles' : {
         ensure_packages('make')
         Package['make'] -> Anchor['redis::prepare_build']
         ensure_packages('gcc')
         Package['gcc'] -> Anchor['redis::prepare_build']
         ensure_packages('glibc-devel')
         Package['glibc-devel'] -> Anchor['redis::prepare_build']
       }
-      default: {
+      default            : {
         fail('The module does not support this OS.')
       }
     }
@@ -90,9 +90,7 @@
       before  => File[$redis_build_dir]
     }
 
-    file { $redis_build_dir:
-      ensure => directory,
-    }
+    file { $redis_build_dir: ensure => directory, }
 
     $redis_download_url = "${download_base}/redis-${redis_version}.tar.gz"
 
@@ -107,9 +105,7 @@
       group   => 'root',
     }
 
-    anchor { 'redis::prepare_build':
-      before => Exec['redis::compile'],
-    }
+    anchor { 'redis::prepare_build': before => Exec['redis::compile'], }
 
     # if this fails, then a 'make distclean' can help
     exec { 'redis::compile':
@@ -127,18 +123,29 @@
       require => Exec['redis::compile']
     }
 
-    anchor { 'redis::install':
-      require => File["${redis_build_dir}/redis"],
-    }
+    anchor { 'redis::install': require => File["${redis_build_dir}/redis"], }
 
-    $redis_binaries = [
-      'redis-benchmark',
-      'redis-check-aof',
-      'redis-check-dump',
-      'redis-cli',
-      'redis-sentinel',
-      'redis-server'
-    ]
+    # issue #75 redis-check-dump was renamed to redis-check.rdb since 3.2
+    case $redis_version {
+      /^2\./, /^3\.0/, /^3\.1/ : {
+        $redis_binaries = [
+          'redis-benchmark',
+          'redis-check-aof',
+          'redis-check-dump',
+          'redis-cli',
+          'redis-sentinel',
+          'redis-server']
+      }
+      default             : {
+        $redis_binaries = [
+          'redis-benchmark',
+          'redis-check-aof',
+          'redis-check-rdb',
+          'redis-cli',
+          'redis-sentinel',
+          'redis-server']
+      }
+    }
 
     redis::installbinary { $redis_binaries:
       require           => Anchor['redis::install'],

manifests/server.pp

@@ -86,6 +86,25 @@
 #
 # [*manage_logrotate*]
 #   Configure logrotate rules for redis server. Default: true
+#
+# [*cluster_enabled*]
+#   Enable Redis Cluster. Supported only in Redis 3.x. Default: false
+#
+# [*cluster_node_timeout*]
+#   Timeout in ms to declare a node as failed.
+#
+# [*cluster_slave_validity_factor*]
+#   Configure slave validity factor. Please read the Redis documentation to learn more
+#   about this parameter.
+#
+# [*cluster_migration_barrier*]
+#   Slaves migrate to orphaned masters only if there are still at least this
+#   given number of other working slaves for their old master.
+#
+# [*cluster_require_full_coverage*]
+#   By default Redis Cluster nodes stop accepting queries if they detect there
+#   is at least an hash slot uncovered.
+
 define redis::server (
   $redis_name              = $name,
   $redis_memory            = '100mb',
@@ -126,6 +145,11 @@
   $hash_max_ziplist_entries = 512,
   $hash_max_ziplist_value  = 64,
   $manage_logrotate        = true,
+  $cluster_enabled         = false,
+  $cluster_node_timeout          = undef,
+  $cluster_slave_validity_factor = undef,
+  $cluster_migration_barrier     = undef,
+  $cluster_require_full_coverage = true,
 ) {
   $redis_user              = $::redis::install::redis_user
   $redis_group             = $::redis::install::redis_group
@@ -139,6 +163,7 @@
     default                                                    => undef,
   }
   $redis_2_6_or_greater = versioncmp($::redis::install::redis_version,'2.6') >= 0
+  $redis_with_cluster_support = versioncmp($::redis::install::redis_version,'3.0') >= 0
 
   # redis conf file
   $conf_file_name = "redis_${redis_name}.conf"

metadata.json

@@ -30,7 +30,7 @@
     }
   ],
   "name": "dwerder-redis",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "source": "https://github.com/echocat/puppet-redis.git",
   "author": "Daniel Werdermann",
   "license": "MPL-2.0",