openstack-chef-repo/doc/openstack-service.conf.erb.md
Jan Klare 481af2f96a adaptions for refactored cookbooks in mitaka cycle
* added new test scenarion allione (and all the needed files for it)
* removed old test scenarios aio-nova and aio-neutron as well as multi-neutron
  and multi-node and the related files since they will not work with the
  refactored cookbooks
* removed databag items for currently untested service cookbooks
* modified Rakefile to use new test scenarios for local and jenkins integration
  testing
* adapted README and docs to fit new test setup and explain the new
  attributes/template logic (with TODO)
* adapted Berksfile to use the master apache2 cookbook to comply with the
  dependencies in identity and dashboard
* removed image_upload recipe since this is already done in the
  integration-test::setup one
* moved recipe integration-test to a different chef_run to allow all services to
  be restarted in delayed actions of first run before using them
* removed heat from the testing stack until refactored
* removed tempest unit tests 'run_tests.sh' from integration testing scenarion,
  since there is no need to run tempests unit tests in our deployment

Depends-On: I0547182085eed91d05384fdd7734408a839a9a2c
Depends-On: I3262b2e6f792f37c32a446e6567790b82bdd4613
Depends-On: I80ed8a7892b59f7fd582505445a31b0df8d68752
Depends-On: Ia7fd927f42f4a1e484e8f2d34c52b1dc6d0ce6dd
Depends-On: Ifd11f86c576d7dbb709bdd302d41e39e900e1b74
Depends-On: Ida408a025f1a3e6a632108a9a32877026e286116
Depends-On: Idadc97bd7380d6c4f9f6f33d9c6b1215a5f24772
Depends-On: I9ac9eeb29ab27f31394830e4b6f999d5870cc0e4
Depends-On: Ifa5a7f4e1df47a3961976e64f654224864c3dcb4
Depends-On: I9cc1b5cc069987ac83e064322c2291772505ff5f
Implements: blueprint cookbook-refactoring

Change-Id: Icf0921229e9473a842d7ce5706027d56229e11d4
2016-02-10 09:25:55 +01:00

1.5 KiB

Render all openstack-service configuration files from attributes

Note: This functionality has been added in mitaka and replaces most of the previously existing template files to generate service configurations like nova.conf, neutron.conf or even ml2_conf.ini.

Usage

All service configuration files following the INI file format can be created with the template from the [openstack-common cookbook] (https://github.com/openstack/cookbook-openstack-common/blob/master/templates/default/openstack-service.conf.erb).

The attributes to create for example the neutron.conf have to follow this format:

default['openstack']['network']['conf'][$SECTION][$PROPERTY][$VALUE]

In the case given above, you first have to select the proper section ($SECTION) like 'DEFAULT' or 'keystone_authtoken'. After that you can simply select the property (e.g. 'log_file', 'verbose' or 'password') and its value (e.g. '/var/log/neutron/neutron-server.log', true or 'mypass'). The given examples would render something similar to this:

['DEFAULT']
log_file = /var/log/neutron/neutron-server.log
verbose = true
['keystone_authtoken']
password = mypass

The exact same logic is used for most services (currently keystone, nova, neutron (conf and plugin files), cinder and glance) and will be adapted for all other services and config files throughout the openstack cookbooks if possible.

TODO: add more specifics of the used defaults to each service cookbook and link these sections here