bifrost/doc/source/install/keystone.rst
Olivier Bourdon 0e4456ae3a Fix for proper deployment when keystone enabled and minimal OS
Due to the fact that the openstack CLI can not be found on
the minimal OS (Ubuntu Xenial + OpenSSH server ~ 363 packages)
and that some tasks related to Keystone use this utility
it should be installed like the other Ironic CLIs

Change-Id: I3c2056cd1fe8551ca7dcb7f122e8982d5f9301a5
Closes-Bug: #1747349
2018-02-07 16:08:51 +01:00

2.2 KiB

Installation with Keystone

Note

Use of keystone with bifrost is a very new feature and should be considered an advanced topic. Please feel free to reach out to the bifrost contributors and the ironic community as a whole in the project's IRC channel.

Bifrost can now install and make use of keystone. In order to enable this as part of the installation, the enable_keystone variable must be set to true, either in playbooks/inventory/group_vars/target or on the command line during installation. Note that enable_keystone and noauth_mode are mutually exclusive so they should have an opposite value of oneanother. Example:

ansible-playbook -vvvv -i inventory/target install.yaml -e enable_keystone=true -e noauth_mode=false

However, prior to installation, overriding credentials should be set in order to customize the deployment to meet your needs.

  • playbooks/roles/bifrost-ironic-install/defaults/main.yml
  • playbooks/roles/bifrost-keystone-install/defaults/main.yml

Using an existing Keystone

If you choose to install bifrost using an existing keystone, this should be possible, however it has not been tested. In this case you will need to set the appropriate defaults, via playbooks/roles/bifrost-ironic-install/defaults/main.yml which would be a good source for the role level defaults. Ideally, when setting new defaults, they should be set in the playbooks/inventory/group_vars/target file.

Creation of clouds.yaml

By default, during bifrost installation, when keystone is enabled, a file will be written to the user's home directory that is executing the installation. That file can be located at ~/.config/openstack/clouds.yaml. The cloud that is written to that file is named bifrost.

Creation of openrc

Also by default, after bifrost installation and again, when keystone is enabled, a file will be written to the user's home directory that you can use to set the appropriate environment variables in your current shell to be able to use OpenStack utilities:

. ~/openrc bifrost && openstack baremetal driver list