Belajar Multigress - Advanced Routing & Request Transformation

#Pendahuluan

Routing dasar sudah kalian kuasai. Sekarang saatnya memanipulasi request itu sendiri. Episode 8 membahas advanced routing dan request transformation: mengubah header, mengalihkan dan menulis ulang path, menilai kondisi routing yang kompleks, serta melayani protokol non-HTTP seperti gRPC dan WebSocket.

#Header Manipulation, Redirects, dan Rewrites

#RequestHeaderModifier

Filter RequestHeaderModifier menambah, mengubah, atau menghapus header sebelum request sampai ke backend:

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: api-route
spec:
  parentRefs:
    - name: main-gateway
      namespace: multigress-system
  rules:
    - backendRefs:
        - name: api
          port: 8080
      filters:
        - type: RequestHeaderModifier
          requestHeaderModifier:
            set:
              - name: X-Forwarded-For
                value: "true"
            add:
              - name: X-Client-Region
                value: "id"
            remove:
              - "X-Internal-Token"

Dengan filter di atas, proxy menambahkan header X-Client-Region sebelum meneruskan ke Service api. Perintah kubectl apply -f route.yaml langsung menerapkan transformasi ini tanpa perlu restart backend.

#RequestRedirect dan URLRewrite

Ada dua filter yang sekilas mirip tetapi berbeda tujuan:

• RequestRedirect: mengirim klien ke URL baru (perubahan host dan scheme), biasanya untuk HTTPS.
• URLRewrite: mengganti path di gateway, tetapi tetap satu koneksi — klien tidak tahu.

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: https-redirect
spec:
  parentRefs:
    - name: main-gateway
      namespace: multigress-system
  rules:
    - filters:
        - type: RequestRedirect
          requestRedirect:
            scheme: https
            statusCode: 301

Route di atas mengubah semua request HTTP ke HTTPS. Sedangkan untuk rewrite path lama ke path baru:

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: rewrite-route
spec:
  rules:
    - matches:
        - path:
            type: PathPrefix
            value: /api/v2
      filters:
        - type: URLRewrite
          urlRewrite:
            path:
              type: ReplacePrefixMatch
              replacePrefixMatch: /v2
      backendRefs:
        - name: api
          port: 8080

Request /api/v2/users akan diteruskan sebagai /v2/users ke backend. Dengan ReplacePrefixMatch, backend tidak perlu tahu bahwa path lama bernama v2.

#Conditional Routing dengan Route Rules

#Matching Berdasarkan Header, Query, dan Metode

Rule HTTPRoute bisa dikondisikan dengan lebih dari path. Kombinasi berikut mengarahkan request berdasarkan header dan metode:

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: booking-route
spec:
  parentRefs:
    - name: main-gateway
  rules:
    - matches:
        - headers:
            - type: Exact
              name: X-Canary
              value: "true"
          method: GET
      backendRefs:
        - name: booking-canary
          port: 8080
    - backendRefs:
        - name: booking-stable
          port: 8080

Klien yang mengirim header X-Canary: true dengan metode GET diarahkan ke booking-canary; sisanya ke booking-stable. Ini bentuk canary berbasis header yang sering dipakai untuk testing internal.

Beberapa aturan penting tentang match:

• Semua kondisi dalam satu match harus terpenuhi semuanya.
• Beberapa match diatur sebagai OR; rule pertama yang cocok menang.
• method dan queryParams ikut tersedia sebagai kondisi.

#Mendukung gRPC dan WebSocket

#GRPCRoute untuk gRPC

gRPC memakai HTTP/2 dan istilah method seperti /service.Method. Route-nya menggunakan GRPCRoute dengan match berdasarkan service dan method:

apiVersion: gateway.networking.k8s.io/v1
kind: GRPCRoute
metadata:
  name: grpc-route
spec:
  parentRefs:
    - name: main-gateway
      namespace: multigress-system
  hostnames:
    - "grpc.example.com"
  rules:
    - matches:
        - method:
            type: Exact
            service: com.example.payment.PaymentService
            method: Charge
      backendRefs:
        - name: payment-grpc
          port: 9000

GRPCRoute memakai struktur yang sama dengan HTTPRoute, hanya match-nya berbasis service dan method gRPC.

#WebSocket di HTTPRoute

WebSocket tidak membutuhkan route khusus — handshake-nya adalah request HTTP biasa dengan header upgrade. Asalkan HTTPRoute menunjuk ke Service yang benar, upgrade akan diteruskan, dan status 101 Switching Protocols menandakan koneksi berhasil di-upgrade.

#Penutup

Episode 8 melengkapi kemampuan routing kalian: transformasi header, redirect dan rewrite, routing kondisional berdasarkan header dan metode, serta dukungan protokol gRPC dan WebSocket yang berjalan mulus lewat gateway.

Inti yang harus dibawa pulang:

• RequestHeaderModifier menambah, mengubah, dan menghapus header di gateway.
• RequestRedirect mengubah tujuan klien; URLRewrite mengganti path internal.
• Match bisa dikombinasikan dengan header, query, dan metode; rule pertama menang.
• gRPC memakai GRPCRoute dengan match berbasis service dan method.
• WebSocket cukup ditunjuk oleh HTTPRoute biasa dengan header upgrade.

Di episode 9 selanjutnya kita akan membahas canary deployments & progressive delivery — traffic shifting dengan weights, feedback loop observability untuk keamanan deployment, serta integrasi dengan Argo Rollouts dan Flagger. Route rule yang baru kalian pelajari akan menjadi alat utama di episode ini.