41d142d309
Also upgrade gems: - berkshelf, ~> 2.0.10 - chefspec, ~> 3.0.2 - foodcritic, ~> 3.0.3 And update the DEPRECATION keywords Change-Id: Id37bcb0a751e60581864b196e2e72b8eb37dca6c
96 lines
4.0 KiB
Markdown
96 lines
4.0 KiB
Markdown
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.
|
|
|
|
http://horizon.openstack.org
|
|
|
|
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.
|
|
|
|
```json
|
|
"run_list": [
|
|
"recipe[openstack-dashboard::server]"
|
|
]
|
|
```
|
|
|
|
Attributes
|
|
==========
|
|
|
|
* `openstack["dashboard"]["db"]["username"]` - username for horizon database access
|
|
* `openstack["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 system
|
|
* `openstack["dashboard"]["ssl"]["cert"]` - name to use when creating the ssl certificate
|
|
* `openstack["dashboard"]["ssl"]["key"]` - name to use when creating the ssl key
|
|
* `openstack["dashboard"]["dash_path"]` - base path for dashboard files (document root)
|
|
* `openstack["dashboard"]["wsgi_path"]` - path for wsgi dir
|
|
* `openstack["dashboard"]["ssl_offload"]` - Set SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTOCOL', 'https') flag for offloading SSL
|
|
* `openstack["dashboard"]["plugins"]` - Array of plugins to include via INSTALED\_APPS
|
|
|
|
Testing
|
|
=====
|
|
|
|
This cookbook uses [bundler](http://gembundler.com/), [berkshelf](http://berkshelf.com/), and [strainer](https://github.com/customink/strainer) to isolate dependencies and run tests.
|
|
|
|
Tests are defined in Strainerfile.
|
|
|
|
To run tests:
|
|
|
|
$ bundle install # install gem dependencies
|
|
$ bundle exec berks install # install cookbook dependencies
|
|
$ bundle exec strainer test # run tests
|
|
|
|
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>) |
|
|
| | |
|
|
| **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, IBM, Corp. |
|
|
|
|
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.
|