kolla-ansible/doc/ironic-guide.rst
Eduardo Gonzalez 66b91d8bd0 Remove doc build errors
Gates only build deploy-guide docs, not every doc.
This change clean doc errors, only Line to long.

Also, removes doc/build folder in tox doc environment.
doc/build is folder where previus executions are stored
causing next execution to fail due rendered versions does
not follow doc style checks.

Change-Id: I623a7ee245729a06509f3a7039d5d5ed3813d977
2017-07-13 16:11:33 +01:00

2.1 KiB

Ironic in Kolla

Overview

Currently Kolla can deploy the Ironic services:

  • ironic-api
  • ironic-conductor
  • ironic-inspector

As well as a required PXE service, deployed as ironic-pxe.

Current status

The Ironic implementation is "tech preview", so currently instances can only be deployed on baremetal. Further work will be done to allow scheduling for both virtualized and baremetal deployments.

Pre-deployment Configuration

Enable Ironic role in /etc/kolla/globals.yml:

enable_ironic: "yes"

Beside that an additional network type 'flat' has to be added to a list of tenant network types:

neutron_tenant_network_types: "vxlan,flat"

Configuring Web Console

Configuration based off upstream web_console_documentation.

Serial speed must be the same as the serial configuration in the BIOS settings. Default value: 115200bps, 8bit, non-parity.If you have different serial speed.

Set ironic_console_serial_speed in /etc/kolla/globals.yml:

ironic_console_serial_speed: 9600n8

Post-deployment configuration

Configuration based off upstream documentation.

Again, remember that enabling Ironic reconfigures nova compute (driver and scheduler) as well as changes neutron network settings. Further neutron setup is required as outlined below.

Create the flat network to launch the instances: :

neutron net-create --tenant-id $TENANT_ID sharednet1 --shared \
--provider:network_type flat --provider:physical_network physnet1

neutron subnet-create sharednet1 $NETWORK_CIDR --name $SUBNET_NAME \
--ip-version=4 --gateway=$GATEWAY_IP --allocation-pool \
start=$START_IP,end=$END_IP --enable-dhcp

And then the above ID is used to set cleaning_network_uuid in the neutron section of ironic.conf.