Version information
released Sep 27th 2013
Start using this module
Add this module to your Puppetfile:
mod 'hubspot-nexus', '1.0.1'
Learn more about managing modules with a PuppetfileDocumentation
hubspot/nexus — version 1.0.1 Sep 27th 2013
Sonatype Nexus Puppet module
Install and configure Sonatype Nexus.
Requires
- maestrodev/wget
- puppetlabs/stdlib
Usage
The following is a basic role class for building a nexus host. Adjust accordingly as needed.
NOTE: you must pass version to Class['nexus']. This is needed for the download link and determining the name of the nexus directory.
class role_nexus_server {
# puppetlabs-java
# NOTE: Nexus requires
class{ '::java':
distribution => 'java-1.7.0-openjdk'
}
group{ 'nexus':
ensure => present,
system => true
}
user{ 'nexus':
ensure => present,
comment => 'Nexus user',
gid => 'nexus',
home => '/srv/nexus',
shell => '/bin/bash', # unfortunately required to start application via script.
system => true,
require => Group['nexus']
}
class{ '::nexus':
version => '2.6.2',
nexus_user => 'nexus',
nexus_group => 'nexus'
nexus_root => '/srv', # All directories and files will be relative to this
}
Class['::java'] ->
Group[$nexus_group] ->
User[$nexus_user] ->
Class['::nexus'] ->
Nginx proxy
The following is setup for using the jfryman/puppet-nginx module. Nexus does not adequately support HTTP and HTTPS simultaneously. Below forces all connections to HTTPS. Be sure to login after the app is up and head to Administration -> Server. Change the base URL to "https" and check "Force Base URL". The application will be available at:
https://${::fqdn}/nexus/
class{ '::nginx': }
file { '/etc/nginx/conf.d/default.conf':
ensure => absent,
require => Class['::nginx::package'],
notify => Class['::nginx::service']
}
nginx::resource::vhost { 'nexus':
ensure => present,
www_root => '/usr/share/nginx/html',
rewrite_to_https => true,
ssl => true,
ssl_cert => '/etc/pki/tls/certs/server.crt',
ssl_key => '/etc/pki/tls/private/server.key',
}
nginx::resource::location { 'nexus':
ensure => present,
location => '/nexus',
vhost => 'nexus',
proxy => "http://${nexus_host}:${nexus_port}/nexus",
ssl => true,
}
TODO
- Find a way to not require a version to be passed to Class['nexus']
Authors
- Tom McLaughlin tmclaughlin@hubspot.com
Copyright
Hubspot, Inc.
Dependencies
- puppetlabs/stdlib (>=0.0.0)
- maestrodev/wget (>=1.0.0)
iThe MIT License (MIT) Copyright (c) 2013 HubSpot, Inc. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.