Managing Components

List, build, and manage components using the CLI.

The CLI provides commands to manage components and builds. To see all available commands, run nuon components --help.

Select an app template using nuon apps select before using component commands, or pass the -a flag.

Common Commands

nuon components list                                  # list components
nuon components get -c <component_id or name>         # get a component
nuon components latest-config -c <component_id or name>  # print latest config

To delete a component, remove its TOML file from the app directory, then commit and push to the git branch your app branch tracks. The next branch run removes it.

Builds

All components must be built before creating or updating an install. A branch run builds automatically when component TOML files or related files (e.g., Helm values.yaml) change. To rebuild every component, run nuon branches trigger --branch-id <branch> --force.

If component source files change in git, push those changes first, then build manually:

nuon builds create -c <component_name>    # create a build
nuon builds list -c <component_name>      # list builds
nuon builds get -b <build-id> -c <component_name>   # get build details
nuon builds logs -b <build-id> -c <component_name>  # show build logs

Omit the -c flag to list builds for all components in the selected app.