Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
app
 
 
doc
 
 
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

foreman_custom_banner

A Foreman plugin which provides a configurable, custom banner for the Foreman UI.

The purpose of this plugin is to provide a simple way to distinguish multiple installations of Foreman, e.g. a production vs. a development installation. As well as the possibility of a link to a "help" or "quick start" page.

Installation

  • Build and install the rubygem
  • Add install/foreman_custom_banner.rb into Foreman's bundler.d directory. E.g. in the packaged Foreman installation, /usr/share/foreman/bundler.d
  • Restart the webserver hosting the Foreman application

Configuration

You configure the custom banner from the Settings page on the Custom Banner tab:

custom_banner_settings_preview

With a default installation the custom banner would look like this:

default_custom_banner_preview

If you only wanted to have a banner text simply remove the custom_banner_url and custom_banner_url_text values:

text_custom\banner_preview

If you only wanted to have a banner url simply remove the custom_banner_text value:

url_custom_banner_preview

You can alter the style of the custom banner by changing the values for the custom_banner_style field. This field will accept any CSS style configuration

Building the Package

YMMV, but this should work okay if you have the right build dependencies installed:

$ gem build foreman_custom_banner.gemspec
$ mv *.gem $(rpm --eval '%{_sourcedir}')
$ rpmbuild -ba foreman_custom_banner.spec --define 'scl tfm'

About

A Foreman plugin which adds support for a custom, configurable header banner

Resources

License

You can’t perform that action at this time.