F5Networks / f5-ci-docs

Documentation for F5's Container Ingress Services
http://clouddocs.f5.com/containers/v2
Apache License 2.0
7 stars 27 forks source link

Improve documentation about re-write URL feature (app-root) #440

Open velascoblasco opened 5 years ago

velascoblasco commented 5 years ago

Improve documentation about re-write URL feature (app-root)

Requests

Re-write URL feature (app-root) allows to re-write root URL to a first level path (ie. /level1) but as well to multi-level path (ie. /level1/level2). Documentation should be improved to describe this configuration option adding that it only works if we define a host in 'rewrite-app-root' annotation and the path in 'spec: rules: host: http: paths: path:'

With any other configuration it will not work.

Example of working config: apiVersion: extensions/v1beta1 kind: Ingress metadata: name: ing-nginx-clusterip namespace: test annotations: ingress.kubernetes.io/allow-http: "true" ingress.kubernetes.io/ssl-redirect: "false" virtual-server.f5.com/rewrite-app-root: nginx.test=/level1/level2 <==!! kubernetes.io/ingress.class: f5 virtual-server.f5.com/balance: round-robin virtual-server.f5.com/ip: 1.1.1.10 virtual-server.f5.com/partition: k8s virtual-server.f5.com/health: | [ { "path": "nginx.test/level1/level2", "send": "HTTP GET /level1/level2/test.html", "interval": 5, "timeout": 10 } ] spec: rules:

Environment

velascoblasco commented 5 years ago

Related config: Configuration: https://clouddocs.f5.com/containers/v2/kubernetes/kctlr-rewrite-url.html Annotations: https://clouddocs.f5.com/products/connectors/k8s-bigip-ctlr/v1.7/#supported-ingress-annotations