mesh.proto

Package : discovery.mesh.gloo.solo.io

Top

mesh.proto

Table of Contents

MeshSpec

Describes a service mesh control plane deployment.

Field Type Label Description
istio discovery.mesh.gloo.solo.io.MeshSpec.Istio Describes an Istio service mesh.
awsAppMesh discovery.mesh.gloo.solo.io.MeshSpec.AwsAppMesh Describes an AWS App Mesh service mesh.
linkerd discovery.mesh.gloo.solo.io.MeshSpec.LinkerdMesh Describes a Linkerd service mesh.
consulConnect discovery.mesh.gloo.solo.io.MeshSpec.ConsulConnectMesh Describes a Consul Connect service mesh.
osm discovery.mesh.gloo.solo.io.MeshSpec.OSM Describes an Open Service Mesh service mesh.
agentInfo discovery.mesh.gloo.solo.io.MeshSpec.AgentInfo Describes the Gloo Mesh agent if it has been installed to the managed cluster.

MeshSpec.AgentInfo

Describes the Gloo Mesh agent which may be installed to the managed cluster containing the mesh control plane.

Field Type Label Description
agentNamespace string The namespace in which the Gloo Mesh agent is installed.

MeshSpec.AwsAppMesh

Describes an AWS App Mesh instance.

Field Type Label Description
awsName string The AWS name for the App Mesh instance, must be unique across all AppMesh instances owned by the AWS account.
region string The AWS region the App Mesh control plane resources exist in.
awsAccountId string The AWS Account ID associated with the Mesh. Populated at REST API registration time.
arn string The unique AWS ARN associated with the App Mesh instance.
clusters []string repeated The Kubernetes clusters on which sidecars for this App Mesh instance have been discovered.

MeshSpec.ConsulConnectMesh

Describes a ConsulConnect deployment.

Field Type Label Description
installation discovery.mesh.gloo.solo.io.MeshSpec.MeshInstallation Describes the ConsulConnect control plane deployment.

MeshSpec.Istio

Describes an Istio deployment.

Field Type Label Description
installation discovery.mesh.gloo.solo.io.MeshSpec.MeshInstallation Describes the Istio control plane deployment.
trustDomain string The Istio trust domain used for https/spiffe identity. If empty will default to “cluster.local”.
istiodServiceAccount string The istiod service account which determines identity for the Istio CA cert.
ingressGateways []discovery.mesh.gloo.solo.io.MeshSpec.Istio.IngressGatewayInfo repeated Describes the ingress gateway.
smartDnsProxyingEnabled bool True if smart DNS proxying is enabled, which allows for arbitrary DNS domains.

MeshSpec.Istio.IngressGatewayInfo

Describes the ingress gateway.

Field Type Label Description
workloadLabels []discovery.mesh.gloo.solo.io.MeshSpec.Istio.IngressGatewayInfo.WorkloadLabelsEntry repeated Labels matching the workload backing the gateway. Defaults to {"istio": "ingressgateway"}.
externalAddress string DEPRECATED: in favor of dns_name or external_ip
dnsName string Will be populated if the LoadBalancer Address is a DNS name
ip string Will be populated if the LoadBalancer Address is an IP
externalTlsPort uint32 The externally-reachable port on which the gateway is listening for TLS connections. This will be the port used for cross-cluster connectivity. See the list of common ports used by Istio. Defaults to 15443 (or the NodePort) of the Kubernetes service (depending on its type).
tlsContainerPort uint32 Container port on which the gateway is listening for TLS connections. Defaults to 15443.

MeshSpec.Istio.IngressGatewayInfo.WorkloadLabelsEntry

Field Type Label Description
key string
value string

MeshSpec.LinkerdMesh

Describes a Linkerd deployment.

Field Type Label Description
installation discovery.mesh.gloo.solo.io.MeshSpec.MeshInstallation Describes the Linkerd control plane deployment.
clusterDomain string The cluster domain suffix this Linkerd mesh is configured with. See this reference for more info.

MeshSpec.MeshInstallation

Describes the Kubernetes cluster on which the control plane for this mesh is deployed. Only self-hosted control planes such as Istio, Linkerd, OSM, and ConsulConnect will have installation metadata.

Field Type Label Description
namespace string Namespace in which the control plane has been installed.
cluster string The Gloo Mesh cluster in which the control plane has been installed.
podLabels []discovery.mesh.gloo.solo.io.MeshSpec.MeshInstallation.PodLabelsEntry repeated The labels on the control plane pods (read from the deployment).
version string The version of the Mesh that has been installed, which is determined using the image tag on the mesh's primary control plane image (e.g. the istio-pilot image tag).
region string The region of the cluster in which the control plane has been installed, which is determined from the value of the Kubernetes region topology label on any Kubernetes node associated with the cluster of this mesh.

MeshSpec.MeshInstallation.PodLabelsEntry

Field Type Label Description
key string
value string

MeshSpec.OSM

Describes an OSM deployment.

Field Type Label Description
installation discovery.mesh.gloo.solo.io.MeshSpec.MeshInstallation Describes the OSM control plane deployment.

MeshStatus

Field Type Label Description
observedGeneration int64 The observed generation of the Mesh. When this matches the Mesh's metadata.generation, it indicates that Gloo Mesh has processed the latest version of the Mesh.
appliedVirtualMesh discovery.mesh.gloo.solo.io.MeshStatus.AppliedVirtualMesh The VirtualMesh, if any, which contains this mesh.
appliedVirtualDestinations []discovery.mesh.gloo.solo.io.MeshStatus.AppliedVirtualDestination repeated The VirtualDestinations, if any, which apply to this mesh.

MeshStatus.AppliedVirtualDestination

Describes a VirtualDestination that applies to this Mesh.

Field Type Label Description
ref core.skv2.solo.io.ObjectRef Reference to the applied VirtualDestination object.
observedGeneration int64 The observed generation of the accepted VirtualDestination.
errors []string repeated Any errors encountered while processing the VirtualDestination.

MeshStatus.AppliedVirtualMesh

Describes a VirtualMesh that applies to this Mesh. If an existing applied VirtualMesh becomes invalid, the last applied VirtualMesh will be used.

Field Type Label Description
ref core.skv2.solo.io.ObjectRef Reference to the applied VirtualMesh object.
observedGeneration int64 The observed generation of the accepted VirtualMesh.
spec networking.mesh.gloo.solo.io.VirtualMeshSpec The spec of the last known valid VirtualMesh.