41 lines
1.9 KiB
ReStructuredText
41 lines
1.9 KiB
ReStructuredText
============
|
|
ironic-agent
|
|
============
|
|
Builds a ramdisk with ironic-python-agent. More information can be found at:
|
|
https://opendev.org/openstack/ironic-python-agent/
|
|
|
|
Beyond installing the ironic-python-agent, this element does the following:
|
|
|
|
* Installs the ``dhcp-all-interfaces`` so the node, upon booting, attempts to
|
|
obtain an IP address on all available network interfaces.
|
|
* Disables the ``iptables`` service on SysV and systemd based systems.
|
|
* Disables the ``ufw`` service on Upstart based systems.
|
|
* Installs packages required for the operation of the ironic-python-agent::
|
|
``qemu-utils`` ``parted`` ``hdparm`` ``util-linux`` ``genisoimage``
|
|
* When installing from source, ``python-dev`` and ``gcc`` are also installed
|
|
in order to support source based installation of ironic-python-agent and its
|
|
dependencies.
|
|
* Install the certificate if any, which is set to the environment variable
|
|
``DIB_IPA_CERT`` for validating the authenticity by ironic-python-agent. The
|
|
certificate can be self-signed certificate or CA certificate.
|
|
* Compresses initramfs with command specified in environment variable
|
|
``DIB_IPA_COMPRESS_CMD``, which is 'gzip' by default. This command should listen
|
|
for raw data from stdin and write compressed data to stdout. Command can be
|
|
with arguments.
|
|
|
|
This element outputs three files:
|
|
|
|
- ``$IMAGE-NAME.initramfs``: The deploy ramdisk file containing the
|
|
ironic-python-agent (IPA) service.
|
|
- ``$IMAGE-NAME.kernel``: The kernel binary file.
|
|
- ``$IMAGE-NAME.vmlinuz``: A hard link pointing to the ``$IMAGE-NAME.kernel``
|
|
file; this is just a backward compatibility layer, please do not rely
|
|
on this file.
|
|
|
|
.. note::
|
|
The package based install currently only enables the service when using the
|
|
systemd init system. This can easily be changed if there is an agent
|
|
package which includes upstart or sysv packaging.
|
|
|
|
.. note::
|
|
Using the ramdisk will require at least 1.5GB of ram
|