3.3. Editing an Image Builder blueprint with command-line interface

This procedure describes how to edit an existing Image Builder blueprint in the command-line interface.


1. Save (export) the blueprint to a local text file:
# composer-cli blueprints save BLUEPRINT-NAME
2. Edit the BLUEPRINT-NAME.toml file with a text editor of your choice and make your changes.
3. Before finishing the edits, make sure the file is a valid blueprint:
  • Remove this line, if present:
    packages = []
  • Increase the version number. Remember that Image Builder blueprint versions must use the Semantic Versioning scheme. Note also that if you do not change the version, the patch component of version is increased automatically.
  • Check if the contents are valid TOML specifications. See the TOML documentation for more information.


TOML documentation is a community product and is not supported by Red Hat. You can report any issues with the tool at https://github.com/toml-lang/toml/issues
4. Save the file and close the editor.
5. Push (import) the blueprint back into Image Builder:
# composer-cli blueprints push BLUEPRINT-NAME.toml
Note that you must supply the file name including the .toml extension, while in other commands you use only the name of the blueprint.
6. To verify that the contents uploaded to Image Builder match your edits, list the contents of blueprint:
# composer-cli blueprints show BLUEPRINT-NAME
7. Check whether the components and versions listed in the blueprint and their dependencies are valid:
# composer-cli blueprints depsolve BLUEPRINT-NAME