Version information
This version is compatible with:
- Puppet Enterprise 2023.8.x, 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x
- Puppet >= 7.0.0 < 9.0.0
- , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'simp-mozilla', '5.6.0'
Learn more about managing modules with a PuppetfileDocumentation
Table of Contents
- Overview
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with mozilla
- Development - Guide for contributing to the module
Overview
This module provides classes to install Mozilla Firefox and Mozilla Thunderbird.
This is a SIMP module
This module is a component of the System Integrity Management Platform, a compliance-management framework built on Puppet.
If you find any issues, they can be submitted to our JIRA.
Please read our Contribution Guide.
This module is optimally designed for use within a larger SIMP ecosystem, but it can be used independently:
- When included within the SIMP ecosystem, security compliance settings will be managed from the Puppet server.
- If used independently, all SIMP-managed security subsystems are disabled by default and must be explicitly opted into by administrators. Please review the
client_nets
and$enable_*
parameters inmanifests/init.pp
for details.
Module Description
This module will only install Mozilla Firefox and Mozilla Thunderbird, depending on the class included.
See REFERENCE.md for API details.
Setup
What mozilla affects
The firefox
and thunderbird
packages.
Beginning with mozilla
To install firefox
:
include 'mozilla::firefox'
To install thunderbird
:
include 'mozilla::thunderbird'
init.pp
contains no code and including it will do nothing.
Development
Please read our Contribution Guide.
Acceptance tests
To run the system tests, you need Vagrant installed. Then, run:
bundle exec rake acceptance
Some environment variables may be useful:
BEAKER_debug=true
BEAKER_provision=no
BEAKER_destroy=no
BEAKER_use_fixtures_dir_for_modules=yes
BEAKER_debug
: show the commands being run on the STU and their output.BEAKER_destroy=no
: prevent the machine destruction after the tests finish so you can inspect the state.BEAKER_provision=no
: prevent the machine from being recreated. This can save a lot of time while you're writing the tests.BEAKER_use_fixtures_dir_for_modules=yes
: cause all module dependencies to be loaded from thespec/fixtures/modules
directory, based on the contents of.fixtures.yml
. The contents of this directory are usually populated bybundle exec rake spec_prep
. This can be used to run acceptance tests to run on isolated networks.
Reference
Table of Contents
Classes
mozilla
mozilla::firefox
: A class to install mozilla firefoxmozilla::thunderbird
: Install mozilla thunderbird
Classes
mozilla
The mozilla class.
mozilla::firefox
A class to install mozilla firefox
Parameters
The following parameters are available in the mozilla::firefox
class:
package_ensure
Data type: String
The ensure status of the firefox package
Default value: simplib::lookup('simp_options::package_ensure', { 'default_value' => 'installed' })
mozilla::thunderbird
Install mozilla thunderbird
Parameters
The following parameters are available in the mozilla::thunderbird
class:
package_ensure
Data type: String
The ensure status of the thunderbird package
Default value: simplib::lookup('simp_options::package_ensure', { 'default_value' => 'installed' })
install_options
Data type: Optional[String]
Options to pass the package install.
Default value: undef
- Wed Oct 11 2023 Steven Pritchard steve@sicura.us - 5.6.0
- [puppetsync] Updates for Puppet 8
- These updates may include the following:
- Update Gemfile
- Add support for Puppet 8
- Drop support for Puppet 6
- Update module dependencies
- These updates may include the following:
- Wed Aug 23 2023 Steven Pritchard steve@sicura.us - 5.5.0
- Add AlmaLinux 8 support
- Mon Jul 17 2023 Chris Tessmer chris.tessmer@onyxpoint.com - 5.4.0
- Add RockyLinux 8 support
- Tue Jul 06 2021 Jeanne Greulich jeanne.greulich@onyxpoint.com - 5.3.0
- Add install_options param to mozilla::thunderbird for the package install. The install_options are undef except for OEL7 where they enable the repo, ol7_optional_latest, which contains the thunderbird rpm.
- Also updated test nodesets to the latest configuration.
- Tue Jun 15 2021 Chris Tessmer chris.tessmer@onyxpoint.com - 5.3.0
- Removed support for Puppet 5
- Ensured support for Puppet 7 in requirements and stdlib
- Fri Dec 18 2020 Chris Tessmer chris.tessmer@onyxpoint.com - 5.2.1
- Removed EL6 support
- Thu Dec 19 2019 Trevor Vaughan tvaughan@onyxpoint.com - 5.2.0-0
- Add EL8 support
- Fri Aug 02 2019 Robert Vincent pillarsdotnet@gmail.com - 5.2.0-0
- Remove Puppet 4 support
- Add Puppet 6 support
- Add puppetlabs-stdlib 6 support
- Thu Mar 07 2019 Liz Nemsick lnemsick.simp@gmail.com - 5.1.1-0
- Update the upper bound of stdlib to < 6.0.0
- Update a URL in the README.md
- Mon Oct 29 2018 Liz Nemsick lnemsick.simp@gmail.com - 5.1.0-0
- Update contribution guide URL in README.md
- Update to onyxpoint OEL boxes in acceptance tests
- Fri Oct 12 2018 Nick Miller nick.miller@onyxpoint.com - 5.1.0-0
- Added $package_ensure parameters to mozilla::firefox and mozilla::thunderbird
- Changed the package from 'latest' to 'installed'
- Each package ensure parameter will also respect
simp_options::package_ensure
- Removed the architecture qualifier from the name of each package resource
- Fri Mar 23 2018 Trevor Vaughan tvaughan@onyxpoint.com - 5.1.0-0
- Add support for Puppet 5 and OEL
- Thu Jul 06 2017 Liz Nemsick lnemsick.simp@gmail.com - 5.0.1-0
- Confine puppet version in metadata.json
- Wed Nov 23 2016 Jeanne Greulich jgreulich@onyxpoint.com - 5.0.0-0
- Bump the major version for SIMP 6.0
- Mon Nov 21 2016 Chris Tessmer chris.tessmer@onyxpoint.com - 4.1.3-0
- Remove compliance map and general housekeeping
- Thu Jul 07 2016 Nick Miller nick.miller@onyxpoint.com - 4.1.1-0
- Updated README and updated to new packaging format
- Fri Jan 16 2015 Trevor Vaughan tvaughan@onyxpoint.com - 4.1.0-1
- Changed puppet-server requirement to puppet
- Sun Mar 02 2014 Kendall Moore kmoore@keywcorp.com - 4.1.0-0
- Refactored manifests for hiera and puppet 3 compatibility.
- Added rspec tests for test coverage.
- Fri Nov 30 2012 Maintenance 2.0.0-4
- Created a Cucumber test to ensure that firefox installs correctly and is at the latest version when including mozzila in the puppet server manifest.
- Wed Apr 11 2012 Maintenance 2.0.0-3
- Moved mit-tests to /usr/share/simp...
- Updated pp files to better meet Puppet's recommended style guide.
- Fri Mar 02 2012 Maintenance 2.0.0-2
- Improved test stubs.
- Mon Dec 26 2011 Maintenance 2.0.0-1
- Updated the spec file to not require a separate file list.
- Tue Jan 11 2011 Maintenance 2.0.0-0
- Refactored for SIMP-2.0.0-alpha release
- Tue Oct 26 2010 Maintenance - 1-1
- Converting all spec files to check for directories prior to copy.
- Fri May 21 2010 Maintenance 1.0-0
- Code refactor and Doc update.
- Tue Apr 27 2010 Maintenance 0.1-1
- Modified to install the correct architecture package to ensure that proper yum dependencies are followed.
- Thu Oct 1 2009 Maintenance 0.1-0
- Initial Release
- Just installs firefox for now, nothing fancy.
Dependencies
- simp/simplib (>= 4.9.0 < 5.0.0)
- puppetlabs/stdlib (>= 8.0.0 < 10.0.0)
pupmod-simp-mozilla - A Puppet Module for managing Mozilla products -- Per Section 105 of the Copyright Act of 1976, these works are not entitled to domestic copyright protection under US Federal law. The US Government retains the right to pursue copyright protections outside of the United States. The United States Government has unlimited rights in this software and all derivatives thereof, pursuant to the contracts under which it was developed and the License under which it falls. --- Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.