diskimage-builder

History

Ben Nemec e49d347ba9 Generalize logic for skipping final image generation Since the ironic-agent element builds the ramdisk and extracts the kernel itself, there's no need to actually generate an image at the end of the process. Previously the unnecessary image was being deleted, but this wastes a bunch of time compressing and converting the image. It's better to just not create the image at all. This change adds a noop element called no-final-image that disk-image-create looks for in the element list and, if found, will cause it to skip the final image generation. This is more flexible than the previous ironic-agent-specific method that would have required changes to disk-image-create for every element that wanted to behave similarly. Note that this cannot be done using an environment variable, because element environments.d entries do not propagate out to disk-image-create. It also doesn't make sense as a user option because it should be set by the element author, not the user. Change-Id: I168feb18f0d578b3babbe4784d3ef75e755e1ebd		2016-07-28 13:14:36 -05:00
..
cleanup.d	Clean more from ironic-agent ramdisk image	2016-06-24 13:21:32 -05:00
environment.d	Use ironic-agent for source-repositories	2015-11-22 15:03:31 -05:00
extra-data.d	Support to add certificate in ironic-agent	2016-04-14 13:42:36 +00:00
finalise.d	Do not remove sudo in ironic-agent	2016-05-16 10:39:04 +10:00
install.d	Add dhcp-all-interfaces.target for syncing units	2016-05-16 10:15:53 +01:00
post-install.d	Merge "ironic-agent postinst fails on systemd with no iptables"	2016-04-04 19:35:42 +00:00
test-elements/build-succeeds-fedora	Remove zero length files	2016-01-20 19:08:54 -05:00
element-deps	Generalize logic for skipping final image generation	2016-07-28 13:14:36 -05:00
element-provides	Add element for building ramdisk with ironic-python-agent	2014-11-13 19:30:44 +02:00
package-installs.yaml	package-installs: add list to arch and "not-arch" list	2016-07-01 21:31:59 +02:00
pkg-map	Install ironic-agent dependencies via package-installs	2015-09-21 13:10:30 +02:00
README.rst	Support to add certificate in ironic-agent	2016-04-14 13:42:36 +00:00
source-repository-ironic-agent	Install IPA in a virtual environment	2016-02-16 11:17:12 +00:00
svc-map	[ironic-agent] Use svc-map for enabling agent	2015-09-01 07:12:52 -04:00

README.rst

============
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.
* 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.

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