diskimage-builder/elements/ironic-agent
Martin André bc2199144e Selectively prune /root for ironic-agent ramdisk
Previously all files in /root were ignored when building the
ironic-agent ramdisk. This prevented for example to use the
local-config element to connect to the ramdisk via ssh as root user.

This commit change the exclude rule on /root to only ignore the
/root/.cache directory.

Change-Id: I18d839e8d97636f5f2164ba407f252407d9bc956
Closes-Bug: #1451668
2015-10-26 11:19:28 +09:00
..
cleanup.d Selectively prune /root for ironic-agent ramdisk 2015-10-26 11:19:28 +09:00
finalise.d Reduce the size of the ironic-agent ramdisk 2015-08-06 16:34:30 +01:00
install.d Install ironic-agent dependencies via package-installs 2015-09-21 13:10:30 +02:00
post-install.d Remove dnf workaround in ironic-agent 2015-09-21 13:13:19 +02:00
test-elements Add functional test for ironic-agent on Fedora 2015-09-22 14:50:17 +02:00
element-deps [ironic-agent] Use svc-map for enabling agent 2015-09-01 07:12:52 -04:00
element-provides Add element for building ramdisk with ironic-python-agent 2014-11-13 19:30:44 +02:00
package-installs.yaml Install 'gdisk' when building ramdisk with ironic-agent 2015-09-24 06:25:10 -07:00
pkg-map Install ironic-agent dependencies via package-installs 2015-09-21 13:10:30 +02:00
README.rst ironic-agent element to output a .kernel file 2015-09-23 19:02:54 -04:00
source-repository-ironic-agent Add packages required for iscsi extension in agent 2015-05-04 00:16:19 -07:00
svc-map [ironic-agent] Use svc-map for enabling agent 2015-09-01 07:12:52 -04:00

============
ironic-agent
============
Builds a ramdisk with ironic-python-agent.  More information can be found at:
    https://git.openstack.org/cgit/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.

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