hull dependency
hull dependency manages the layers and required packages your
package composes with. You declare them in hull.yaml; these subcommands
inspect, resolve, download, and pin them.
- Layers (
layers:) are packages merged into yours at render time — a shared base, common labels, org defaults. - Requires (
requires:) are separate packages installed alongside yours — a database, a cache, a sidecar release.
Each entry names a source: a local path, a git:: URL, an https://
registry URL, or an oci:// reference. Resolved versions and git commits are
pinned in a hull.lock file, so every machine builds the same thing.
Subcommands
| Command | What it does |
|---|---|
list |
Show every layer and required package with its type and lock status |
tree |
Print the composition chain, including nested layers |
update |
Re-resolve versions and rewrite hull.lock |
build |
Resolve and download everything declared |
dep is an alias for dependency.
Usage
hull dependency <command> <package-path> [flags]
Every subcommand takes the package directory as its argument (there is no
default). Run list or tree to see what is declared, update to pin
versions, and build to fetch them.