Creating the Image in Image Builder

Learn how to create an image based on a blueprint.

You must have an existing blueprint to use to create an image.

The following task describes how to create a custom image based on a specified blueprint and how to download the resulting composer image.

  1. Create the image with the blueprint specifications.
    sudo composer-cli compose start myblueprint image-type

    For a list of valid image types, see Image Types and Output Formats. Alternatively, type:

    sudo composer-cli compose types

    While the process is running in the background, the composer image's UUID is displayed.

  2. Use the UUID to track the progress of the image building process with the following command:
    sudo composer-cli compose info image-uuid

    The image's status indicates FINISHED when Image Builder has completed the build process.

    Tip:

    The output of the sudo composer-cli compose info command is verbose. Pipe the output of the command to head to see only the current status:

    sudo composer-cli compose info image-uuid | head -1
  3. Download the image file.
    sudo composer-cli compose image image-uuid

    To download the image's metadata and logs, enter:

    sudo composer-cli compose [metadata|logs] image-uuid