Skip to content

Deployment architecture

The Istio service mesh can be logically divided into control plane and data plane components. The data plane is composed of a set of proxies which manage the network traffic between instances of the service mesh. The control plane generates and deploys the configuration that controls the data plane's behavior.

For detailed information on Istio architecture and different components, see Istio documentation.

Citrix ADC Integration with Istio control plane components

The Istio control plane is a set of gRPC based services and it pushes configuration changes to clients listening at the data plane. Pilot, Mixer, Galley, and Citadel are important control plane components. Out of these components, the data plane proxy primarily needs to interact with Pilot and Citadel.

Pilot is a gRPC based xDS server and provides configuration data to proxies. Citrix provides an xDS client called xDS-adaptor to communicate with the Istio control plane for installing Citrix ADCs in Istio service mesh. It acts as a gRPC client to the control plane API server and listens to updates. Based on the updates from the control plane, Citrix ADC xDS-adaptor generates the equivalent Citrix ADC configuration. Then, it configures the Citrix ADC ingress or proxy device accordingly.

Citadel is a control plane service which provides key and certificate management. It is responsible for providing TLS certificates to data plane proxies. Citrix ADC xDS-adaptor monitors secrets managed by Citadel, and updates the Citrix ADC proxy with relevant details.

Citrix service mesh solution provides a container, Citrix ADC Metrics Exporter, which collects the statistical data from Citrix ADC Ingress Gateway device and exports it to Prometheus.

Citrix also provides its own in-house solution Citrix ADC Observability Exporter for the telemetry purpose. Citrix ADC CPX running as a sidecar proxy interacts with the Citrix ADC Observability Exporter. Citrix ADC CPX sends metrics and transactions to Citrix ADC Observability Exporter. Citrix ADC Observability Exporter supports endpoints such as Zipkin and Prometheus, and sends the data collected from sidecar proxies to these endpoints in an appropriate format.

Citrix ADC can be integrated with Istio in three ways:

  • Citrix ADC CPX, MPX, or VPX as an Ingress Gateway to the service mesh
  • Citrix ADC CPX as a sidecar proxy with application containers in the service mesh

  • Citrix ADC CPX as an Egress Gateway for the service mesh

All the modes can be combined to have a unified data plane solution.

Deploy Citrix ADC as an Ingress Gateway

An Istio Ingress Gateway acts as an entry point for the incoming traffic to the service mesh. It secures and controls access to the service mesh from outside. You can deploy a Citrix ADC CPX, MPX, or VPX as an ingress Gateway to the Istio service mesh.

Citrix ADC CPX as an Ingress Gateway

The Citrix ADC CPX Ingress Gateway is deployed as a set of horizontal scaling Kubernetes pods. Each pod runs a Citrix ADC CPX that controls and routes the incoming requests. Each pod also runs an Citrix ADC xDS-adaptor container as a sidecar to the Citrix ADC. The Citrix ADC xDS-adaptor container establishes a connection with Istio control plane components, reads the ingress policies applied, and configures the Citrix ADC CPX accordingly.

The following diagram shows a sample deployment of Citrix ADC CPX as an Ingress Gateway.

CPX-ingress

For detailed instructions on how to deploy Citrix ADC CPX as an Ingress Gateway, see Deploying Citrix ADC with Istio.

Citrix ADC MPX or VPX as an Ingress Gateway

Citrix ADC VPX or MPX can be deployed as an Ingress Gateway to the Istio service mesh. In this deployment, a Kubernetes pod is deployed with an Citrix ADC xDS-adaptor container. The Citrix ADC xDS-adaptor container connects to the Istio control plane and reads the ingress configuration and then configures the Citrix ADC VPX or MPX accordingly.

Note: For this deployment, establish the connectivity between the concerned Citrix ADC and the cluster nodes.

The following diagram shows a sample deployment of Citrix ADC VPX/MPX as an Ingress Gateway.

VPX ingress

For detailed instructions on how to deploy Citrix ADC VPX or MPX as an Ingress Gateway, see Deploying Citrix ADC with Istio.

Deploy Citrix ADC CPXs as sidecars

Citrix ADC CPX can be deployed as a sidecar proxy in application pods. It intercepts all the incoming and outgoing traffic from the application pod and applies the configured routing policies or rules.

In this deployment, each application pod contains a Citrix ADC CPX and an Citrix ADC xDS-adaptor container along with the application container. The Citrix ADC xDS-adaptor container listens to updates from the Istio control plane and configures the Citrix ADC CPX instance accordingly.

The following diagram shows a sample deployment of Citrix ADC CPXs as sidecars.

CPX proxy

For detailed instructions on how to deploy Citrix ADC CPX as a sidecar, see Deploying Citrix ADC with Istio.

Deploy Citrix ADC CPX as an Egress Gateway

An Egress Gateway defines the traffic exit point from a service mesh. Citrix ADC CPX as an Egress Gateway performs load balancing, monitoring at the edge of the service mesh, and provides routing rules to exit the service mesh.

The following diagram shows a sample deployment of Citrix ADC CPX as an Egress Gateway.

CPX egress

For detailed instructions on how to deploy Citrix ADC CPX as an Egress Gateway, see Deploying Citrix ADC with Istio.

Deploy Citrix ADC VPX as an Egress Gateway

An Egress Gateway defines the traffic exit point from a service mesh. Citrix ADC VPX can be deployed as an Egress Gateway to the Istio service mesh. In this deployment, a Kubernetes pod is deployed with an Citrix ADC xDS-adaptor container. The Citrix ADC xDS-adaptor container connects to the Istio control plane and reads the egress configuration and then configures the Citrix ADC VPX accordingly.

Note: For this deployment, establish the connectivity between the concerned Citrix ADC and the cluster nodes.

The following diagram shows a sample deployment of Citrix ADC VPX as an Egress Gateway.

VPX egress

For detailed instructions on how to deploy Citrix ADC VPX as an Egress Gateway, see Deploying Citrix ADC with Istio.

Was this article helpful?