Puppet Mrepo

Transfer Notice

This module creates and synchronizes rpm based repositories by managing mrepo. It is maintained by Vox Pupuli having kindly been migrated from Puppet Inc.

Synopsis

Install and configure a basic mrepo installation

node default {
  class { 'mrepo': }
}

Override default values and enable redhat network support for use in other classes

class { 'mrepo':
  selinux       => true,
  rhn           => true,
  rhn_username  => 'user',
  rhn_password  => 'pass',
}

Or using Hiera for parameters (same example)

code: class { 'mrepo': }

Hiera: mrepo::selinux: true mrepo::rhn: true mrepo::rhn_username: user mrepo::rhn_password: pass

Mirror multiple centos 5 repositories

mrepo::repo { 'centos5-x86_64':
  ensure    => present,
  update    => 'nightly',
  repotitle => 'CentOS 5.6 64 bit',
  arch      => 'x86_64',
  release   => '5.6',
  urls      => {
    addons      => 'rsync://mirrors.kernel.org/centos/$release/addons/$arch/',
    centosplus  => 'rsync://mirrors.kernel.org/centos/$release/centosplus/$arch/',
    updates     => 'rsync://mirrors.kernel.org/centos/$release/updates/$arch/',
  }
}

mrepo::repo { 'centos5-i386':
  ensure    => present,
  update    => 'nightly',
  repotitle => 'CentOS 5.6 64 bit',
  arch      => 'i386',
  release   => '5.6',
  urls      => {
    addons      => 'rsync://mirrors.kernel.org/centos/$release/addons/$arch/',
    centosplus  => 'rsync://mirrors.kernel.org/centos/$release/centosplus/$arch/',
    updates     => 'rsync://mirrors.kernel.org/centos/$release/updates/$arch/',
  }
}

Mirror multiple rhel channels

mrepo::repo { 'rhel6server-x86_64':
  ensure      => present,
  update      => 'nightly',
  repotitle   => 'Red Hat Enterprise Linux Server $release ($arch)',
  rhn         => true,
  type        => 'rhn',
  arch        => 'x86_64',
  release     => '6',
  typerelease => '6Server',
  iso         => 'rhel-server-6.0-$arch-dvd.iso',
  urls        => {
    updates       => 'rhns:///rhel-$arch-server-$release',
    vt            => 'rhns:///rhel-$arch-server-vt-$release',
    supplementary => 'rhns:///rhel-$arch-server-supplementary-$release',
    fasttrack     => 'rhns:///rhel-$arch-server-fasttrack-$release',
    hts           => 'rhns:///rhel-$arch-server-hts-$release',
    rhn-tools     => 'rhns:///rhn-tools-rhel-$arch-server-$release',
  }
}

Fetch and place an ISO file for the above rhel6server-x86_64 repo

mrepo::iso { 'rhel-server-6.0-$arch-dvd.iso':
  source_url => 'http://some.domain.tld/path/to/isodir',
  repo       => 'rhel6server-x86_64',
}

Usage

If you need to customize the mrepo default settings, include the mrepo class and include the appropriate variables. Else, you should be able to use the mrepo::repo by itself to instantiate repositories.

For class/define specific documentation, view the puppet doc in the given file.

Prerequisites

This module expects the following modules to be available:

• puppetlabs-apache
• puppetlabs-stdlib
• puppetlabs-vcsrepo

It also is configured for a redhat derived system and makes assumptions about the available users and groups. Alternate parameters may override these assumptions.

Mirror data can grow extremely large, so you will want to ensure that src_root is located on a large volume.

If you are planning on using ISOs, you will also need fuse-iso.

Repository URL formatting

You can take advantage of the variables that mrepo itself supports when defining a repository or ISO to mirror. Mrepo uses the following variables:

• $dist is set to the title of the resource
• $arch is set to the arch parameter
• $nick is set to $dist-$arch
• $repo is set to the key of the specific repository
• $release is set to the release parameter

Note that these are variables within mrepo; if you are using them, make sure to surround the string in single quotes so puppet doesn't try to expand them.

So this:

mrepo::repo { 'centos5-x86_64':
  ensure    => present,
  update    => 'nightly',
  repotitle => 'CentOS 5.6 64 bit',
  arch      => 'x86_64',
  release   => '5.6',
  urls      => {
    addons      => 'rsync://mirrors.kernel.org/centos/$release/$repo/$arch/',
    centosplus  => 'rsync://mirrors.kernel.org/centos/$release/$repo/$arch/',
    updates     => 'rsync://mirrors.kernel.org/centos/$release/$repo/$arch/',
  }
}

