k8s-bigip-ctlr

README

F5 Container Ingress Services for Kubernetes & OpenShift

The F5 Container Ingress Services for Kubernetes and OpenShift makes F5 BIG-IP services available to applications running in Kubernetes and OpenShift.

Documentation

For instruction on how to use this component, see the docs for F5 Container Ingress Services for Kubernetes & OpenShift.

For guides on this and other solutions for Kubernetes, see the F5 Solution Guides for Kubernetes.

What's New?

Support for Custom Resource Definitions Documentation

Getting Help

We encourage you to use the cis-kubernetes channel in our f5CloudSolutions Slack workspace for discussion and assistance on this controller. This channel is typically monitored Monday-Friday 9am-5pm MST by F5 employees who will offer best-effort support.

Contact F5 Technical support via your typical method for more time sensitive changes and other issues requiring immediate support.

Running

The official docker image is f5networks/k8s-bigip-ctlr.

Usually, the controller is deployed in Kubernetes. However, the controller can be run locally for development testing.

docker run f5networks/k8s-bigip-ctlr /app/bin/k8s-bigip-ctlr <args>

Building

The official images are built using docker, but the adventurous can use standard go build tools.

Official Build

Prerequisites:

• Docker

git clone https://github.com/nuczzz/k8s-bigip-ctlr/v2 
cd  k8s-bigip-ctlr

# Use docker to build the release artifacts, into a local "_docker_workspace" directory, then put into docker images
# Debian image
make prod

OR

# RHEL7 image
make prod BASE_OS=rhel7

Alternate, unofficial build

A normal go toolchain can be used as well

Prerequisites:

• go 1.15
• $GOPATH pointing at a valid go workspace
• python
• virtualenv

mkdir -p $GOPATH/src/github.com/F5Networks
cd $GOPATH/src/github.com/F5Networks
git clone https://github.com/nuczzz/k8s-bigip-ctlr/v2
cd k8s-bigip-ctlr

# Build all packages, and run unit tests
make all test

To make changes to vendor dependencies, see Devel