Creating a Blueprint

Learn how to create a blueprint.

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

Create a blueprint configuration as follows:
1. Using any text editor, create a text file.
2. In the text file, provide the blueprint specifications for the base distro, the packages you want installed, and any other image customizations as required.
  
  Ensure that you provide the basic metadata information about the blueprint. For reference, see Blueprint Format
3. Save the file as a toml file. For example, myblueprintfile.toml.
4. Push or import the blueprint into Image Builder, for example:
```
sudo composer-cli blueprints push myblueprintfile.toml
```
(Optional) View the blueprint configuration, using the name you specified in the blueprint metadata name entry:
```
sudo composer-cli blueprints show myblueprint
```
Verify that the blueprint's components and versions and corresponding dependencies are valid.
```
sudo composer-cli blueprints depsolve myblueprint
```
If Image Builder is unable to validate the dependencies, delete the osbuild-composer cache.
```
sudo rm -rf /var/cache/osbuild-composer/*
```
```
sudo systemctl restart osbuild-composer
```