TOC Prev Next

Modules, Packages, and Instances

Packages

A CUE file is a standalone file by default. A package clause allows a single configuration to be split across multiple files.

Instances

All files within a directory hierarchy with the same package identifier belong to the same package. Each directory within this hierarchy provides a different “view” of this package called an instance. An instance of a package for a directory is defined by all CUE files in that directory and all of its ancestor directories, belonging to the same package. This allows common configuration to be shared and policies to be enforced across a collection of related configurations.

See the Kubernetes Tutorial for a concrete example of instances.

Modules

A module is the directory hierarchy containing the CUE files of a package. The root of this directory hierarchy is the module root. It may be explicitly marked with a cue.mod file.