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.
ZhongShengping b1f80ac4c6 Prepare Train M4 2 weeks ago
doc Bump the openstackdocstheme extension to 1.20 1 month ago
manifests Merge "Prefix memcached_servers IPv6 address with `inet6:`" 3 months ago
releasenotes Bump the openstackdocstheme extension to 1.20 1 month ago
spec Merge "Prefix memcached_servers IPv6 address with `inet6:`" 3 months ago
templates Merge "Prefix memcached_servers IPv6 address with `inet6:`" 3 months ago
.gitignore Dissuade .gitignore references to personal tools 11 months ago
.gitreview OpenDev Migration Patch 5 months ago
.sync.yml Initial msync run for all Puppet OpenStack modules 4 years ago
.zuul.yaml Port puppet-horizon-tripleo-standalone to os_tempest 4 months ago Release 8.0.0 3 years ago
Gemfile Move to opendev 5 months ago
LICENSE Update LICENSE 1 year ago Fix Repository 5 months 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 1 year ago
metadata.json Prepare Train M4 2 weeks ago
setup.cfg Change openstack-dev to openstack-discuss 9 months ago Add basic structure for ReNo 3 years ago
tox.ini Move to opendev 5 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