Skip to main content

Tls Route

TlsRoute​

Routing intent for encrypted TLS traffic.

Routes streams by Server Name Indication (SNI) and Application-Layer Protocol Negotiation (ALPN) without decryption at the gateway.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be TlsRoute.
metadatamapThe engine reads reserved keys such as name and project to resolve the manifest identity and its parent ingress (PublicIngress or PrivateIngress).
specSpecUser-authored TLS route specification.

Target​

Resolved backend target of the route.

NOT YET IMPLEMENTED. The engine neither sets nor reads it.

PropertyTypeDescription
kindstringKind of the resolved target.
namestringName of the resolved target manifest.

Spec​

User-defined TLS routing rules.

The engine makes service-mesh TLS route rules on the parent ingress.

PropertyTypeDescription
descriptionstringOptional free text that describes the route. It appears in generated documentation. The engine does not use it.
ruleslist of RuleOrdered list of match-and-forward rules. Each rule becomes a mesh TLS route rule on the parent ingress.

Rule​

A single TLS routing rule.

A connection uses the first rule whose match conditions it satisfies.

PropertyTypeDescription
matcheslist of MatchHandshake match blocks. The rule applies when a connection satisfies any of them.

Action​

Forwarding action for matched connections.

Defines the weighted backend destinations and the idle timeout.

PropertyTypeDescription
destinationslist of DestinationWeighted backend destinations that receive the traffic of matched connections.
idleTimeoutstringGo-style duration (for example 30s) after which an idle connection with no bytes transferred closes. Empty keeps the platform default.

Destination​

A weighted backend destination.

A backend service (through a DeploymentConfig) and its share of matched traffic.

PropertyTypeDescription
deploymentConfigstringName of the DeploymentConfig manifest whose backend service receives matched connections.
portint64Port on the target DeploymentConfig to route to. It selects the backend-service-<port> resource. Value 0 selects the default backend service.
weightint64Share of matched traffic for this destination, from 0 to 100. Value 0 (unset) means 100.

Match​

TLS handshake match conditions.

Criteria on the TLS ClientHello that a connection must satisfy.

PropertyTypeDescription
sniHostlist of stringSNI hostnames. A connection matches when its SNI equals one entry.
alpnlist of stringALPN protocols. Each must be http/1.1 or h2.