OpenStack Horizon Puppet Module
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
OpenDev Sysadmins f823bd32f7 OpenDev Migration Patch 20 hours ago
doc Follow the new PTI for document build 1 year ago
manifests Use validate_legacy 1 month ago
releasenotes Update master for stable/stein 4 weeks ago
spec Inherit pyvers from openstacklib::defaults 3 months ago
templates Merge "No dashboards in HORIZON_CONFIG" 4 days ago
.gitignore Dissuade .gitignore references to personal tools 6 months ago
.gitreview OpenDev Migration Patch 20 hours ago
.sync.yml Initial msync run for all Puppet OpenStack modules 3 years ago
.zuul.yaml Add puppet-horizon-tripleo-standalone job 6 months ago Release 8.0.0 3 years ago
Gemfile Load puppet-openstack_spec_helper locally during tests 1 year ago
LICENSE Update LICENSE 1 year ago Add Beaker-Rspec to the table of contents 3 days ago
Rakefile Use puppet-openstack_spec_helper for Rakefile & spec_helper_acceptance 3 years ago
bindep.txt modulesync: sync and add nodepool-bionic for beaker 9 months ago
metadata.json Bump version for the start of Train 3 weeks ago
setup.cfg Change openstack-dev to openstack-discuss 4 months ago Add basic structure for ReNo 3 years ago
tox.ini Update min tox version to 2.0 6 months ago

Team and repository tags

Team and repository tags


Table of Contents

  1. Overview - What is the horizon module?
  2. Module Description - What does the module do?
  3. Setup - The basics of getting started with horizon
  4. Implementation - An under-the-hood peek at what the module is doing
  5. Limitations - OS compatibility, etc.
  6. Beaker-Rspec - Beaker-rspec tests for the project
  7. Development - Guide for contributing to the module
  8. Release Notes - Release notes for the project
  9. Contributors - Those with commits
  10. Repository - The project source code repository


The horizon module is a part of OpenStack, an effort by the OpenStack infrastructure team to provide continuous integration testing and code review for OpenStack and OpenStack community projects as part of the core software. The module its self is used to flexibly configure and manage the dashboard service for OpenStack.

Module Description

The horizon module is a thorough attempt to make Puppet capable of managing the entirety of horizon. Horizon is a fairly classic django application, which results in a fairly simply Puppet module.

This module is tested in combination with other modules needed to build and leverage an entire OpenStack software stack.


What the horizon module affects

  • Horizon, the dashboard service for OpenStack.

Installing horizon

puppet module install openstack/horizon

Beginning with horizon

To utilize the horizon module’s functionality you will need to declare multiple resources but you’ll find that doing so is much less complicated than the other OpenStack component modules. We recommend you consult and understand the core openstack documentation.

Define a horizon dashboard

class { 'memcached':
  listen_ip => '',
  tcp_port  => '11211',
  udp_port  => '11211',

class { '::horizon':
  cache_server_ip       => '',
  cache_server_port     => '11211',
  secret_key            => '12345',
  django_debug          => 'True',
  api_result_limit      => '2000',



Horizon is a simple module using the combination of a package, template, and the file_line type. Most all the configuration lives inside the included local_settings template and the file_line type is for selectively inserting needed lines into configuration files that aren’t explicitly managed by the horizon module.


  • Only supports Apache using mod_wsgi.


This module has beaker-rspec tests

To run:

bundle install
bundle exec rspec spec/acceptance


Developer documentation for the entire puppet-openstack project.

Release Notes