How to configure query parameter matching - Alibaba Cloud Service Mesh

A request can carry query parameters for matching. This topic describes how to configure query parameter matching.

Prerequisites

The preparations are completed, and the helloworld and sleep services are deployed. For more information, see Preparations.

Procedure

Check whether the service configurations take effect.
1. Use kubectl to connect to the Container Service for Kubernetes (ACK) cluster based on the information in the kubeconfig file, and then run the following command to enable bash for the sleep service:
```
kubectl exec -it deploy/sleep -- sh
```
2. Run the following command to send a request to the helloworld service:
```
curl helloworld:5000/hello
```
  The expected output is that helloworld-v1 or helloworld-v2 randomly responds to the request.
```
Hello version: v1, instance: helloworld-v1-6d77f4c4cf-p****
Hello version: v2, instance: helloworld-v2-6b96c5684-4****
```

Use the following content to configure a destination rule. For more information, see Manage destination rules.

apiVersion: networking.istio.io/v1beta1
kind: DestinationRule
metadata:
  name: helloworld
  namespace: default
spec:
  host: helloworld
  subsets:
    - labels:
        version: v1
      name: v1
    - labels:
        version: v2
      name: v2

Use the following content to create a virtual service and add a query parameter matching configuration. For more information, see Manage virtual services.
The following configuration indicates that requests with test-params set to v1 are sent to helloworld-v1 and requests with test-params set to v2 are sent to helloworld-v2.

apiVersion: networking.istio.io/v1beta1
kind: VirtualService
metadata:
  name: helloworld-vs
  namespace: default
spec:
  hosts:
    - helloworld
  http:
    - match:
        - queryParams:
            test-params:
              exact: v1
      route:
        - destination:
            host: helloworld
            subset: v1
    - match:
        - queryParams:
            test-params:
              exact: v2
      route:
        - destination:
            host: helloworld
            subset: v2

Check whether the configurations take effect.
1. Use kubectl to connect to the ACK cluster based on the information in the kubeconfig file, and then run the following command to enable bash for the sleep service:
```
kubectl exec -it deploy/sleep -- sh
```
2. Run the following command to send a request with test-params=v1 to the helloworld service:
```
curl helloworld:5000/hello?test-params=v1
```
  Expected output:
```
Hello version: v1, instance: helloworld-v1-6d77f4c4cf-p****
```
3. Run the following command to send a request with test-params=v2 to the helloworld service:
```
curl helloworld:5000/hello?test-params=v2
```
  Expected output:
```
Hello version: v2, instance: helloworld-v2-6b96c5684-4****
```