Package :



Table of Contents


Field Type Label Description


A VirtualHost is used to configure routes. It is selected by a VirtualGateway, and may be attached to more than one gateway. The VirtualHost contains the top-level configuration and route options, such as domains to match against, and any options to be shared by its routes. Routes can send traffic directly to a service, or can delegate to a RouteTable to perform further routing decisions.

Field Type Label Description
domains []string repeated The list of domains (i.e.: matching the Host header of a request) that belong to this virtual host. Note that the wildcard will not match the empty string. e.g. “” will match “” but not “”. Additionally, a special entry “” is allowed which will match any host/authority header. Only a single virtual host on a gateway can match on “*”. A domain must be unique across all virtual hosts on a gateway or the config will be invalidated by Gloo Domains on virtual hosts obey the same rules as Envoy Virtual Hosts
routes [] repeated The list of HTTP routes define routing actions to be taken for incoming HTTP requests whose host header matches this virtual host. If the request matches more than one route in the list, the first route matched will be selected. If the list of routes is empty, the virtual host will be ignored by Gloo.
options Route table options contain additional configuration to be applied to all traffic served by the route table. Some configuration here can be overridden by Route Options. OutlierDetection and TrafficShift isn't supported on the route level.


Field Type Label Description
observedGeneration int64 The most recent generation observed in the the VirtualHost metadata. If the observedGeneration does not match metadata.generation, Gloo Mesh has not processed the most recent version of this resource.
state The state of the overall resource.
errors []string repeated Any errors found while processing this generation of the resource.
warnings []string repeated Any warnings found while processing this generation of the resource.
attachedVirtualGateways [] repeated List of each VirtualGateway which has selected this VirtualHost
selectedRouteTables [] repeated List of RouteTables that this Route table delegates to
appliedTrafficPolicies [] repeated The set of TrafficPolicies that have been applied to this Destination. {{/* Note: validation of this field disabled because it slows down cue tremendously*/}}