update the README after refactoring and align it with other cookbooks
* also removed the empty default recipe Change-Id: Iff2c536d595f90f932129ab8a2faad17ae41415b
This commit is contained in:
Jan Klare
parent
d6d787d4b9
commit
f950ab4b40
110
README.md
110
README.md
|
|
@ -1,105 +1,67 @@
|
||||||
Description
|
Description
|
||||||
===========
|
===========
|
||||||
|
|
||||||
This cookbook installs the OpenStack Heat service **Heat** as part of an OpenStack reference deployment Chef for OpenStack.
|
This cookbook installs the OpenStack Heat service **Heat** as part of an
|
||||||
|
OpenStack reference deployment Chef for OpenStack.
|
||||||
|
|
||||||
https://wiki.openstack.org/wiki/Heat
|
https://wiki.openstack.org/wiki/Heat
|
||||||
|
|
||||||
Requirements
|
Requirements
|
||||||
============
|
============
|
||||||
|
|
||||||
Chef 11 or higher required (for Chef environment use).
|
- Chef 12 or higher
|
||||||
|
- chefdk 0.9.0 for testing (also includes berkshelf for cookbook dependency
|
||||||
|
resolution)
|
||||||
|
|
||||||
|
Platform
|
||||||
|
========
|
||||||
|
|
||||||
|
- ubuntu
|
||||||
|
- redhat
|
||||||
|
- centos
|
||||||
|
|
||||||
Cookbooks
|
Cookbooks
|
||||||
---------
|
=========
|
||||||
|
|
||||||
The following cookbooks are dependencies:
|
The following cookbooks are dependencies:
|
||||||
|
|
||||||
* openstack-common
|
- 'openstack-common', '>= 13.0.0'
|
||||||
* openstack-identity
|
- 'openstack-identity', '>= 13.0.0'
|
||||||
|
|
||||||
Usage
|
|
||||||
=====
|
|
||||||
|
|
||||||
api
|
|
||||||
------
|
|
||||||
- Configure and start heat-api service
|
|
||||||
|
|
||||||
api-cfn
|
|
||||||
------
|
|
||||||
- Configure and start heat-api-cfn service
|
|
||||||
|
|
||||||
api-cloudwatch
|
|
||||||
------
|
|
||||||
- Configure and start heat-api-cloudwatch service
|
|
||||||
|
|
||||||
client
|
|
||||||
----
|
|
||||||
- Install the heat client packages
|
|
||||||
|
|
||||||
common
|
|
||||||
------
|
|
||||||
- Installs the heat packages and setup configuration for Heat.
|
|
||||||
|
|
||||||
engine
|
|
||||||
------
|
|
||||||
- Setup the heat database and start heat-engine service
|
|
||||||
|
|
||||||
identity_registration
|
|
||||||
---------------------
|
|
||||||
- Registers the Heat API endpoint, heat service and user
|
|
||||||
|
|
||||||
Attributes
|
Attributes
|
||||||
==========
|
==========
|
||||||
|
|
||||||
Attributes for the Heat service are in the ['openstack']['orchestration'] namespace.
|
Please see the extensive inline documentation in `attributes/*.rb` for
|
||||||
|
descriptions of all the settable attributes for this cookbook.
|
||||||
|
|
||||||
* `openstack['orchestration']['identity_service_chef_role']` - The name of the Chef role that installs the Keystone Service API
|
Note that all attributes are in the `default['openstack']` "namespace"
|
||||||
* `openstack['orchestration']['rabbit_server_chef_role']` - The name of the Chef role that knows about the message queue server
|
|
||||||
* `openstack['orchestration']['user']` - User heat runs as
|
|
||||||
* `openstack['orchestration']['group']` - Group heat runs as
|
|
||||||
* `openstack['db']['orchestration']['username']` - Username for heat database access
|
|
||||||
* `openstack['orchestration']['service_role']` - User role used by heat when interacting with keystone, defaults to 'service'. Used in the API and registry paste.ini files
|
|
||||||
* `openstack['orchestration']['syslog']['use']` - Should heat log to syslog?
|
|
||||||
* `openstack['orchestration']['platform']` - hash of platform specific package/service names and options
|
|
||||||
* `openstack['orchestration']['api']['auth']['version']` - Select v2.0 or v3.0. Default v2.0. The auth API version used to interact with the identity service.
|
|
||||||
|
|
||||||
TODO: update this section adding new attributes
|
The usage of attributes to generate the heat.conf is decribed in the
|
||||||
|
openstack-common cookbook.
|
||||||
|
|
||||||
MQ attributes
|
Recipes
|
||||||
-------------
|
=======
|
||||||
|
|
||||||
TODO: update this section with the new attributes
|
## openstack-orchestration::api-cloudwatch
|
||||||
|
- Configure and start heat-api-cloudwatch service
|
||||||
|
|
||||||
Service bindings
|
## openstack-orchestration::api-cfn
|
||||||
----------------
|
- Configure and start heat-api-cfn service
|
||||||
|
|
||||||
* `openstack['bind_service']['all']['orchestration-api']['host']` - The IP address to bind the service to
|
## openstack-orchestration::api
|
||||||
* `openstack['bind_service']['all']['orchestration-api']['port']` - The port to bind the service to
|
- Configure and start heat-api service
|
||||||
* `openstack['bind_service']['all']['orchestration-api']['interface']` - The interface to bind the service to
|
|
||||||
|
|
||||||
* `openstack['bind_service']['all']['orchestration-api-cfn']['host']` - The IP address to bind the service to
|
## openstack-orchestration::client
|
||||||
* `openstack['bind_service']['all']['orchestration-api-cfn']['port']` - The port to bind the service to
|
- Install the heat client packages
|
||||||
* `openstack['bind_service']['all']['orchestration-api-cfn']['interface']` - The interface to bind the service to
|
|
||||||
|
|
||||||
* `openstack['bind_service']['all']['orchestration-api-cloudwatch']['host']` - The IP address to bind the service to
|
## openstack-orchestration::common
|
||||||
* `openstack['bind_service']['all']['orchestration-api-cloudwatch']['port']` - The port to bind the service to
|
- Installs the heat packages and setup configuration for Heat.
|
||||||
* `openstack['bind_service']['all']['orchestration-api-cloudwatch']['interface']` - The interface to bind the service to
|
|
||||||
|
|
||||||
If the value of the 'interface' attribute is non-nil, then the service will be bound to the first IP address on that interface and
|
## openstack-orchestration::engine
|
||||||
the 'host' attribute will be ignored.
|
- Setup the heat database and start heat-engine service
|
||||||
If the value of the 'interface' attribute is nil (which is the default), then the service will be bound to the IP address specified
|
|
||||||
in the 'host' attribute.
|
|
||||||
|
|
||||||
Miscellaneous Options
|
## openstack-orchestration::identity_registration
|
||||||
---------------------
|
- Registers the Heat API endpoint, heat service and user
|
||||||
|
|
||||||
* `orchestration_auth_encryption_key` - Key used to encrypt authentication info in the database. Length of this key must be 16, 24 or 32 characters. Comes from secrets databag.
|
|
||||||
|
|
||||||
Testing
|
|
||||||
=====
|
|
||||||
|
|
||||||
Please refer to the [TESTING.md](TESTING.md) for instructions for testing the cookbook.
|
|
||||||
|
|
||||||
License and Author
|
License and Author
|
||||||
==================
|
==================
|
||||||
|
|
|
||||||
|
|
@ -6,13 +6,6 @@ license 'Apache 2.0'
|
||||||
description 'Installs and configures the Heat Service'
|
description 'Installs and configures the Heat Service'
|
||||||
long_description IO.read(File.join(File.dirname(__FILE__), 'README.md'))
|
long_description IO.read(File.join(File.dirname(__FILE__), 'README.md'))
|
||||||
version '13.0.0'
|
version '13.0.0'
|
||||||
recipe 'openstack-orchestration::api', 'Start and configure the Heat API service'
|
|
||||||
recipe 'openstack-orchestration::api-cfn', 'Start and configure the Heat API CloudFormation service'
|
|
||||||
recipe 'openstack-orchestration::api-cloudwatch', 'Start and configure the Heat API CloudWatch service'
|
|
||||||
recipe 'openstack-orchestration::client', 'Installs packages for heat client'
|
|
||||||
recipe 'openstack-orchestration::common', 'Installs packages and configures a Heat Server'
|
|
||||||
recipe 'openstack-orchestration::engine', 'Sets up Heat database and starts Heat Engine service'
|
|
||||||
recipe 'openstack-orchestration::identity_registration', 'Registers Heat service, user and endpoints with Keystone'
|
|
||||||
|
|
||||||
%w(ubuntu redhat centos).each do |os|
|
%w(ubuntu redhat centos).each do |os|
|
||||||
supports os
|
supports os
|
||||||
|
|
|
||||||
|
|
@ -1,19 +0,0 @@
|
||||||
# encoding: UTF-8
|
|
||||||
#
|
|
||||||
# Cookbook Name:: openstack-orchestration
|
|
||||||
# Recipe:: default
|
|
||||||
#
|
|
||||||
# Copyright 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.
|
|
||||||
#
|
|
||||||
Loading…
Reference in New Issue