Proxy Ingress and Load Balancer Configuration

Proxy Ingress Configuration Properties describes the properties used to configure an Ingress for the RS Gateway, My MATRIXX, and MATRIXX Backoffice Customer Tool web apps.

Note: An Ingress controller is also required. For information about installing and configuring an Ingress controller and load balancer, see the discussion about Ingress.

Table 1. Proxy Ingress Configuration Properties
Property	Description
proxyingress.enabled	Set to `true` to enable the creation of the Proxy Ingress. The default value is `false`.
proxyingress.annotations	Any annotations to add to the Ingress. For more information about annotations, see Kubernetes documentation.
proxyingress.hosts	A list of host names for the Ingress.
proxyingress.tlsSecretName	The name of the Kubernetes secret with the TLS certificate. Host names specified with `proxyingress.hosts` should match the CN entries within the certificate.
proxyingress.paths.rsgateway	The Ingress path to map to the RS Gateway Service. The default value is `/rsgateway`.
proxyingress.paths.matrixxbct	The Ingress path to map to the MATRIXX Backoffice Customer Tool Service. The default value is `/matrixxbct`.
proxyingress.paths.mymatrixx	The Ingress path to map to the My MATRIXX Service. The default value is `/matrixx`.

Ingress paths map an incoming request to the service. For example, the default setting of the proxyingress.paths.rsgateway property causes a URL like http://domain/rsgateway to load an internal service at http://rsgateway-ag1/rsgateway.

Different Ingress controllers treat these path values differently. One ingress controller might match /rsgateway to /rsgateway, /rsgateway/ and /rsgateway/* by default, where others might need these mappings to be explicitly defined.

Values for the proxyingress.path properties are not aliases for the internal services. If an internal service is not present at the specified path, an HTTP 404 error is returned. Some Ingress controllers, such as the Nginx Ingress Controller, support aliasing using Kubernetes rewrite annotations. For more information about rewrite annotations, see Kubernetes documentation.

Load Balancer Configuration Properties describes the property for setting the load balancer implementation to use. This adds any annotations to services as required. This does not cause installation of any specific load balancer components or configuration. For more information, see the discussion about Ingress.

Table 2. Load Balancer Configuration Properties
Property	Description
global.loadBalancerType	The load balancer in use. Annotations are added to the relevant Services if this property is set. By default no load balancer is specified.