Is equivalent to this:

mrepo::repo { 'centos5-x86_64':
  ensure    => present,
  update    => 'nightly',
  repotitle => 'CentOS 5.6 64 bit',
  arch      => 'x86_64',
  release   => '5.6',
  urls      => {
    addons      => 'rsync://mirrors.kernel.org/centos/5.6/addons/x86_64/',
    centosplus  => 'rsync://mirrors.kernel.org/centos/5.6/centosplus/x86_64/',
    updates     => 'rsync://mirrors.kernel.org/centos/5.6/updates/x86_64/',
  }
}

Be warned that you can make a repository with the name of 'release'; however, this will overwrite the actual release variable. If you have a repository with a name of release, change the key to something else, and explicitly define the url instead of using a variable.

For full details on how mrepo is used, see the mrepo usage page.

Caveats

Params Pattern

This module was previously using a design where the params class was used as the main class and included in other classes.

It now follows the params pattern, where parameters are set in the params class as default, inherited, then overwritten as needed when calling the base class.

Before:

Using classes

class { 'mrepo::params':
  selinux       => true,
  rhn           => true,
  rhn_username  => 'user',
  rhn_password  => 'pass',
}

After:

class { 'mrepo':
  selinux       => true,
  rhn           => true,
  rhn_username  => 'user',
  rhn_password  => 'pass',
}

SELinux

Default SELinux policy prevents the httpd context from manipulating loopback devices without having an explicit httpd context. This can be corrected by changing the context as a mount option for a regular mount. However, fuseiso does not have the capability to change selinux contexts. If you are planning on mounting ISOs, either do so as root, change the httpd context to permit fuseiso to run using audit2allow, or disable SELinux. If neither of these are viable options, you can locate and mirror an outside repository of the ISO data.

Further clarification of this issue can be found on the repoforge tools list.

Fuse ISO

Fuse iso is not available in any yum repository. You will need to locate an RPM or source file and install it for yourself. In addition, if you are using a non-root user to mount the ISOs, you will need to ensure that the user is in the 'fuse' group.

Changelog

All notable changes to this project will be documented in this file. Each new release typically also includes the latest modulesync defaults. These should not affect the functionality of the module.

v5.0.0 (2024-08-19)

Full Changelog

Breaking changes:

• Drop EoL Scientific Linux #142 (bastelfreak)
• Drop Eol EL6 #140 (bastelfreak)
• Drop Puppet 6 support #127 (bastelfreak)

Implemented enhancements:

• Add EL9 support #141 (bastelfreak)
• puppet/apache: Allow 12.x #134 (zilchms)
• puppetlabs/vcsrepo: Allow 6.x #133 (zilchms)
• puppet/archive: Allow 7.x #132 (zilchms)
• Add Puppet 8 support #129 (bastelfreak)
• puppetlabs/stdlib: Allow 9.x #128 (bastelfreak)
• puppet/archive: allow 5.x #123 (bastelfreak)

Fixed bugs:

• Fix use of selinux fact #112 (alexjfisher)
• Fix datatype of attribute metadata #111 (mrolli)

Merged pull requests:

• Remove legacy top-scope syntax #130 (smortex)
• Allow stdlib 8.0.0 #124 (smortex)
• modulesync 3.0.0 & puppet-lint updates #116 (bastelfreak)
• delete legacy travis directory #113 (bastelfreak)

v4.1.0 (2019-11-18)

Full Changelog

Implemented enhancements:

• Add datatypes & multiple enhancements #107 (genebean)

Fixed bugs:

• Remove SymLinksIfOwnerMatch from template #102 (mrolli)

Merged pull requests:

• allow puppetlabs/vcsrepo 3.x #108 (bastelfreak)
• Allow puppetlabs/apache 5.x, puppetlabs/stdlib 6.x and puppet/archive 4.x #105 (alexjfisher)
• Allow puppetlabs/apache 4.x #104 (mrolli)

v4.0.0 (2019-05-02)

Full Changelog

Breaking changes:

• modulesync 2.5.1 and drop Puppet 4 #100 (bastelfreak)
• Manage iso directory within mrepo::iso (requires puppet/archive, drop puppet/staging) #97 (mrolli)

Merged pull requests:

• modulesync 2.2.0 and allow puppet 6.x #96 (bastelfreak)

v3.1.1 (2018-09-07)

Full Changelog

Merged pull requests:

