For the complete documentation index, see llms.txt.
Skip to main content
Version: 8.9

Configure Kubernetes Service ports

The Camunda Helm chart exposes an appProtocols value per component that sets the Kubernetes appProtocol field on a Service port. Use this when your infrastructure needs an explicit protocol hint instead of relying on protocol sniffing. For example, a GKE NEG-backed Ingress or Gateway handling HTTP/2 cleartext (h2c) gRPC traffic to the orchestration cluster gateway.

appProtocol per Service port

Each component's service.appProtocols value accepts a map of logical port key to appProtocol value. It's empty by default and doesn't change existing behavior until you set it.

The following components support appProtocols (the accepted logical port keys for each component are listed in the last column). These keys are fixed and don't change if you override a component's *Name value (for example, orchestration.service.grpcName). Always use the logical key (grpc), not the renamed Service port. Setting a key outside the accepted list fails the Helm render instead of being silently ignored.

ComponentValue keyAccepted logical port keys
Orchestration clusterorchestration.service.appProtocolsmanagement, internal, command, http, grpc
Consoleconsole.service.appProtocolshttp, management
Identityidentity.service.appProtocolshttp, metrics
Optimizeoptimize.service.appProtocolshttp, management
Connectorsconnectors.service.appProtocolsserver
Web Modeler REST APIwebModeler.restapi.service.appProtocolshttp, http-management
Web Modeler WebSocketswebModeler.websockets.service.appProtocolshttp

Example: set the orchestration cluster gRPC gateway port to use kubernetes.io/h2c for HTTP/2 cleartext framing:

orchestration:
service:
appProtocols:
grpc: kubernetes.io/h2c