Skip to content

Latest commit

 

History

History
86 lines (66 loc) · 2.98 KB

README.md

File metadata and controls

86 lines (66 loc) · 2.98 KB
Raw

puppet-phpmyadmin

This is the puppet phpMyAdmin module which allows you to install and manage phpMyAdmin. Additionally you can use resources to specify a group of servers to add to a phpMyAdmin server.

The reason to use this to manage your phpMyAdmin rather than simply installing a package is that this module allow you to use stored resources to automatically generate a list of servers to use.

With this you don't need to worry about manually adding server entries to phpmyadmin or similar. Instead you can add a server similar to below:

Usage

node 'phpmyadminserver' {
  class { 'phpmyadmin': }
  phpmyadmin::server{ 'default': }

  phpmyadmin::vhost { 'internal.domain.net':
    vhost_enabled => true,
    priority      => '20',
    docroot       => $phpmyadmin::params::doc_path,
    ssl           => true,
    ssl_cert      => 'puppet:///modules/phpmyadmin/sslkey/internal.domain.net.crt',
    ssl_key       => 'puppet:///modules/phpmyadmin/sslkey/internal.domain.net.private.key',
  }

  phpmyadmin::vhost { 'external.domain.org':
    vhost_enabled => true,
    priority      => '30',
    docroot       => $phpmyadmin::params::doc_path,
    ssl           => true,
    ssl_cert      => 'puppet:///modules/phpmyadmin/sslkey/external.domain.org.crt',
    ssl_key       => 'puppet:///modules/phpmyadmin/sslkey/external.domain.org.private.key',
  }
}

node 'mysqlserver' {
  @@phpmyadmin::servernode { "${::ipaddress}":
    server_group => 'default',
  }
}

SSL Certificates

You can specify SSL certificates in two ways, either by using the ssl_cert and ssl_key parameters to point to the source files in Puppet:

phpmyadmin::vhost { 'external.domain.org':
  vhost_enabled => true,
  priority      => '30',
  docroot       => $phpmyadmin::params::doc_path,
  ssl           => true,
  ssl_cert      => 'puppet:///modules/phpmyadmin/sslkey/external.domain.org.crt',
  ssl_key       => 'puppet:///modules/phpmyadmin/sslkey/external.domain.org.private.key',
}

Or, if you have already transferred the certificates to the target node by some other means, by using the ssl_cert_file and ssl_key_file parameters which point to paths on the host machine:

phpmyadmin::vhost { 'external.domain.org':
  vhost_enabled => true,
  priority      => '30',
  docroot       => $phpmyadmin::params::doc_path,
  ssl           => true,
  ssl_cert_file => '/etc/ssl/certs/external.domain.org.crt',
  ssl_key_file  => '/etc/ssl/certs/external.domain.org.private.key',
}

SSL Redirection

Using the ssl_redirect parameter (default: false), you can force redirects for the domain from port 80 to port 443.

License

You are free to fork, modify, burn, break, twist or twine this module. If you do re-use the code, please give me credit for it though.

Contact

Justice London [email protected]

Support

Please log tickets and issues at our Projects site