DemandFlow Support Centre

K8SHELM: K8s Helm Chart

A Helm chart deployment representing a packaged Kubernetes application with its release history, values, and lifecycle management.

Default definition. This article describes the default K8SHELM definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches K8SHELM.

Entity properties

Property	Value
Entity code	`K8SHELM`
Display name	K8s Helm Chart
Plural	K8s Helm Charts
Level	410

Use cases

K8SHELM models Helm releases -- the primary way teams package and deploy complex Kubernetes applications. The General panel captures chart name, namespace (objectLookup to K8SNAMESPACE), repository, chart version, release name, revision, and deployment timestamps. Repository Details includes URL, type (public, private, OCI, Git, S3, local), auth requirements, and update policy to support diverse chart sourcing strategies.

Fields

Chart Information

Field	Type	Required	Notes
`name`	text	Yes	Chart Name.
`namespace`	reference → `K8SNAMESPACE`	Yes	Namespace.
`repository`	text		e.g., bitnami, stable
`chartVersion`	text		e.g., 1.2.3
`status`	enum	Yes	Valid ids: `1` (Deployed), `2` (Pending), `3` (Failed), `4` (Superseded), `5` (Uninstalled), `6` (Uninstalling), `7` (Pending-install), `8` (Pending-upgrade), `9` (Pending-rollback).

Release Information

Field	Type	Required	Notes
`releaseName`	text	Yes	Helm release instance name
`revision`	number		Revision.
`deploymentTime`	datetime		Deployment Time.
`lastUpdate`	datetime		Last Update.
`appVersion`	text		Application version
`description`	text (multi-line)		Chart description

Repository Details

Field	Type	Notes
`repoURL`	text (URL)	Helm repository URL
`repoType`	enum	Valid ids: `1` (Public), `2` (Private), `3` (OCI Registry), `4` (Git), `5` (S3), `6` (Local).
`authRequired`	boolean	Auth Required.
`updatePolicy`	enum	Valid ids: `1` (Manual), `2` (Auto-patch), `3` (Auto-minor), `4` (Auto-major).
`labels`	text (multi-line)	Key-value pairs (JSON)

Values Configuration

Field	Type	Required	Notes
`values`	text (multi-line)		values.yaml content (YAML format)
`valuesFiles`	text (multi-line)		List of additional values files

Overrides

Field	Type	Notes
`setValues`	text (multi-line)	--set key=value pairs
`setStringValues`	text (multi-line)	--set-string key=value pairs
`mergeStrategy`	enum	Valid ids: `1` (Replace), `2` (Merge), `3` (Strategic Merge).

Deployed Resources

Field	Type	Notes
`resources`	text (multi-line)	List of deployed Kubernetes resources
`workloadCount`	number	Workloads.
`serviceCount`	number	Services.
`configMapCount`	number	ConfigMaps.
`secretCount`	number	Secrets.
`pvcCount`	number	PVCs.
`ingressCount`	number	Ingresses.
`otherResourceCount`	number	Other Resources.
`totalResourceCount`	number	Total Resources.

Chart Dependencies

Field	Type	Notes
`dependencies`	text (multi-line)	Chart dependencies (JSON)
`dependencyCount`	number	Dependency Count.
`dependencyUpdateTime`	datetime	Last Dependency Update.

Sub-charts

Field	Type	Notes
`subcharts`	text (multi-line)	Enabled sub-charts
`parentChart`	reference → `K8SHELM`	If this is a sub-chart
`chartType`	enum	Valid ids: `1` (Application), `2` (Library), `3` (Operator), `4` (Infrastructure).

Release History

Field	Type	Notes
`history`	text (multi-line)	Helm release history
`rollbackEnabled`	boolean	Rollback Enabled.
`maxHistory`	number	Revisions to keep
`lastRollback`	datetime	Last Rollback.
`rollbackRevision`	number	Rollback To Revision.

Pre-install Hooks

Field	Type	Required	Notes
`preInstallHooks`	text (multi-line)		Hooks run before installation
`preUpgradeHooks`	text (multi-line)		Hooks run before upgrade

Post-install Hooks

Field	Type	Required	Notes
`postInstallHooks`	text (multi-line)		Hooks run after installation
`postUpgradeHooks`	text (multi-line)		Hooks run after upgrade

