Redirections

Redirections d’URL (path)

Rediriger un chemin vers un autre :

network:
  - name: app
    urlRedirects:
      - source: /ancien-chemin
        target: /nouveau-chemin
        statusCode: 301              # 301 (defaut) ou 302

      - source: /app-ios
        target: https://apps.apple.com/fr/app/mon-app/id123456

Redirections regex

Pour des patterns complexes avec capture groups :

network:
  - name: app
    urlRedirects:
      - source: "/produit/(\\d+)/details"
        target: "/products/$1"
        useRegex: true

Les regex sont compilees en Lua et executees dans un EnvoyExtensionPolicy.

Redirections DNS (domaine)

Rediriger un domaine entier vers le hostname principal :

network:
  - name: app
    host: api.homeserve.fr
    dnsRedirections:
      - api.ancien-domaine.fr
      - api.legacy.homeserve.io

Tout le trafic vers api.ancien-domaine.fr sera redirige 301 vers api.homeserve.fr.

Redirection WWW

Voir DNS & TLS — activee par defaut via fromToWWW: true.

Format legacy (deprecie)

Avant le passage a Envoy Gateway API (deployer v3), les redirections pouvaient etre definies au niveau racine du deployer.yaml, en parallele du champ services: :

# Format legacy (deprecie) - encore supporte mais a migrer
services:
  - name: default
    host: app.example.com
    port: 80
urlRedirects:
  - source: /ancien-chemin
    target: /nouveau-chemin

Lorsque services: est present (et donc auto-converti en network[]:), les urlRedirects: racine sont automatiquement migres vers network[0].urlRedirects au moment du deploiement, avec un warning DEPRECATED: top-level 'urlRedirects' ... dans les logs.

Voir aussi : Toutes les proprietes | Gateway API