Alibaba Cloud Service Mesh:Configure traffic routing for an ASM gateway

Create a domain name

1. Log on to the ASM console. In the left-side navigation pane, choose Service Mesh > Mesh Management.

2. On the Mesh Management page, click the name of the ASM instance. In the left-side navigation pane, choose ASM Gateways > Ingress Gateway.

3. On the Ingress Gateway page, click the name of the target ASM gateway. In the left-side navigation pane of Gateway overview page, click Domain/Certificate.

4. On the Add Domain page, configure the following parameters, and click Create.

   Parameter	Example
   Domain	*
   Protocol	HTTP
   Namespace	default
   Port Name	http
   Port	80

   

Import an upstream service

Import an reviews service to an ASM gateway to associate the ASM gateway with the reviews service.

1. On the Ingress Gateway page, click the name of the ASM gateway to which you want to import the reviews service. In the left-side navigation pane of the Gateway overview page, click Upstream Service.

2. On the Gateway upstream services page, click Import service. On the Import service page, select a namespace from the Namespace drop-down list. In the select service box, select reviews and productpage, click the icon to move the service to the selected box. Then, click Submit.

   

Create a traffic policy

1. Manage versions of the reviews service.

   Group instances of the reviews service by version. In this example, the versions of the reviews service are v1, v2, and v3.

   1. On the Gateway upstream services page, find the reviews service and click versions in the Actions column.

   2. On the Versions page, click Add Service Version (Subnet). Set the Name parameter to v1. Then, click Add Label and set the Key parameter to version and Value parameter to v1.

   3. Click Add Service Version (Subnet) again. Set the Name parameter to v2. Then, click Add Label and set the Key parameter to version and the Value parameter to v2.

   4. Click Add Service Version (Subnet) again. Set the Name parameter to v3. Then, click Add Label and set the Key parameter to version and the Value parameter to v3. Then, click Create.

2. Create a traffic policy.

   1. On the Gateway upstream services page, find the reviews service and click Traffic Policy in the Actions column.

   2. On the Traffic Policy page, click Add Policy. Select Subset Level and select v3 from the Subset drop-down list. Turn on Load Balancing and select Simple. Then, set the Mode parameter to Random and click Submit.

      

3. (Optional) After the traffic policy is created, view the YAML file that is automatically generated for a destination rule.

   On the Gateway upstream services page, find the reviews service and click YAML in the Actions column to view the YAML file in the Preview dialog box. After you confirm the correctness of the YAML file, click Submit.

   Note

   You can also choose Traffic Management Center > DestinationRule in the left-side navigation pane on the details page of the ASM instance. On the DestinationRule page, find the rule whose YAML file you want to view and click YAML in the Actions column. In the Edit dialog box, view the YAML file of the destination rule.

   Click to view the details

   Click to view the YAML file
   apiVersion: networking.istio.io/v1beta1
   kind: DestinationRule
   metadata:
     name: reviews
     namespace: default
     labels:
       provider: asm
   spec:
     host: reviews
     subsets:
       - name: v1
         labels:
           version: v1
       - name: v2
         labels:
           version: v2
       - name: v3
         labels:
           version: v3
         trafficPolicy:
           loadBalancer:
             simple: RANDOM

Create routing rules