Chart Testing

Field	Type	Notes
`testEnabled`	boolean	Tests Enabled.
`testCommand`	text	helm test command
`testResults`	text (multi-line)	Test Results.
`lastTestTime`	datetime	Last Test Run.
`testStatus`	enum	Valid ids: `1` (Passed), `2` (Failed), `3` (Not Run), `4` (Running).
`lintEnabled`	boolean	Lint Enabled.
`lintResults`	text (multi-line)	Lint Results.

Security Configuration

Field	Type	Notes
`securityScan`	boolean	Security Scan Enabled.
`lastSecurityScan`	datetime	Last Security Scan.
`vulnerabilities`	text (multi-line)	Known vulnerabilities
`criticalCount`	number	Critical Issues.
`highCount`	number	High Issues.
`mediumCount`	number	Medium Issues.
`lowCount`	number	Low Issues.

Access Control

Field	Type	Notes
`rbacEnabled`	boolean	RBAC Enabled.
`serviceAccount`	text	K8s service account
`securityContext`	text (multi-line)	Pod security context (JSON)
`imagePullSecrets`	text (multi-line)	Registry credentials
`networkPolicies`	boolean	Network Policies Enabled.
`podSecurityPolicy`	text	Pod Security Policy.

GitOps Integration

Field	Type	Notes
`gitopsEnabled`	boolean	GitOps Enabled.
`gitopsProvider`	enum	Valid ids: `1` (None), `2` (ArgoCD), `3` (FluxCD), `4` (Jenkins X), `5` (Spinnaker).
`gitRepo`	text (URL)	Git Repository.
`gitBranch`	text	Git Branch.
`gitPath`	text	Git Path.
`syncPolicy`	enum	Valid ids: `1` (Manual), `2` (Automatic), `3` (Automatic with Prune).

CI/CD Integration

Field	Type	Notes
`cicdPipeline`	text	CI/CD Pipeline.
`autoUpgrade`	boolean	Auto Upgrade.
`upgradeSchedule`	text	Cron format
`webhookURL`	text (URL)	Webhook URL.
`notificationChannels`	text (multi-line)	Slack, email, etc.
`approvalRequired`	boolean	Approval Required.
`approvers`	text (multi-line)	List of approvers

Chart Metrics

Field	Type	Notes
`deploymentDuration`	number	Deployment Duration (sec).
`resourceUtilization`	gauge	Resource Utilization %.
`healthScore`	gauge	Health Score.
`availability`	gauge	Availability %.
`failureCount`	number	Failure Count (30d).
`rollbackCount`	number	Rollback Count (30d).
`upgradeCount`	number	Upgrade Count (30d).
`mttr`	number	Mean time to recovery

Cost Analysis

Field	Type	Notes
`estimatedMonthlyCost`	number	Est. Monthly Cost.
`actualMonthlyCost`	number	Actual Monthly Cost.
`cpuCost`	number	CPU Cost.
`memoryCost`	number	Memory Cost.
`storageCost`	number	Storage Cost.
`networkCost`	number	Network Cost.
`licenseCost`	number	License Cost.
`supportCost`	number	Support Cost.
`costCenter`	text	Cost Center.
`billingCode`	text	Billing Code.

Helm Events

Field	Type	Notes
`events`	text (multi-line)	Last 50 Helm events
`lastEventTime`	datetime	Last Event.
`errorEvents`	number	Error Events (24h).
`warningEvents`	number	Warning Events (24h).
`infoEvents`	number	Info Events (24h).

Relationships

Lookups: namespace points at a K8SNAMESPACE record; parentChart points at a K8SHELM record.

Creating a K8s Helm Chart via the API

POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json

{
  "entity":   "K8SHELM",
  "level":    410,
  "comboKey": "SUB:<your-sub-id>|ENT:",
  "name": "Example",
  "namespace": "",
  "status": "1",
  "releaseName": "Example"
}

Listing K8s Helm Charts

# All records in your tenant
GET /v1/entities/K8SHELM/SUB:<your-sub-id>

DemandFlow Support Centre

K8SHELM: K8s Helm Chart

K8SHELM: K8s Helm Chart

Entity properties

Use cases

Fields

Relationships

Creating a K8s Helm Chart via the API

Listing K8s Helm Charts

See also

Was this article helpful?