Building a Single Image

The openstack overcloud image build --all command builds all the images needed for an overcloud deploy. However, you may need to rebuild a single one of them. Use the following commands if you want to do it:

openstack overcloud image build --type {agent-ramdisk|deploy-ramdisk|fedora-user|overcloud-full}

If the target image exist, this commands ends silently. Make sure to delete a previous version of the image to run the command as you expect.

Moreover, you can build the image with an extra element of your choice using the --builder-extra-args argument:

openstack overcloud image build --type overcloud-full \
    --builder-extra-args overcloud-network-midonet


Make sure the element is available in the $ELEMENTS_PATH environment variable

Uploading the New Single Image

After the new image is built, it can be uploaded using the same command as before, with the --update-existing flag added:

openstack overcloud image upload --update-existing

Note that if the new image is a ramdisk, the Ironic nodes need to be re-configured to use it. This can be done by re-running:

openstack overcloud node configure --all-manageable

Stable Branch


For TripleO release Mitaka, the boot configuration command is:

openstack baremetal configure boot


If you want to use custom images for boot configuration, specify their names in --deploy-kernel and --deploy-ramdisk options.

Now the new image should be fully ready for use by new deployments.

Table Of Contents

Previous topic

Upgrading to a Next Major Release

Next topic

Backing up and Restoring your Undercloud

Project Source

This Page

Limit Environment Specific Content
Operating Systems
RHEL Registration Types
Additional Overcloud Roles
Development options
Upgrade Version