ballerinax/istio module

Module Detail

Records

Record Description
DestinationConfig Configuration to a network addressable service.
DestinationWeightConfig Configuration for weight for destination to traffic route.
GatewayConfig Istio gateway annotation configuration.
HTTPRouteConfig Configurations for conditions and actions for routing HTTP.
PortConfig Port of a service.
ServerConfig Istio gateway server configuration to describe the properties of the proxy on a given load balancer.
TLSOptionConfig Istio gateway server tls option configurations.
VirtualServiceConfig Virtual service configuration for @istio:VirtualService annotation.

Type Definitions

Type Values Description
PortProtocol TLS | TCP | MONGO | HTTPS | HTTP2 | HTTP | GRPC

Types of protocols of a port.

TLSOptionMode SIMPLE | PASSTHROUGH | MUTUAL

TLS mode enforced by the proxy.

Annotations

Name Attaches To Data Type Description
Gateway service, listener GatewayConfig

@istio:Gateway annotation to generate istio gateways.

VirtualService service, listener VirtualServiceConfig

@istio:VirtualService annotation to generate istio virtual service.

public type DestinationConfig

Configuration to a network addressable service.

Field Name Data Type Default Value Description
host string

Host of a service.

subset string

Subset within the service.

port int

The port on the host that is being addressed.

public type DestinationWeightConfig

Configuration for weight for destination to traffic route.

Field Name Data Type Default Value Description
destination istio:DestinationConfig

Destination to forward to.

weight int

Weight for the destination.

public type GatewayConfig

Istio gateway annotation configuration.

Field Name Data Type Default Value Description
name string

Name of the resource

labels map<string>

Map of labels for the resource

annotations map<string>

Map of annotations for resource

selector map<string>

Specific set of pods/VMs on which this gateway configuration should be applied.

servers istio:ServerConfig?[]

List of servers to pass.

public type HTTPRouteConfig

Configurations for conditions and actions for routing HTTP.

Field Name Data Type Default Value Description
route istio:DestinationWeightConfig[]

Route destination.

timeout int

Timeout for requests in seconds.

appendHeaders map<string>

Additional header to add before forwarding/directing.

public type PortConfig

Port of a service.

Field Name Data Type Default Value Description
number int

The port number.

protocol HTTP|HTTPS|GRPC|HTTP2|MONGO|TCP|TLS

The protocol exposed by the port.

name string

Label for the port.

public type ServerConfig

Istio gateway server configuration to describe the properties of the proxy on a given load balancer.

Field Name Data Type Default Value Description
port istio:PortConfig

The port of the proxy.

hosts string[]

List of hosts exposed by the gateway.

tls istio:TLSOptionConfig

TLS options.

public type TLSOptionConfig

Istio gateway server tls option configurations.

Field Name Data Type Default Value Description
httpsRedirect boolean false

If set to true, the load balancer will send a 301 redirect for all http connections, asking the clients to use HTTPS.

mode PASSTHROUGH|SIMPLE|MUTUAL

Indicates whether connections to this port should be secured using TLS. The value of this field determines how TLS is enforced.

serverCertificate string

REQUIRED if mode is SIMPLE or MUTUAL. The path to the file holding the server-side TLS certificate to use.

privateKey string

REQUIRED if mode is SIMPLE or MUTUAL. The path to the file holding the server’s private key.

caCertificates string

REQUIRED if mode is MUTUAL. The path to a file containing certificate authority certificates to use in verifying a presented client side certificate.

subjectAltNames string[]

A list of alternate names to verify the subject identity in the certificate presented by the client.

public type VirtualServiceConfig

Virtual service configuration for @istio:VirtualService annotation.

Field Name Data Type Default Value Description
name string

Name of the resource

labels map<string>

Map of labels for the resource

annotations map<string>

Map of annotations for resource

hosts string[]

Destination which traffic should be sent.

gateways string[]

Names of the gateways which the service should listen to.

http istio:HTTPRouteConfig[]

Route rules for HTTP traffic.