Mesh Discovery

Gloo Mesh can automatically discover service mesh installations on registered clusters using control plane and sidecar discovery, as well as workloads and services exposed through the service mesh.

In this guide we will learn about the four main discovery capabilities in the context of Kubernetes as the compute platform:

  1. Kubernetes Clusters
    • Representation of a cluster that Gloo Mesh is aware of and is authorized to talk to its Kubernetes API server
    • note: this resource is created by meshctl at cluster registration time
  2. Meshes
    • Representation of a service mesh control plane that has been discovered
  3. Workloads
    • Representation of a pod that is a member of a service mesh; this is often determined by the presence of an injected proxy sidecar
  4. Destinations
    • Representation of a Kubernetes service that is backed by Workload pods, e.g. pods that are a member of the service mesh

Before you begin

To illustrate these concepts, we will assume that:

Be sure to review the assumptions and satisfy the pre-requisites from the Guides top-level document.

Discover Kubernetes Clusters

Ensure that your kubeconfig has the correct context set as its currentContext:

kubectl config use-context $MGMT_CONTEXT

Validate that the cluster have been registered by checking for KubernetesClusters custom resources:

kubectl get kubernetesclusters -n gloo-mesh
NAME                 AGE
mgmt-cluster         23h
remote-cluster       23h

Discover Meshes

Check to see that Istio has been discovered:

meshctl describe mesh
| Namespace: istio-system     |                |                   |
| Cluster: mgmt-cluster       |                |                   |
| Type: istio                 |                |                   |
| Version: 1.8.1              |                |                   |
|                             |                |                   |
| Namespace: istio-system     |                |                   |
| Cluster: remote-cluster     |                |                   |
| Type: istio                 |                |                   |
| Version: 1.8.1              |                |                   |
|                             |                |                   |

We can print it in YAML form to see all the information we discovered:

kubectl -n gloo-mesh get mesh istiod-istio-system-remote-cluster -oyaml

(snipped for brevity)

kind: Mesh
  annotations: "1"
  generation: 2
  labels: remote-cluster "" gloo-mesh
  name: istiod-istio-system-remote-cluster
  namespace: gloo-mesh
  resourceVersion: "3218"
  selfLink: /apis/
  uid: 7c079983-3ece-4aed-b71a-bf56c8cd6267
    agentNamespace: gloo-mesh
      IstiodServiceAccount: istiod-service-account
      trustDomain: cluster.local
    - externalAddress:
      externalTlsPort: 32000
      tlsContainerPort: 15443
        istio: ingressgateway
      cluster: remote-cluster
      namespace: istio-system
        istio: pilot
      version: 1.8.1
  observedGeneration: 2

Discover Workloads

Check to see that the bookinfo pods have been correctly identified as Workloads:

kubectl -n gloo-mesh get workloads
NAME                                                            AGE
details-v1-bookinfo-mgmt-cluster-deployment                     3m54s
istio-ingressgateway-istio-system-mgmt-cluster-deployment       23h
istio-ingressgateway-istio-system-remote-cluster-deployment     23h
productpage-v1-bookinfo-mgmt-cluster-deployment                 3m54s
ratings-v1-bookinfo-mgmt-cluster-deployment                     3m53s
ratings-v1-bookinfo-remote-cluster-deployment                   3m25s
reviews-v1-bookinfo-mgmt-cluster-deployment                     3m53s
reviews-v2-bookinfo-mgmt-cluster-deployment                     3m53s
reviews-v3-bookinfo-remote-cluster-deployment                   2m

Discover Destinations

Similarly for the bookinfo services:

kubectl -n gloo-mesh get destinations
NAME                                                 AGE
details-bookinfo-mgmt-cluster                        4m23s
istio-ingressgateway-istio-system-mgmt-cluster       23h
istio-ingressgateway-istio-system-remote-cluster     23h
productpage-bookinfo-mgmt-cluster                    4m23s
ratings-bookinfo-mgmt-cluster                        4m22s
ratings-bookinfo-remote-cluster                      3m54s
reviews-bookinfo-mgmt-cluster                        4m22s
reviews-bookinfo-remote-cluster                      2m29s

See it in action

Check out “Part One” of the “Dive into Gloo Mesh” video series (note that the video content reflects Gloo Mesh v0.6.1):

Next Steps

Now that we have Istio installed, and we've seen Gloo Mesh discover the meshes across different clusters, we can now unify them into a single Virtual Mesh. See the guide on establishing shared trust domain for multiple meshes.