5.1 KiB
Description
Installs the OpenStack Dashboard service Horizon as part of the OpenStack reference deployment Chef for OpenStack. The http://github.com/mattray/chef-openstack-repo contains documentation for using this cookbook in the context of a full OpenStack deployment. Horizon is currently installed from packages.
Requirements
- Chef 0.10.0 or higher required (for Chef environment use).
Cookbooks
The following cookbooks are dependencies:
- apache2
- openstack-common
Usage
server
Sets up the Horizon dashboard within an Apache mod_wsgi container.
"run_list": [
"recipe[openstack-dashboard::server]"
]
Attributes
openstack["dashboard"]["db"]["username"]- username for horizon database accessopenstack["dashboard"]["server_hostname"]- sets the ServerName in the Apache config.openstack["dashboard"]["use_ssl"]- toggle for using ssl with dashboard (default true)openstack["dashboard"]["ssl"]["dir"]- directory where ssl certs are stored on this systemopenstack["dashboard"]["ssl"]["cert"]- name to use when creating the ssl certificateopenstack["dashboard"]["ssl"]["key"]- name to use when creating the ssl keyopenstack["dashboard"]["dash_path"]- base path for dashboard files (document root)openstack["dashboard"]["wsgi_path"]- path for wsgi diropenstack["dashboard"]["wsgi_socket_prefix"]- Location that will override the standard Apache runtime directoryopenstack["dashboard"]["ssl_offload"]- Set SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTOCOL', 'https') flag for offloading SSLopenstack["dashboard"]["plugins"]- Array of plugins to include via INSTALED_APPSopenstack["dashboard"]["simple_ip_management"]- Boolean to enable or disable simplified floating IP address management TODO: Add DB2 support on other platformsopenstack["dashboard"]["platform"]["db2_python_packages"]- Array of DB2 python packages, only available on redhat platformopenstack['openstack']['dashboard']['http_port']- Port that httpd should listen on. Default is 80.openstack['openstack']['dashboard']['https_port']- Port that httpd should listen on for using ssl. Default is 443.
Testing
Please refer to the TESTING.md for instructions for testing the cookbook.
Berkshelf
Berks will resolve version requirements and dependencies on first run and
store these in Berksfile.lock. If new cookbooks become available you can run
berks update to update the references in Berksfile.lock. Berksfile.lock will
be included in stable branches to provide a known good set of dependencies.
Berksfile.lock will not be included in development branches to encourage
development against the latest cookbooks.
License and Author
| Author | Justin Shepherd (justin.shepherd@rackspace.com) |
| Author | Jason Cannavale (jason.cannavale@rackspace.com) |
| Author | Ron Pedde (ron.pedde@rackspace.com) |
| Author | Joseph Breu (joseph.breu@rackspace.com) |
| Author | William Kelly (william.kelly@rackspace.com) |
| Author | Darren Birkett (darren.birkett@rackspace.co.uk) |
| Author | Evan Callicoat (evan.callicoat@rackspace.com) |
| Author | Jay Pipes (jaypipes@att.com) |
| Author | John Dewey (jdewey@att.com) |
| Author | Matt Ray (matt@opscode.com) |
| Author | Sean Gallagher (sean.gallagher@att.com) |
| Author | Chen Zhiwei (zhiwchen@cn.ibm.com) |
| Author | Jian Hua Geng (gengjh@cn.ibm.com) |
| Author | Ionut Artarisi (iartarisi@suse.cz) |
| Author | Eric Zhou (iartarisi@suse.cz) |
| Copyright | Copyright (c) 2012, Rackspace US, Inc. |
| Copyright | Copyright (c) 2012-2013, AT&T Services, Inc. |
| Copyright | Copyright (c) 2013, Opscode, Inc. |
| Copyright | Copyright (c) 2013-2014, IBM, Corp. |
| Copyright | Copyright (c) 2013-2014, SUSE Linux GmbH. |
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.