• allow puppetlabs/stdlib 5.x #93 (bastelfreak)
• allow puppet/staging 3.x & puppetlabs/apache 3.x #91 (bastelfreak)
• Remove docker nodesets #87 (bastelfreak)
• bump puppet to latest supported version 4.10.0 #83 (bastelfreak)

v3.1.0 (2017-11-27)

Full Changelog

Merged pull requests:

• Update metadata dependencies for puppet5 support #78 (alexjfisher)

v3.0.0 (2017-10-11)

Full Changelog

Breaking changes:

• BREAKING: Drop puppet 3 support. Replace validate_* with datatypes #75 (bastelfreak)

Closed issues:

• Module will not install #72

Merged pull requests:

• Fix github license detection #73 (alexjfisher)
• enable mrepo service by default #68 (PascalBourdier)
• Refactors UUID exec to use fqdn_uuid function #60 (petems)

v2.1.0 (2017-01-13)

Full Changelog

Closed issues:

• selinux context incorrect for centos 7.2.1151 #51
• Major version bump to remove older parameters #43
• Refactor to use param pattern #42

Merged pull requests:

• modulesync 0.16.7 #64 (bastelfreak)
• Set min version_requirement for Puppet + deps #63 (juniorsysadmin)
• modulesync 0.16.6 #62 (bastelfreak)
• modulesync 0.16.4 #61 (bastelfreak)
• Refactor to use the params pattern #56 (petems)
• modulesync 0.16.3 #55 (bastelfreak)
• modulesync 0.15.0 #54 (bastelfreak)
• Update based on voxpupuli/modulesync_config 0.14.1 #53 (dhoppe)
• Parameterized the selinux context: https://github.com/voxpupuli/puppe… #52 (mlosapio)
• modulesync 0.13.0 #50 (bbriggs)
• Modulesync 0.12.7 #49 (alexjfisher)
• Fix Puppetforge badge #48 (alexjfisher)

v2.0.1 (2016-09-16)

Full Changelog

Merged pull requests:

• Release 2.0.1 #47 (alexjfisher)
• Add travis secret #46 (alexjfisher)

v2.0.0 (2016-09-16)

Full Changelog

Closed issues:

• master not working since last commit #13

Merged pull requests:

• Release 2.0.0 #45 (alexjfisher)
• Add new rhnget options #44 (alexjfisher)
• Add the most basic of rspec-puppet tests #41 (alexjfisher)
• Modulesync #39 (alexjfisher)
• Update README and metadata.json after VP migration #38 (alexjfisher)
• Add mailfrom and smtpserver parameters #37 (ghost)

1.2.1 (2016-04-26)

Full Changelog

Merged pull requests:

• Prep for 1.2.1 release #32 (HelenCampbell)
• Shorten summary #31 (petems)
• (maint) module does not unmount ISOs #30 (shermdog)
• (MODULES-2950) Remove non-root user cron jobs #29 (shermdog)

1.2.0 (2015-08-12)

Full Changelog

Merged pull requests:

• Release 1.2.0 #27 (hunner)
• only include the ip parameter in the apache vhost if $ip_based is true #26 (ghost)
• Explicitly scope $mrepo::params::use_selinux #25 (smarlow)
• Fix syntax error #24 (arioch)
• Add ip-based vhost #23 (arioch)
• fix smart quote #22 (underscorgan)
• Add metadata summary in Modulefile per FM-1523 #20 (lrnrthr)
• RedHat Network fixes and documentation #18 (esalberg)
• fix repo variable; 'name' was confused. #17 (easescript)
• No guarantee that 'mrepo::repos' will be included #15 (hakamadare)
• Enable specifying port and priority for vhost #14 (hakamadare)
• Mrepo cmd params #12 (zipkid)
• Mrepo reorg 06 #11 (zipkid)
• Fix two minor items which make module unusable by default #8 (rhysrhaven)

1.1.1 (2013-05-09)

Full Changelog

1.1.0 (2012-10-03)

Full Changelog

Merged pull requests:

• Release of 1.1.0 #7 (adrienthebo)

1.0.0 (2012-08-28)

Full Changelog

v0.1.3 (2012-02-12)

Full Changelog

Merged pull requests:

• Update Modulefile dependency information #4 (adrienthebo)

v0.1.2 (2011-12-14)

Full Changelog

v0.1.1 (2011-09-16)

Full Changelog

Merged pull requests:

• Fixes typos in the Modulefile #3 (ody)

v0.1.0 (2011-09-16)

Full Changelog

Merged pull requests:

• First release of mrepo #2 (adrienthebo)

0.1.0 (2011-09-15)

Full Changelog

* This Changelog was automatically generated by github_changelog_generator