#Ambient Mode Quick Start

This quick start lists the operations required to build, and then remove, a complete Alauda Service Mesh v2 environment in ambient mode, together with the sample application and the observability stack.

Each item names the operations involved and links to the document that covers them in detail.

#Installation

Perform the following operations in order:

1. Install Istio ambient mode — Install the Alauda Service Mesh v2 Operator, then create the IstioCNI, Istio (with the ambient profile), and ZTunnel resources. See Installing Istio ambient mode.
2. Configure monitoring — Create the ServiceMonitor, PodMonitor, and Telemetry resources so that the control plane and the mesh proxies expose metrics. Monitoring is required to run Kiali, the dedicated console for Istio. See Metrics and Service Mesh.
3. Deploy the Bookinfo application — Create the bookinfo namespace, add it to the ambient data plane with the istio.io/dataplane-mode label, deploy the sample application, and verify that traffic is carried over HBONE. See Deploying the Bookinfo application in ambient mode.
4. Install Alauda Distributed Tracing — Install the Alauda Build of OpenTelemetry v2 Operator, then deploy a Jaeger v2 instance backed by OpenSearch and an OpenTelemetry Collector. See Installing Alauda Distributed Tracing with OpenSearch.
5. Configure tracing for the mesh — Enable tracing and define the OpenTelemetry extension provider on the Istio resource, then reference that provider and set the sampling rate on the Telemetry resource. See Configuring distributed tracing platform with Service Mesh.
6. Install Alauda Build of Kiali — Install the Alauda Build of Kiali Operator, create the Kiali resource, connect it to the monitoring data source, and integrate it with the distributed tracing platform. See Alauda Build of Kiali.
7. Deploy a waypoint proxy — Deploy a waypoint proxy for the bookinfo namespace with the Kubernetes Gateway API to enable L7 traffic management, authorization, and observability. See Waypoint proxies.

#Cleanup

Perform the following operations in order to remove everything created above:

1. Uninstall Alauda Build of Kiali — Delete the Kiali resource and uninstall the Alauda Build of Kiali Operator. See Uninstalling Alauda Build of Kiali.
2. Uninstall Alauda Distributed Tracing — Delete the OpenTelemetry Collector and the Jaeger v2 instance, and uninstall the Alauda Build of OpenTelemetry v2 Operator. See Uninstalling Alauda Distributed Tracing.
3. Uninstall Alauda Service Mesh in ambient mode — Delete the waypoint proxy Gateway resources, remove the ambient data plane label from the namespaces, delete the ZTunnel, Istio, and IstioCNI resources, uninstall the Alauda Service Mesh v2 Operator, and delete the ztunnel, istio-system, and istio-cni namespaces. See Uninstalling Alauda Service Mesh in ambient mode.
4. Remove the Bookinfo application — Remove the bookinfo namespace from the ambient data plane and delete it. See Cleanup.