nvca-chart-release

NVCA Operator Chart Release Workflow

Propagates Helm chart changes through the native monorepo paths:

Workflow

1. Make source changes in src/compute-plane-services/nvca when operator, agent, or source chart behavior changes. Test them there.

2. Vendor from the monorepo source chart at src/compute-plane-services/nvca/deployments/nvca-operator/.

3. Set the version inputs, either in the environment or in deploy/helm/nvca-operator/.env:

   NVCA_OPERATOR_VERSION=<operator-image-tag>
   NVCA_VERSION=<agent-image-tag>
   NVCA_SHARED_STORAGE_IMAGE_TAG=<shared-storage-tag>
   NVCA_OTEL_COLLECTOR_IMAGE_TAG=<byoo-otel-collector-image-tag>

   NVCA_OTEL_COLLECTOR_IMAGE_TAG is normally left alone: it moves on its own when byoo-otel-collector releases, driven by tools/chart-version-bumper against the vendored chart directly rather than through this source-first flow. Set it explicitly only when vendoring by hand; otherwise pass the value already committed in deploy/helm/nvca-operator/nvca-operator/values.yaml (otelCollector.imageTag) so an unrelated vendor run does not revert it.

4. Vendor and validate from deploy/helm/nvca-operator:

   make vendor-chart
   make lint
   make template
   make validate

5. If the chart is tested against a local self-managed control plane, render stack-aware values and install from this chart subtree:

   make render-values-from-stack stack_repo=../../../deploy/stacks/self-managed stack_env=local
   make install-from-stack stack_repo=../../../deploy/stacks/self-managed stack_env=local

   Use additional_values=override.yml for one-off validation. Do not edit the stack just to test this chart.

CI and Release

Umbrella CI is declared in tools/ci/subproject-validations.yaml with subproject id nvca-operator. Do not add a chart-local .gitlab-ci.yml.

Run the repository-wide Helm validation used by CI:

tools/ci/check-helm-charts

Local Image Testing

When testing local images in k3d, build them from src/compute-plane-services/nvca and import them into the test cluster. Keep tags explicit and match them in the chart values:

export NVCA_OPERATOR_VERSION=dev-local
export NVCA_VERSION=dev-local
 
# Run from src/compute-plane-services/nvca.
docker build -f docker/Dockerfile.nvca-operator \
  -t nvca-operator:$NVCA_OPERATOR_VERSION .
docker build -f docker/Dockerfile.nvca \
  -t nvca:$NVCA_VERSION .

Use the local-dev safety guidance before creating or deleting k3d clusters.

Gotchas

• make vendor-chart overwrites the vendored nvca-operator/ chart.
• Chart release generation depends on Conventional Commit semantics at the umbrella level. Use feat or fix when a chart release is required.
• Keep image.*, nvcaImage.*, ngcConfig.*, and selfManaged.* values in sync with the stack and source image tags.
• Never commit service keys, kubeconfigs, rendered secrets, or local registry credentials.