This chart simplifies repeatable, versioned use of the F5 BIG-IP Controller as an Ingress Controller in Kubernetes or OpenShift.
- Install Helm with Tiller on your cluster with appropriate permissions.
- Deploy the F5 BIG-IP Controller in your cluster. You can use the f5-bigip-ctlr chart to deploy the Controller or you can deploy it manually.
- Deploy the Pods/Services accepting traffic from the Ingress.
Note: This chart and the f5-bigip-controller chart can be used independently or together.
If you or your organization author your own charts either or both may be used as a subchart.Similarly, this Ingress chart can be combined -- either as a parent chart or a subchart -- with charts that define the services accepting traffic.
The chart creates an Ingress resource for use with the k8s-bigip-ctlr.
- Copy the
values.yamlfile. Use this file as the basis for your own Ingress specification. - Pass your custom values file when running
helm installas shown in the example below.
helm repo add f5-stable https://f5networks.github.io/charts/stable
helm install -f path/to/custom-values.yaml f5-stable/f5-bigip-ingress
Or
# from fork
helm install -f path/to/custom-values.yaml charts/src/stable/f5-bigip-ingress/
| Parameter | Description | Default |
|---|---|---|
| ingress.annotations.virtual-server.f5.com/ip | IP accepting traffic on the BIG-IP device | Required no default |
| ingress.annotations.virtual-server.f5.com/partition | BIG-IP partition of the Controller | Required no default |
| ingress.namespace | Kubernetes/OpenShift namespace for the Ingress | Optional |
| spec | Backend(s) and associated hosts and paths | See examples |
The Annotations listed under the ingress.annotations parameter are consumed as an array and any of the documentend Annotations for the k8s-bigip-ctlr may be used.
When using the virtual-server.f5.com/health Annotation the value must be a JSON array of the individual health monitors. Single and multiple health monitor examples can be seen in the Ingress Examples in this repo.
CAUTION: Be sure to use the correct version of the Controller for the Annotations you wish to use. See the k8s-bigip-ctlr release notes for more information.
If you have a specific use case for F5 products in the Kubernetes environment that would benefit from a curated chart, please open an issue describing your use case and providing example resources.