References
Proto: references.proto
Package: common.gloo.solo.io
Types:
DestinationReference
Destinations point to the upstream services that fulfill client requests on matching routes that you set up, such as in a route table. Each destination must resolve to one and only one hostname.
Destinations can refer to a variety of resources. The behavior of the route action varies depending on the kind of destination.
Currently supported destination types are:
- Kubernetes
Service, the default destination. - Gloo
VirtualDestinationto route traffic to one of the VirtualDestination's backing Kubernetes services. - Gloo
ExternalServiceto route traffic to a static set of service endpoints that are external to your mesh setup. - Gloo
CloudProviderto route traffic to a cloud provider function such as AWS Lambdas, selected by using thefunctionCallfield.
HTTP routes support all destinations. TCP routes support only Kubernetes Service and Gloo VirtualDestination destinations.
| Field | Description |
|---|---|
ref |
(ObjectReference)reference to the destination object by its metadata |
kind |
(DestinationKind)the kind of destination being selected. defaults to Kubernetes Service. |
port |
(PortSelector)the port on the destination object being targeted. required if the object provides more than one port. |
subset |
(repeated DestinationReference.SubsetEntry)select a subset of the destination's endpoints for routing based on their labels. Not applicable for a CloudProvider destination. |
weight |
(uint32)Specify the proportion of traffic to be forwarded to this destination. Weights across all of the destinations must sum to 100. Weight is only relevant when used in the context of a route with multiple destinations. |
function |
(FunctionDestinationSpec) |
DestinationReference.SubsetEntry
| Field | Description |
|---|---|
key |
(string) |
value |
(string) |
ListenerPortReference
ListenerPortReference identifies a single listener in a VirtualGateway by port number
| Field | Description |
|---|---|
gatewayRef |
(ObjectReference)The gateway containing the listener. |
port |
(uint32)The port of the listener on the gateway. |
ObjectReference
reference to a Kubernetes API object. Kube API objects are referenced explicitly by the namespace and cluster containing them.
| Field | Description |
|---|---|
name |
(string)the name of the object |
namespace |
(string)the namespace of the object. if the field is omitted, Gloo Mesh will use the same namespace as the parent object containing this reference. |
cluster |
(string)the cluster of the object. if the field is omitted, Gloo Mesh will use the same cluster as the parent object containing this reference. |
ObjectReferenceList
| Field | Description |
|---|---|
refs |
(repeated ObjectReference) |
WorkloadReference
| Field | Description |
|---|---|
ref |
(ObjectReference) |
kind |
(WorkloadReference.WorkloadKind) |
WorkloadReference.WorkloadKind
References the supported types for the Workload interface in pkg/utils/workloadutils/workload_types.go
| Name | Number | Description |
|---|---|---|
DEPLOYMENT |
0 | |
DAEMON_SET |
1 | |
STATEFUL_SET |
2 | |
REPLICA_SET |
3 |