Configuration Files

Describes OCK image configuration files.

The ock-forge script requires an rpm-ostree treefile configuration that specifies what the generated image contains. Because the script generates OCK images that are intended for Oracle CNE deployments, the treefile must contain the base configuration that's required to work in that environment. These configuration files are available for different target Kubernetes versions in the OCK Configuration GitHub repository.

We recommend that you don't edit these configuration files directly, but include any custom configuration in separate files. This prevents custom configuration from being overwritten by future updates to the OCK image configuration files.

The initial configuration file that the ock-forge script reads is called manifest.yaml. Use an existing configuration for the target Kubernetes version and customize it by including extra configuration files in the manifest.yaml file as follows:

# manifest.yaml
include:
- base.yaml
- ux.yaml
- ocne.yaml
- removals.yaml
- custom/myconfig.yaml
...

For example, to make the Vim editor available in the custom OCK image, add the following to the myconfig.yaml file:

packages:
- vim

For more information on the available parameters in an rpm-ostree treefile, see the rpm-ostree Treefile reference.