1. Create routing rules.

   1. Create a routing rule to match a URL that contains /productpage.

      1. In the left-side navigation pane of the Gateway overview page, click Route management. On the page that appears, click Create.

      2. In the set route detail step, set the parameters that are described in the following table, and then click Next.

         Parameter	Description
         Route type	The type of the traffic to be routed. In this example, the value is http.
         Namespace	The namespace in which you create the routing rule. In this example, the value is default.
         Name	The name of the routing rule. In this example, the value is productpage-route.
         Description	The description of the routing rule. In this example, the value is productpage routing.
         Priority	In this example, the value is 3. Note The priority of the routing rule. A smaller value indicates a higher priority. If a URL matches multiple routing rules, the routing rule that has the highest priority takes precedence.
         Matching Rule	The content to be matched in a URL. Only requests with a URL that contains the specified content can be routed to the destination service. Turn on Matching request URI, set Method to Exact and Content to /productpage. Note You can also click Add Header Matching Rule to configure settings for matching HTTP headers.

      3. In the set route destination step, set the parameters that are described in the following table, and then click Next.

         Parameter	Description
         Select upstream service	The service to which the routing rule applies. In this example, the value is productpage.
         Port	(Optional) The port through which the routing rule connects to the upstream service. The upstream service may expose multiple ports. In this case, specify a port. This parameter can be left empty.
         Subnet	The version of the service to which the routing rule applies. This parameter can be left empty.
         Weight	The traffic weight of the destination service. This parameter can be left empty.

      4. In the Advanced Settings step, turn on Fault Injection. After that, turn on Request Latency, set the Latency parameter to 4s and the Injection Percentage parameter to 100, and then click Create.

   2. Create a routing rule to match a URL that contains /static.

      1. On the Route management page, click Create.

      2. In the set route detail step, set the parameters that are described in the following table, and then click Next.

         Parameter	Description
         Route Type	The type of the traffic to be routed. In this example, the value is http.
         Namespace	The namespace in which you create the routing rule. In this example, the value is default.
         Name	The name of the routing rule. In this example, the value is static.
         Description	The description of the routing rule. In this example, the value is static resource.
         Priority	The priority of the routing rule. In this example, the value is 0.
         Matching Rule	The content to be matched in a URL. Only requests with a URL that contains the specified content can be routed to the destination service. Turn on Matching request URI, set Method to Prefix and Content to /static.

      3. The subsequent steps for creating a routing rule to match a URL that contains /static are the same as those for creating a routing rule to match a URL that contains /productpage.

   3. Create a routing rule to match a URL that contains /login.

      1. On the Route management page, click Create.

      2. In the set route detail step, set the parameters that are described in the following table, and then click Next.

         Parameter	Description
         Route Type	The type of the traffic to be routed. In this example, the value is http.
         Namespace	The namespace in which you create the routing rule. In this example, the value is default.
         Name	The name of the routing rule. In this example, the value is login.
         Description	The description of the routing rule. In this example, the value is login request routing.
         Priority	The priority of the routing rule. In this example, the value is 0.
         Matching Rule	The content to be matched in a URL. Only requests with a URL that contains the specified content can be routed to the destination service. Turn on Matching request URI and set the Method parameter to Prefix and the Content parameter to /login.

      3. The subsequent steps for creating a routing rule to match a URL that contains /loginare the same as those for creating a routing rule to match a URL that contains /productpage.

   4. Create a routing rule to match a URL that contains /logout.

      1. On the Route management page, click Create.

      2. In the set route detail step, set the parameters that are described in the following table, and then click Next.

         Parameter	Description
         Route Type	The type of the traffic to be routed. In this example, the value is http.
         Namespace	The namespace in which you create the routing rule. In this example, the value is default.
         Name	The name of the routing rule. In this example, the value is logout.
         Description	The description of the routing rule. In this example, the value is logout route.
         Priority	The priority of the routing rule. In this example, the value is 0.
         Matching Rule	The content to be matched in a URL. Only requests with a URL that contains the specified content can be routed to the destination service. Turn on Matching request URI and set the Method parameter to Prefix and the Content parameter to /logout.

      3. The subsequent steps for creating a routing rule to match a URL that contains /logout are the same as those for creating a routing rule to match a URL that contains /productpage.

   5. Create a routing rule to match a URL that contains /api/v1/products.

      1. On the Route management page, click Create.

      2. In the set route detail step, set the parameters that are described in the following table, and then click Next.

         Parameter	Description
         Route Type	The type of the traffic to be routed. In this example, the value is http.
         Namespace	The namespace in which you create the routing rule. In this example, the value is default.
         Name	The name of the routing rule. In this example, the value is products-route.
         Description	The description of the routing rule. In this example, the value is product information.
         Priority	The priority of the routing rule. In this example, the value is 0.
         Matching Rule	The content to be matched in a URL. Only requests with a URL that contains the specified content can be routed to the destination service. Turn on Matching request URI, set Method to Prefix and Content to /api/v1/products.

      3. The subsequent steps for creating a routing rule to match a URL that contains /api/v1/products are the same as those for creating a routing rule to match a URL that contains/productpage.

2. Check whether the routing rules take effect.

   1. In the address bar of Google Chrome, enter http://{IP address of the ASM gateway}/productpage.

      The following figure shows an example on the page that appears.

   2. In the upper-right corner of the Bookinfo page, click Sign in.

   3. On the Please sign in page, enter your account and password and click Sign in.

      The following figure shows the page of the Bookinfo service after logon.

      You can also use a URL that contains /logout, /static, or /api/v1/productsto access the Bookinfo service for verification.

   4. In the upper-right corner of Google Chrome, click the icon and choose More tools > Developer tools. Click the Network tab.

   5. Refresh the page.

      On the Network tab, a delay of about 4 seconds is reported.

3. (Optional) After the routing rules are created, view the YAML files that are automatically generated for the corresponding virtual services.

   1. On the details page of the ASM instance, choose Traffic Management Center > VirtualService in the left-side navigation pane.

   2. On the VirtualService page, find the virtual service that you want to manage and click YAML in the Actions column.

   3. In the Edit dialog box, view the YAML file of the virtual service. Confirm the settings and click OK.

Related operations

View service details

View the details of an imported service, such as the settings of the sidecar proxy injection and the region.

1. On the Ingress Gateway page, click the name of the ASM gateway for which you want to view service details. In the left-side navigation pane of the Gateway overview page, click Upstream Service.

2. On the Gateway upstream services page, find the service whose details you want to view and click Service Details in Actions column. On the Service Details page, view the details of the service, such as the settings of the sidecar proxy injection and the region.

Disable a routing rule

You can disable a routing rule so that this routing rule no longer takes effect.

1. On the Ingress Gateway page, click the name of the ASM gateway for which you want to disable a routing rule.

2. In the left-side navigation pane of the Gateway overview page, click Route management.

3. On the Route Management page, find the desired routing rule and click Offline in the Actions column.

4. In the Submit message, click OK.

5. Verify that the disabled routing rule no longer takes effect.

   1. In the address bar of Google Chrome, enter http://{IP address of the ingress gateway}/productpage.

   2. In the upper-right corner of the Bookinfo page, click Sign in.

   3. On the Please sign in page, enter your account and password and click Sign in.

      A 404 error occurs, which indicates that the login routing rule is disabled and no longer takes effect.