Configuring Container Image Parameters for the connectware-agent Helm Chart

Configure container image name and version for agents deployed with the connectware-agent Helm chart.

By default, agents deployed with the connectware-agent Helm chart use the official protocol-mapper image in a version that is coupled with the Helm chart version.

To find which image version is bundled with a given chart version, query the chart metadata. Replace ${VERSION} with the target Helm chart version:

helm show chart oci://repo.cybus.io/charts/connectware-agent --version ${VERSION} | grep appVersion

For compatible version ranges, see the Compatibility Matrix.

Changing the Agent Image Version

To use a specific image version, set the image.tag parameter in your values.yaml file:

values.yaml

protocolMapperAgentDefaults:
  image:
    tag: 2.1.0

Replace 2.1.0 with the desired image tag.

To override this setting for specific agents, set the same parameter inside the agents section in protocolMapperAgents, as described in Configuration Principles for the connectware-agent Helm Chart.

Changing the Agent Image Name

If you are using a custom protocol-mapper image instead of the official default, set the image.name parameter in your values.yaml file:

values.yaml

protocolMapperAgentDefaults:
  image:
    name: ${IMAGE_NAME}

Replace ${IMAGE_NAME} with the name of your custom image. This parameter only sets the image name, not the registry. If your custom image is hosted on a different registry, you also need to configure image.registry. See Using a Custom Registry for details.

To override this setting for specific agents, set the same parameter inside the agents section in protocolMapperAgents, as described in Configuration Principles for the connectware-agent Helm Chart.