cockpit cookbook

This cookbook installs and configures the Cockpit server administration interface.

Scope

Cockpit is installed as a package from the Red Hat Extras repository. Attributes can be used to configure the Cockpit service. Initially supports Red Hat Enterprise Linux 7.1+, with CentOS support coming soon.

The cookbook configures SELinux policies and firewalld.

The goal is to keep the cookbook and code simple and minimal.

Requirements

• Tested to work with Chef 12.7.x or higher
• Requires a system with a valid and active Red Hat Subscription and access to Red Hat repositories from redhat.com or via Satellite / Katello.

Simple Cookbooks

This is intended to be the first of a series of simple cookbooks for RHEL 7.x / CentOS 7.x. The idea is to have simple reusable code, minimal dependencies and stick to best practices for RHEL 7.x.

• Always use RPM installs, from official repos where possible
• Include options to configure SELinux, Firewalld, SystemD services
• Common dependencies to support configuration of yum repos, Red Hat subscriptions, manage config files with Augeas, firewalld, and SELinux policies.

Usage

Place a dependency on the cockpit cookbook in your
cookbook's metadata.rb:

depends 'cockpit', '~> 0.3.0'

Or include the default recipe in your run list as 'recipe[cockpit]'.

This cookbook depends on the firewalld cookbook, the augeas cookbook and the Red Hat Subscription Manager cookbook.

Attributes

These attributes can be used to customize the Cockpit install.

• node['cockpit']['port'] - Modify the listen port for Cockpit.
  Defaults to 9090.
• node['cockpit']['logintitle'] - Set the LoginTitle attribute in cockpit.conf, which is shown on the login page.
  
• node['cockpit']['features']['pcp'] - Install the PCP framework to allow Cockpit to store system metrics.
• node['cockpit']['features']['kubernetes'] - Install the Kubernetes dashboard. At the moment this uses the CentOS 7 Extras repo to get the cockpit-kubernetes package.

Testing

Integration tests are written in (BATS)[https://github.com/sstephenson/bats]

Contributing

1. Fork it ( https://github.com/colourmeamused/cockpit-cookbook )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request