Kaname

Build Status

Kaname(要) is configuration management tool of Keystone.

Installation

Install it yourself as:

$ gem install kaname

Usage

You can define keystone configuration for OpenStack via YAML format. Like following syntax.

antipop:
  email: "[email protected]"
  tenants:
    production: "cto"
hsbt:
  email: "[email protected]"
  tenants:
    development: "admin"
    production: "member"

You can also define all_tenants for config all tenants' authority.
If both tenants and all_tenants are setting, tenants is preferred.

suzupy:
  email: [email protected]
  all_tenants: member

You need to put a configuration file to home directory.

% cat ~/.kaname
auth_url: "http://your-openstack-auth-endpoint/v2.0"
username: "admin"
tenant: "admin"
password: "admin-no-password"

also, you can set some options.

ca_cert: "/path/to/ca.pem"
client_cert: "/path/to/cert.pem"
client_key: "/path/to/key.pem"
region_name: "YourRegion"

run following command.

$ kaname diff # You can see difference of definition
$ kaname apply # apply configuration into OpenStack
$ kaname apply --dryrun # You can see all of invoke commands(dryrun)

You can create user and user's role with tenant.

If you need to initialize your Keystone configuration, you can get it via following command:

$ kaname dump

Development

After checking out the repo, run bin/setup to install dependencies. Then, run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release to create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

  1. Fork it ( https://github.com/yaocloud/kaname/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request