Editing a Blueprint

Learn how to edit an existing blueprint.

The following procedure describes how to edit an existing blueprint configuration using the CLI. Alternatively, you can edit a blueprint using the Cockpit web console interface, see Oracle Linux: Using the Cockpit Web Console for more details.

Edit an existing blueprint as follows:
1. (Optional) List the existing blueprints.
```
sudo composer-cli blueprints list
```
2. Save or export the blueprint you want to edit.
```
sudo composer-cli blueprints save myblueprint
```
  The blueprint specification file is saved as the name of the blueprint defined in the metadata, with the .toml extension, in the current directory.
3. Using a text editor, edit the blueprint specification file by revising package and customization entries as required.
4. Remove the line packages = [] if it exists in the blueprint.
5. Update the version by incrementing the number as appropriate.
  
  Ensure that the version follows the scheme in https://semver.org/.
6. Save the changes.
7. Push or import the blueprint specification file into Image Builder.
```
sudo composer-cli blueprints push myblueprintfile.toml
```
(Optional) View the revised blueprint configuration.
```
sudo composer-cli blueprints show myblueprint
```
Verify that the blueprint's components, versions, and corresponding dependencies are valid.
```
sudo composer-cli blueprints depsolve myblueprint
```
If Image Builder is unable to validate the dependencies, remove the osbuild-composer cache.
```
sudo rm -rf /var/cache/osbuild-composer/*
```
```
sudo systemctl restart osbuild-composer
```