reposado

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with reposado
   • What reposado affects
   • Setup requirements
   • Beginning with reposado
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

Overview

Installs Greg Neagle's Reposado (https://github.com/wdas/reposado) on an Ubuntu server. Reposado is an open-source OS X Software Update Server.

Module Description

This module sets up syncing of OS X updates through reposado, and, optionally, an Apache Vhost to allow for replication of those updates.

Setup

What reposado affects

• Make sure base_dir is large enough to be able to hold all updates (my server is currently holding 232 Gb worth of updates).
• reposado::apache_vhost includes puppetlabs/apache.

Beginning with reposado

Minimal usage:

class { 'reposado': }

If you wish to enable the Apache Vhost, you need to include the reposado::apache_vhost class:

class { 'reposado::apache_vhost': }

Usage

Example configuration through hiera:

reposado::base_dir: '/var/www/reposado'
reposado::git_ensure: 'latest'
reposado::apple_catalogs:
  - '10.10'
  - '10.11'

reposado::apache_vhost::document_root: "%{hiera('reposado::base_dir')}/html"
reposado::apache_vhost::apple_catalogs:
  - '10.10'
  - '10.11'

Reference

The module uses puppetlabs/vcsrepo to clone https://github.com/wdas/reposado.

Parameters

The reposado class takes the following:

user

The user that owns the reposado files, both installed and downloaded, and runs the cron job. Default: 'reposado'.

group

All reposado files belong to this group. Default: 'reposado'.

base_dir

The directory that holds all reposado related files and directories. The git repository is cloned into 'base_dir/reposado', Reposado's metadata is in 'base_dir/metadata', and its document root is 'base_dir/html'. Default: '/srv/reposado'.

git_source

The git repository to clone reposado from. Default: 'https://github.com/wdas/reposado'

git_ensure

How to clone the git repository. 'latest' keeps up with the latest revision, 'present' clones the repository, but does not keep up with the latest revision. Default: 'present'.

git_revision

Which revision to clone from the git repository. Default: undef (i.e. the HEAD revision).

cronjob_time

The time to run the sync cron job. Format: '[HH, MM]'. Default: '[0, 30]'.

cronjob_command

The cron job command to run. Default: '/srv/reposado/reposado/code/repo_sync'. If you would like to remove deprecated updates by default, set this to 'base_dir/reposado/code/repo_sync && base_dir/reposado/code/repoutil --purge-product all-deprecated', for example.

server_name

Name of the server. Default: 'hostname.domain'.

manage_user

Whether puppet should manage user. Default: true.

manage_group

Whether puppet should manage group. Default: true.

manage_git

Whether puppet should manage the 'git' package. Default: false.

manage_cronjob

Whether puppet should manage the sync cron job. Default: true.

apple_catalogs

An array of operating system names, that specifies the Apple SUS catalog URLs to replicate. If left empty, this module follows the Reposado default, and replicate all available updates. The operaying system names can be either the OS X version (e.g. '10.8', '10.10'), or its name (e.g. 'mountainlion', 'yosemite'). Names are lowercase, and without separating blanks, if more than one word. Default: '[]'.

additional_curl_options

Value of the 'AdditionalCurlOptions' key in Reposado's Preferences.plist configuration file. Default: '[]'.

preferred_localizations

Value of the 'PreferredLocalizations' key in Reposado's Preferences.plist configuration file. Default: '[]'.

curl_path

Value of the 'CurlPath' key in Reposado's Preferences.plist configuration file. Default: undef.

repo_sync_log_file

Value of the 'RepoSyncLogFile' key in Reposado's Preferences.plist configuration file. Default: undef.

The reposado::apache_vhost takes the following parameters:

user

The user that owns the document root. Default: 'reposado'.

group

All files in the document root belong to this group. Default: 'reposado'.

document_root

Path to the document root. Default: '/src/reposado/html'.

server_name

Name of the server. Default: 'hostname.domain'.

apple_catalogs

An array of operating system names, that specifies the Apple SUS catalog URLs to replicate. If left empty, this module follows the Reposado default, and replicate all available updates. The operaying system names can be either the OS X version (e.g. '10.8', '10.10'), or its name (e.g. 'mountainlion', 'yosemite'). Names are lowercase, and without separating blanks, if more than one word. Default: '[]'.

Limitations

Currently tested on Ubuntu 14.04 only.

Release Notes

First release, no fancy options yet.