traffic_target.proto

Package : discovery.mesh.gloo.solo.io

Top

traffic_target.proto

Table of Contents

SubLocality

A subdivision of a region representing a set of physically colocated compute resources.

Field Type Label Description
zone string
subZone string

TrafficTargetSpec

The TrafficTarget is an abstraction for a traffic target which we have discovered to be part of a given mesh.

Field Type Label Description
kubeService discovery.mesh.gloo.solo.io.TrafficTargetSpec.KubeService Metadata about the kube-native traffic target backing this TrafficTarget.
mesh core.skv2.solo.io.ObjectRef The mesh with which this traffic target is associated.

TrafficTargetSpec.KubeService

Field Type Label Description
ref core.skv2.solo.io.ClusterObjectRef A reference to the kube-native traffic target that this TrafficTarget represents.
workloadSelectorLabels []discovery.mesh.gloo.solo.io.TrafficTargetSpec.KubeService.WorkloadSelectorLabelsEntry repeated Selectors for the set of pods targeted by the k8s Service.
labels []discovery.mesh.gloo.solo.io.TrafficTargetSpec.KubeService.LabelsEntry repeated Labels on the underlying k8s Service itself.
ports []discovery.mesh.gloo.solo.io.TrafficTargetSpec.KubeService.KubeServicePort repeated The ports exposed by the underlying service.
subsets []discovery.mesh.gloo.solo.io.TrafficTargetSpec.KubeService.SubsetsEntry repeated Subsets for routing, based on labels.
region string The region the service resides in, typically representing a large geographic area. All of the service's endpoints will be in this region.
endpointSubsets []discovery.mesh.gloo.solo.io.TrafficTargetSpec.KubeService.EndpointsSubset repeated Each endpoints subset is a group of endpoints arranged in terms of IP/port pairs. This API mirrors the Kubernetes Endpoints API.

TrafficTargetSpec.KubeService.EndpointsSubset

A series of IP addresses and their associated ports. The list of IP + port pairs is the cartesian product of the two lists.

Field Type Label Description
endpoints []discovery.mesh.gloo.solo.io.TrafficTargetSpec.KubeService.EndpointsSubset.Endpoint repeated
ports []discovery.mesh.gloo.solo.io.TrafficTargetSpec.KubeService.KubeServicePort repeated

TrafficTargetSpec.KubeService.EndpointsSubset.Endpoint

An endpoint exposed by the service

Field Type Label Description
ipAddress string IP address
labels []discovery.mesh.gloo.solo.io.TrafficTargetSpec.KubeService.EndpointsSubset.Endpoint.LabelsEntry repeated Labels which belong to this IP. These are taken from the backing workload instance.
subLocality discovery.mesh.gloo.solo.io.SubLocality The zone/sub-zone of the endpoint.

TrafficTargetSpec.KubeService.EndpointsSubset.Endpoint.LabelsEntry

Field Type Label Description
key string
value string

TrafficTargetSpec.KubeService.KubeServicePort

Field Type Label Description
port uint32 External-facing port for this k8s service (NOT the service's target port on the backing pods).
name string
protocol string
appProtocol string Available in k8s 1.18+, specifies the application protocol.

TrafficTargetSpec.KubeService.LabelsEntry

Field Type Label Description
key string
value string

TrafficTargetSpec.KubeService.Subset

Subsets for routing, based on labels.

Field Type Label Description
values []string repeated

TrafficTargetSpec.KubeService.SubsetsEntry

Field Type Label Description
key string
value discovery.mesh.gloo.solo.io.TrafficTargetSpec.KubeService.Subset

TrafficTargetSpec.KubeService.WorkloadSelectorLabelsEntry

Field Type Label Description
key string
value string

TrafficTargetStatus

Field Type Label Description
observedGeneration int64 The most recent generation observed in the the TrafficPolicy metadata. if the observedGeneration does not match generation, the controller has not received the most recent version of this resource.
appliedTrafficPolicies []discovery.mesh.gloo.solo.io.TrafficTargetStatus.AppliedTrafficPolicy repeated The set of Traffic Policies that have been applied to this TrafficTarget
appliedAccessPolicies []discovery.mesh.gloo.solo.io.TrafficTargetStatus.AppliedAccessPolicy repeated The set of Access Policies that have been applied to this TrafficTarget
localFqdn string The local fully qualified domain
appliedFederation discovery.mesh.gloo.solo.io.TrafficTargetStatus.AppliedFederation Federation metadata. Only populated if this traffic target is federated through a VirtualMesh.

TrafficTargetStatus.AppliedAccessPolicy

AppliedAccessPolicy represents a access policy that has been applied to the TrafficTarget. if an existing Access Policy becomes invalid, the last applied policy will be used

Field Type Label Description
ref core.skv2.solo.io.ObjectRef reference to the access policy
observedGeneration int64 the observed generation of the accepted access policy
spec networking.mesh.gloo.solo.io.AccessPolicySpec the last known valid spec of the access policy

TrafficTargetStatus.AppliedFederation

Federation policy applied to this TrafficTarget, allowing access to the traffic target from other meshes/clusters.

Field Type Label Description
federatedHostname string For any workload that this traffic target has federated to (i.e., any Workload controlled by a mesh whose ref appears in federated_to_meshes), a client in that workload will be able to reach this traffic target at this DNS name. This includes workloads on clusters other than the one hosting this service.
federatedToMeshes []core.skv2.solo.io.ObjectRef repeated The list of Meshes which are able to resolve this service's multicluster_dns_name.
flatNetwork bool Whether or not the TrafficTarget has been federated via a flat-network to the given meshes.

TrafficTargetStatus.AppliedTrafficPolicy

AppliedTrafficPolicy represents a traffic policy that has been applied to the TrafficTarget. if an existing Traffic Policy becomes invalid, the last applied policy will be used

Field Type Label Description
ref core.skv2.solo.io.ObjectRef reference to the traffic policy
observedGeneration int64 the observed generation of the accepted traffic policy
spec networking.mesh.gloo.solo.io.TrafficPolicySpec the last known valid spec of the traffic policy