c2d54b9737
We upgrade the rst convention by following Documentation Contributor Guide[1]. [1] https://docs.openstack.org/doc-contrib-guide Change-Id: I825deadefcf996732a03e61c8fd19cfd6a498e77 Partially-Implements: blueprint optimize-the-documentation-format
88 lines
2.2 KiB
ReStructuredText
88 lines
2.2 KiB
ReStructuredText
.. _ironic-guide:
|
|
|
|
===============
|
|
Ironic in Kolla
|
|
===============
|
|
|
|
Overview
|
|
~~~~~~~~
|
|
Currently Kolla can deploy the Ironic services:
|
|
|
|
- ironic-api
|
|
- ironic-conductor
|
|
- ironic-dnsmasq
|
|
- 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``:
|
|
|
|
.. code-block:: yaml
|
|
|
|
enable_ironic: "yes"
|
|
|
|
.. end
|
|
|
|
Beside that an additional network type ``vlan,flat`` has to be added to a list of
|
|
tenant network types:
|
|
|
|
.. code-block:: yaml
|
|
|
|
neutron_tenant_network_types: "vxlan,vlan,flat"
|
|
|
|
.. end
|
|
|
|
Configuring Web Console
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Configuration based off upstream `Node web console
|
|
<https://docs.openstack.org/ironic/latest/admin/console.html#node-web-console>`__.
|
|
|
|
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``:
|
|
|
|
.. code-block:: yaml
|
|
|
|
ironic_console_serial_speed: 9600n8
|
|
|
|
.. end
|
|
|
|
Post-deployment configuration
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Configuration based off upstream `Ironic installation Documentation
|
|
<https://docs.openstack.org/ironic/latest/install/index.html>`__.
|
|
|
|
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:
|
|
|
|
.. code-block:: console
|
|
|
|
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
|
|
|
|
.. end
|
|
|
|
And then the above ID is used to set ``cleaning_network`` in the neutron
|
|
section of ``ironic.conf``.
|
|
|