Skip to main content

Config Reference

This page captures the most important chart values and runtime settings used in the current customer deployment model. It is not yet an exhaustive schema dump.

Core run settings

KeyType or examplePurpose
config.projectIdtestResolves the input directory name under the input root
config.runIdrun_20260307T010203ZForces outputs into a stable run-scoped directory
config.runModestandard or deepSelects the execution profile and billing metric
config.inputPath/data/inputRoot path used to discover <project_id>/01_sources/
config.outputPath/data/outputRoot path where run-scoped outputs are written

Entitlement settings

KeyType or examplePurpose
config.entitlementUrlhttps://YOUR_CLOUD_RUN_SERVICEBase URL for the entitlement and seal API
config.entitlementAuthModegoogleEnables identity-based auth for the customer job
config.entitlementAudiencesame as entitlement URLAudience used when minting the identity token
config.entitlementPrincipallocal-devLocal or test principal for non-Google development flows

For the customer deployment path, prefer config.entitlementAuthMode=google.

Storage settings

KeyType or examplePurpose
storage.typepvc or gcsSelects the backing storage mode
storage.pvc.storageClassNamestandardStorage class for PVC mode
storage.pvc.size50GiRequested PVC capacity
storage.gcs.bucketYOUR_BUCKETBucket used for GCS-backed storage mode

Workload Identity settings

KeyType or examplePurpose
workloadIdentity.enabledtrueEnables Workload Identity plumbing in the chart
workloadIdentity.gcpServiceAccountyour-sa@project.iam.gserviceaccount.comGSA used by the job when calling Google-protected services

Marketplace and usage reporting settings

KeyType or examplePurpose
marketplace.reportingSecretKubernetes Secret referenceInjects the Marketplace reporting credential
ubbagent.metricNamestandard_audit_runLegacy hard override for usage metric selection
ubbagent.metricNameStandardstandard_audit_runExplicit Standard metric name
ubbagent.metricNameDeepdeep_audit_runExplicit Deep metric name

If ubbagent.metricName is set, it acts as a hard override. Leave it empty unless you have a controlled release reason to override the mode-aware defaults.

Operational notes

  • config.projectId must match the staged input folder name exactly
  • config.runId must be unique per run to avoid 409 reuse conflicts
  • Standard and Deep should be treated as separate operational profiles, not just cosmetic labels
  • Do not change storage size downward on an existing PVC-backed release

See also Kubernetes and Helm.