feat(lb) add support for path-begin route matching

Author: yfodil

docs/data-sources/lb_routes.md

@@ -40,4 +40,5 @@ In addition to all arguments above, the following attributes are exported:
     - `update_at` - The date on which the route was last updated (RFC 3339 format).
     - `match_subdomains` - If true, all subdomains will match.
     - `match_sni` - Server Name Indication TLS extension field from an incoming connection made via an SSL/TLS transport layer.
-    - `match_host_header` - Specifies the host of the server to which the request is being sent.
+    - `match_host_header` - Specifies the host of the server to which the request is being sent.
+    - `match_path_begin` - The value to match in the URL beginning path from an incoming request.

docs/resources/lb_route.md

@@ -73,6 +73,50 @@ resource "scaleway_lb_route" "rt01" {
 }
 ```
 
+# With path-begin matching for HTTP backends
+
+```terraform
+resource "scaleway_lb_ip" "ip" {}
+
+resource "scaleway_lb" "lb" {
+  ip_id = scaleway_lb_ip.ip.id
+  name  = "my-lb"
+  type  = "lb-s"
+}
+
+resource "scaleway_lb_backend" "app" {
+  lb_id            = scaleway_lb.lb.id
+  forward_protocol = "http"
+  forward_port     = 80
+  proxy_protocol   = "none"
+}
+
+resource "scaleway_lb_backend" "admin" {
+  lb_id            = scaleway_lb.lb.id
+  forward_protocol = "http"
+  forward_port     = 8080
+  proxy_protocol   = "none"
+}
+
+resource "scaleway_lb_frontend" "frontend" {
+  lb_id        = scaleway_lb.lb.id
+  backend_id   = scaleway_lb_backend.app.id
+  inbound_port = 80
+}
+
+resource "scaleway_lb_route" "admin_route" {
+  frontend_id      = scaleway_lb_frontend.frontend.id
+  backend_id       = scaleway_lb_backend.admin.id
+  match_path_begin = "/admin"
+}
+
+resource "scaleway_lb_route" "default_route" {
+  frontend_id      = scaleway_lb_frontend.frontend.id
+  backend_id       = scaleway_lb_backend.app.id
+  match_path_begin = "/"
+}
+```
+
 ## Argument Reference
 
 The following arguments are supported:
@@ -81,15 +125,17 @@ The following arguments are supported:
 - `frontend_id` - (Required) The ID of the frontend the route is associated with.
 - `match_subdomains` - (Default: `false`) If true, all subdomains will match.
 - `match_sni` - The Server Name Indication (SNI) value to match. Value to match in the Server Name Indication TLS extension (SNI) field from an incoming connection made via an SSL/TLS transport layer.
-  Only one of `match_sni` and `match_host_header` should be specified.
+  Only one of `match_sni`, `match_host_header` and `match_path_begin` should be specified.
 
 ~> **Important:** This field should be set for routes on TCP Load Balancers.
 
 - `match_host_header` - The HTTP host header to match. Value to match in the HTTP Host request header from an incoming connection.
-  Only one of `match_sni` and `match_host_header` should be specified.  
+  Only one of `match_sni`, `match_host_header` and `match_path_begin` should be specified.  
 
 ~> **Important:** This field should be set for routes on HTTP Load Balancers.
 
+- `match_path_begin` - The value to match in the URL beginning path from an incoming request.
+  Only one of `match_sni`, `match_host_header` and `match_path_begin` should be specified.
 - `zone` - (Defaults to [provider](../index.md#zone) `zone`) The [zone](../guides/regions_and_zones.md#zones) in which the Load Balancer was created.
 
 ## Attributes Reference

internal/services/lb/route.go

@@ -47,13 +47,19 @@ func ResourceRoute() *schema.Resource {
 				Type:          schema.TypeString,
 				Optional:      true,
 				Description:   "Server Name Indication TLS extension field from an incoming connection made via an SSL/TLS transport layer",
-				ConflictsWith: []string{"match_host_header"},
+				ConflictsWith: []string{"match_host_header", "match_path_begin"},
 			},
 			"match_host_header": {
 				Type:          schema.TypeString,
 				Optional:      true,
 				Description:   "Specifies the host of the server to which the request is being sent",
-				ConflictsWith: []string{"match_sni"},
+				ConflictsWith: []string{"match_sni", "match_path_begin"},
+			},
+			"match_path_begin": {
+				Type:          schema.TypeString,
+				Optional:      true,
+				Description:   "Value to match in the URL beginning path from an incoming request",
+				ConflictsWith: []string{"match_sni", "match_host_header"},
 			},
 			"match_subdomains": {
 				Type:        schema.TypeBool,
@@ -102,6 +108,7 @@ func resourceLbRouteCreate(ctx context.Context, d *schema.ResourceData, m interf
 		Match: &lbSDK.RouteMatch{
 			Sni:             types.ExpandStringPtr(d.Get("match_sni")),
 			HostHeader:      types.ExpandStringPtr(d.Get("match_host_header")),
+			PathBegin:       types.ExpandStringPtr(d.Get("match_path_begin")),
 			MatchSubdomains: d.Get("match_subdomains").(bool),
 		},
 	}
@@ -140,6 +147,7 @@ func resourceLbRouteRead(ctx context.Context, d *schema.ResourceData, m interfac
 	_ = d.Set("backend_id", zonal.NewIDString(zone, route.BackendID))
 	_ = d.Set("match_sni", types.FlattenStringPtr(route.Match.Sni))
 	_ = d.Set("match_host_header", types.FlattenStringPtr(route.Match.HostHeader))
+	_ = d.Set("match_path_begin", types.FlattenStringPtr(route.Match.PathBegin))
 	_ = d.Set("match_subdomains", route.Match.MatchSubdomains)
 	_ = d.Set("created_at", types.FlattenTime(route.CreatedAt))
 	_ = d.Set("updated_at", types.FlattenTime(route.UpdatedAt))
@@ -169,6 +177,7 @@ func resourceLbRouteUpdate(ctx context.Context, d *schema.ResourceData, m interf
 		Match: &lbSDK.RouteMatch{
 			Sni:             types.ExpandStringPtr(d.Get("match_sni")),
 			HostHeader:      types.ExpandStringPtr(d.Get("match_host_header")),
+			PathBegin:       types.ExpandStringPtr(d.Get("match_path_begin")),
 			MatchSubdomains: d.Get("match_subdomains").(bool),
 		},
 	}

internal/services/lb/route_test.go

@@ -135,6 +135,50 @@ func TestAccRoute_WithHostHeader(t *testing.T) {
 	})
 }
 
+func TestAccRoute_WithPathBegin(t *testing.T) {
+	tt := acctest.NewTestTools(t)
+	defer tt.Cleanup()
+	resource.ParallelTest(t, resource.TestCase{
+		PreCheck:          func() { acctest.PreCheck(t) },
+		ProviderFactories: tt.ProviderFactories,
+		CheckDestroy:      isRouteDestroyed(tt),
+		Steps: []resource.TestStep{
+			{
+				Config: `
+					resource scaleway_lb_ip ip01 {}
+					resource scaleway_lb lb01 {
+						ip_id = scaleway_lb_ip.ip01.id
+						name  = "test-lb"
+						type  = "lb-s"
+					}
+					resource scaleway_lb_backend bkd01 {
+						lb_id = scaleway_lb.lb01.id
+						forward_protocol = "http"
+						forward_port     = 80
+						proxy_protocol   = "none"
+					}
+					resource scaleway_lb_frontend frt01 {
+						lb_id        = scaleway_lb.lb01.id
+						backend_id   = scaleway_lb_backend.bkd01.id
+						inbound_port = 80
+					}
+					resource scaleway_lb_route rt01 {
+						frontend_id      = scaleway_lb_frontend.frt01.id
+						backend_id       = scaleway_lb_backend.bkd01.id
+                        match_path_begin = "/api"
+					}
+				`,
+				Check: resource.ComposeTestCheckFunc(
+					isRoutePresent(tt, "scaleway_lb_route.rt01"),
+					resource.TestCheckResourceAttr("scaleway_lb_route.rt01", "match_path_begin", "/api"),
+					resource.TestCheckResourceAttrSet("scaleway_lb_route.rt01", "created_at"),
+					resource.TestCheckResourceAttrSet("scaleway_lb_route.rt01", "updated_at"),
+				),
+			},
+		},
+	})
+}
+
 func isRoutePresent(tt *acctest.TestTools, n string) resource.TestCheckFunc {
 	return func(s *terraform.State) error {
 		rs, ok := s.RootModule().Resources[n]