Controlling Kubernetes Object Names for the connectware-agent Helm Chart

Customize the naming of Kubernetes objects created by the connectware-agent Helm chart.

By default, Kubernetes objects created by the connectware-agent Helm chart use a naming convention that combines the Helm release name and chart name as prefixes. This ensures unique, non-conflicting object names across your cluster.

Default Naming Convention

The default naming pattern is: <release-name>-<chart-name>-<agent-name>

When the release name and chart name are identical, the chart automatically removes the duplicate prefix. For example, a release named connectware-agent with an agent named bender-robots creates a StatefulSet named connectware-agent-bender-robots instead of connectware-agent-connectware-agent-bender-robots.

Customizing Object Names

Customize the naming convention using two top-level Helm values:

Value	Description
nameOverride	Overrides the chart name (second part of the prefix).
fullnameOverride	Overrides the entire prefix (both release and chart name). Set to "" to remove the prefix.

Set both values at the top level of your values.yaml file, outside of protocolMapperAgentDefaults and protocolMapperAgents.

Changing the name of Kubernetes objects after deploying an agent orphans existing objects and creates new ones. Configure the naming convention before deploying agents.

Using nameOverride

To replace the chart name portion of the prefix, set nameOverride in your values.yaml file. For an installation named agents with nameOverride set to cw-agent:

values.yaml

nameOverride: cw-agent
protocolMapperAgents:
  - name: bender-robots

Result: StatefulSet named agents-cw-agent-bender-robots.

Using fullnameOverride with a Custom Prefix

To replace the entire prefix with a custom string, set fullnameOverride in your values.yaml file. For an installation named connectware-agents with fullnameOverride set to my-agents:

values.yaml

fullnameOverride: my-agents
protocolMapperAgents:
  - name: bender-robots

Result: StatefulSet named my-agents-bender-robots.

Using fullnameOverride to Remove the Prefix

To remove the prefix entirely so object names match the agent name, set fullnameOverride to an empty string in your values.yaml file. For an installation named connectware-agents:

values.yaml

fullnameOverride: ''
protocolMapperAgents:
  - name: bender-robots

Result: StatefulSet named bender-robots.

Reference

For the full list of Helm values, see the Helm Chart Reference.