Custom Images

Describes custom OCK images used to create Kubernetes cluster nodes.

To create custom images, use the ocne image create command. The resulting image is in the appropriate format for the target platform and saved to the $HOME/.ocne/images directory on the localhost. Use the ocne image upload command to upload the image to a location where you can use the image to create VMs.

Creating images requires access to a Kubernetes cluster. Any running cluster can be used. To specify which cluster to use, set the KUBECONFIG environment variable, or use the --kubeconfig option of ocne commands. If no cluster is available, an ephemeral cluster is created automatically using the libvirt provider, with the default configuration.

Image conversion requires a significant amount of space. We recommend you allocate at least 20 G of storage to any cluster nodes. You can set the storage for the ephemeral and libvirt clusters in a configuration file, for example, you could add the following to the CLI defaults file:

ephemeralCluster:
  node:
    storage: 20G
providers:
  libvirt:
    workerNode:
      storage: 20G
    controlPlaneNode:
      storage: 20G