ironic ^#21

Supports: trusty

Description

OpenStack bare metal provisioning (or Ironic) is an integrated OpenStack
service which aims to provision bare metal machines instead of virtual
machines.

Tags:
openstack ›

Overview

This charm deploys and configures a node with OpenStack Ironic which has
integration with other OpenStack components. Services from the node are:
ironic-api, ironic-conductor, tftpd-hpa and optionally nginx.

Nginx is optionally used as a light-weight web server used to serve
iPXE files over http, in case the charm is configured to use iPXE instead of
traditional PXE.

Configuration

Create an options.yaml file with the necessary configurations needed to deploy
the charm:

ironic:
  openstack-origin: "cloud:trusty-kilo"
  enable-ipxe: True
  enabled-drivers: "pxe_ipmitool,agent_ipmitool"
  nodes-cleaning: False

The above configurations can be used to deploy the charm using
the OpenStack Kilo release. You may change the config options according to your
needs. See the configuration section for details about the charm's config
options.

Networking

OpenStack Ironic supports integration with Neutron, which is used as a DHCP
provider for the ironic-conductor.

As a requirement, prior to deploying the charm, you'll have to configure the
neutron-gateway node with a flat network provider that uses a NIC which is connected to an isolated network dedicated for Ironic traffic.

When iPXE is enabled, DHCP requests from iPXE need to have a DHCP tag called
"ipxe", in order for the DHCP server to tell the client to get the "boot.ipxe" script via HTTP. Thus, you must configure neutron-gateway units accordingly:

juju set neutron-gateway dnsmasq-flags="dhcp-userclass=set:ipxe,iPXE, dhcp-match=set:ipxe,175"

Usage

Deploy the charm and add the relations with the other OpenStack charms:

juju deploy --config options.yaml cs:~cloudbaseit/trusty/ironic
juju add-relation ironic mysql
juju add-relation ironic keystone
juju add-relation ironic rabbitmq-server
juju add-relation ironic glance
juju add-relation ironic neutron-api
juju add-relation ironic nova-compute-ironic

To scale out horizontally:

juju add-unit ironic -n <number_of_units>

To scale down:

juju destroy-unit ironic/<unit_number>

Configuration

database: (string) Database name; ironic
database-user: (string) Username for database access; ironic
debug: (boolean) Enable debug logging.
dhcp-provider: (string) DHCP provider used by Ironic. Valid options are: 'neutron' and 'none'.; neutron
disk-devices: (string) The disk devices to scan while doing the deploy. A comma separated list should be given.; cciss/c0d0,sda,hda,vda
enable-ipxe: (boolean) Enable iPXE.
enable-uefi: (boolean) Enable UEFI boot mode.
enabled-drivers: (string) Specify the a comma separated list of drivers to load during service initialization.; pxe_ipmitool,agent_ipmitool
http-port: (int) Port of the nginx webserver used by the iPXE.; 8080
ipxe-boot-script: (string) Path to the main iPXE script file.
ironic-port: (string) Space separated list of NIC interfaces or MAC addresses of the ports connected to the private Ironic flat network; eth1
ironic-subnet: (string) CIDR used to provide a private IP for the ironic-port. Last bits from the IP provided by the juju provider to the machine are used to decide which IP to configure on the ironic-port.; 10.0.190.0/24
nodes-cleaning: (boolean) Enables the nodes cleaning tasks which are executed after the nodes are deleted. NOTE: The cleaning operation causes instance deletion to take significantly longer.
openstack-origin: (string) Repository from which to install. May be one of the following: distro (default), ppa:somecustom/ppa, a deb url sources entry, or a supported Cloud Archive release pocket. Supported Cloud Archive sources include: cloud:<series>-<openstack-release> cloud:<series>-<openstack-release>/updates cloud:<series>-<openstack-release>/staging cloud:<series>-<openstack-release>/proposed For series=Precise we support cloud archives for openstack-release: * icehouse For series=Trusty we support cloud archives for openstack-release: * juno * kilo * ... NOTE: updating this setting to a source that is known to provide a later version of OpenStack will trigger a software upgrade. NOTE: when openstack-origin-git is specified, openstack specific packages will be installed from source rather than from the openstack-origin repository.; distro
pxe-bootfile-name: (string) Bootfile DHCP parameter.
pxe-config-template: (string) Template file for PXE configuration.
rabbit-user: (string) Username used to access rabbitmq queue; ironic
rabbit-vhost: (string) Rabbitmq vhost; openstack
region: (string) OpenStack Region; RegionOne
swift-temp-url-duration: (int) The length of time in seconds that the Swift temporary URL will be valid for. Defaults to 20 minutes. If some deploys get a 401 response code when trying to download from the temporary URL, try raising this duration.; 1200
swift-url: (string) Base URL used for temporary URLs generated for Ironic Python Agent. If this one is not set, a default base URL is constructed from the private-address and the port of the swift-proxy charm. This doesn't need to be set, if Ironic baremetal nodes can reach the swift-proxy charm through the private-address.
tftp-port: (int) TFTP port.; 69
uefi-pxe-bootfile-name: (string) Bootfile DHCP parameter for UEFI boot mode.
uefi-pxe-config-template: (string) Template file for PXE configuration for UEFI boot loader.
verbose: (boolean) Enable verbose logging.