firefox-browser-formula

A SaltStack formula designed to facilitate the installation of the Firefox browser onto select host-types. As of this writing, supported hosts types only include RPM-based Linux distributions (RHEL and clones/work-alikes) and Windows-based systems (only specifically exercised on Server 2022 with CI-testing of Server 2019 and Server 2022).

Table of Contents

• General notes
• Contributing to this repo
• Special notes
• Available states

General notes

See the full SaltStack-Formulas’ Documentation.

This formula is intended to be used as part of a larger, SaltStack-based configuration-automation framework (such as Watchmaker).

If you need (non-default) configuration, please refer to:

• how to configure the formula with map.jinja
• the pillar.example file
• the Special notes section

Contributing to this repo

Commit messages

Commit message formatting is significant!!

Please see How to contribute for more details.

Special notes

None

Available states

• firefox
• firefox.package
• firefox.config
• firefox.service
• firefox.clean
• firefox.service.clean
• firefox.config.clean
• firefox.package.clean
• firefox.subcomponent
• firefox.subcomponent.config
• firefox.subcomponent.config.clean

firefox

Meta-state (This is a state that includes other states).

This installs the firefox package, manages the firefox configuration file and then starts the associated firefox service.

firefox.package

This state will install the firefox package only.

firefox.config

This state will configure the firefox service and has a dependency on firefox.install via include list.

NOTE: This formula currently does nothing when this state is called.

firefox.service

This state would start the firefox service — and has a dependency on firefox.config via include list — but the Firefox browser requires no associated services be started. As such, this formula does nothing when this state is called.

firefox.clean

Meta-state (This is a state that includes other states).

This state will undo everything performed in the firefox meta-state in reverse order. In this case, the meta-state only removes the Firefox package and any packages that were also installed via dependency-tracking mechanisms

firefox.service.clean

This state stops and disables any service the formula was previously used to start/enable

firefox.config.clean

This state will remove the configuration of the firefox service and has a dependency on firefox.service.clean via include list.

firefox.package.clean

This state will remove any firefox package(s) and dependencies previously install by this formula. This state has a depency on firefox.config.clean via include list.

firefox.subcomponent

Meta-state (This is a state that includes other states).

This state would install subcomponent configuration files before configuring and starting the Firefox service, however, the Firefox browser does not rely on any system services to function.

firefox.subcomponent.config

This state would configure Firefox subcomponent(s), however, the Firefox browser does not have any subcomponents dependencies. This state has a dependency on firefox.config via include list.

firefox.subcomponent.config.clean

This state will remove the configuration of any Firefox subcomponents previously installed via this formula and reload the Firefox service by a dependency on firefox.service.running via include list and watch_in requisite.