Specify a global access policy for all Workloads and Destinations associated with this VirtualMesh.
VirtualMeshSpec.Federation
“Federation” refers to the ability to expose Destinations across service mesh boundaries, i.e. to traffic originating from Workloads external to the Destination's Mesh.
Expose all Destinations to all Workloads in this VirtualMesh.
flatNetwork
bool
If true, all multicluster traffic will be routed directly to the Kubernetes service endpoints of the Destinations, rather than through an ingress gateway. This mode requires a flat network environment. This feature is exclusive to Gloo Mesh Enterprise.
hostnameSuffix
string
Configure the suffix for hostnames of Destinations federated within this VirtualMesh. Currently this is only supported for Istio with smart DNS proxying enabled, otherwise setting this field results in an error. If omitted, the hostname suffix defaults to “global”.
VirtualMeshSpec.MTLSConfig
Specify mTLS options. This includes options for configuring Mutual TLS within an individual mesh, as well as enabling mTLS across Meshes by establishing cross-mesh trust.
Limited trust (selectively allow communication between Workloads and Destinations in the grouped Meshes). Currently not available.
autoRestartPods
bool
Specify whether to allow Gloo Mesh to restart Kubernetes Pods when certificates are rotated when establishing shared trust. If this option is not explicitly enabled, users must restart Pods manually for the new certificates to be picked up. meshctl provides the command meshctl mesh restart to simplify this process, see here for more info.
VirtualMeshSpec.MTLSConfig.LimitedTrust
Limited trust is a trust model which does not require trusting Meshes to share the same root certificate or identity. Instead, trust is established between different Meshes by connecting their ingress/egress gateways with a common certificate/identity. In this model all requests between different have the following request path when communicating between clusters cluster 1 MTLS shared MTLS cluster 2 MTLS client/workload <-----------> egress gateway <----------> ingress gateway <--------------> server This approach has the downside of not maintaining identity from client to server, but allows for ad-hoc addition of additional Meshes into a VirtualMesh.
VirtualMeshSpec.MTLSConfig.SharedTrust
Shared trust is a trust model requiring a common root certificate shared between trusting Meshes, as well as shared identity between all Workloads and Destinations which wish to communicate within the VirtualMesh.
Configure a Root Certificate Authority which will be shared by all Meshes associated with this VirtualMesh. If this is not provided, a self-signed certificate will be generated by Gloo Mesh.
VirtualMeshSpec.RootCertificateAuthority
Specify parameters for configuring the root certificate authority for a VirtualMesh.
Configuration for generating a self-signed root certificate. Uses the X.509 format, RFC5280.
Field
Type
Label
Description
ttlDays
uint32
Number of days before root cert expires. Defaults to 365.
rsaKeySizeBytes
uint32
Size in bytes of the root cert's private key. Defaults to 4096.
orgName
string
Root cert organization name. Defaults to “gloo-mesh”.
VirtualMeshStatus
Field
Type
Label
Description
observedGeneration
int64
The most recent generation observed in the the VirtualMesh metadata. If the observedGeneration does not match metadata.generation, Gloo Mesh has not processed the most recent version of this resource.