Forge Home

apaxage

Sets up an Apaxy themed package repository

10,856 downloads

10,661 latest version

3.5 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.1.1 (latest)
  • 0.1.0
released Dec 18th 2013

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'Aethylred-apaxage', '0.1.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add Aethylred-apaxage
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install Aethylred-apaxage --version 0.1.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

Aethylred/apaxage — version 0.1.1 Dec 18th 2013

Apaxage

The Apaxage puppet module creates an Apaxy themed package repository for both yum and apt.

Usage

The minimum installation required to get an apaxage yum repository working on the default document root of a web server:

include apaxy
class {'apaxage':
  manage_vhost  => true,
}
apaxage::repo::yum{'centos':}

Resources and Classes

The apaxage class

The apaxage class prepares the web server to host an apaxage themed package repository. The class can set up apaxy and createrepo underneath it's document root. The class does not manage the installation of Apache, but it can use apaxy to create an apache::vhost to manage the virtual host configuration file for the apaxage web site. Check the Apaxy Module documentation on creating custom vhost configurations.

Optionally, using apaxage to install apaxy can be disabled to allow for customised installations.

The apaxage class does not deploy any assets to the apaxage site (such as images or CSS stylesheets) outside what's deployed by apaxy. If custom images or other assets are required for the HTML fragments passed to the apaxage class, they will need to be deployed by other means (e.g. using file resources, or deploy a custom fork of apaxy).

Parameters

  • docroot: Sets the path to the document root where apaxage will be set up. Defaults to the default document root for the Puppetlabs Apache module which is OS and distribution depenent.
  • header_fragment: Inserts the string as a HTML fragment into the Apaxy header. Does nothing if the manage_apaxy parameter is not true.
  • footer_fragment: Inserts the string as a HTML fragment into the Apaxy footer. Does nothing if the manage_apaxy parameter is not true.
  • manage_vhost: If set to true, apaxage will set an apache::vhost resource to manage the Apaxage site. The default setting is true. If this is set to false the site vhost will have to be managed separately.
  • manage_apaxy: If set to true, apaxage will set up Apaxy on the document root with the Apaxage module. The default setting is true. If this is set to false then Apaxy will have to be managed separately.

The apaxage::repo::yum resource

This resource defines a yum repository as a sub directory of the apaxage site deployed by the apaxage class. It currently uses the createrepo module to create and maintain the repository.

Parameters

  • repository_dir: This specifies the directory to be used for the repository, it must be a subdirectory within the directory tree underneath an apaxage site defined by the apaxage class. The default is to create a subdirectory under the apaxage document root using the apaxage::repo::yum resource's name.
  • repo_cache_root_dir: Defines the directory where the yum repository data will be cached. The default is to use a subdirectory under /var/cache/apaxage.

To Do

  • Make apt repositories work (which may require somethign to handle GPG/PGP keys)
  • Consider merging the repo management libraries into apaxage

Dependencies

Attribution

The Apaxage module was written by Aaron Hicks 2013

puppet-blank

This module is derived from the puppet-blank module by Aaron Hicks (aethylred@gmail.com)

This module has been developed for the use with Open Source Puppet (Apache 2.0 license) for automating server & service deployment.

rspec-puppet-augeas

This module includes the Travis configuration to use rspec-puppet-augeas to test and verify changes made to files using the augeas resource available in Puppet. Check the rspec-puppet-augeas documentation for usage.

This will require a copy of the original input files to spec/fixtures/augeas using the same filesystem layout that the resource expects:

$ tree spec/fixtures/augeas/
spec/fixtures/augeas/
`-- etc
    `-- ssh
        `-- sshd_config

Gnu General Public License

GPL3

This file is part of the apaxage Puppet module.

The apaxage Puppet module is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

The apaxage Puppet module is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with the apaxage Puppet module. If not, see http://www.gnu.org/licenses/.