deployment.md

Deployment Guide

Installation

Install BFE Ingress Controller in either of two ways:

• Apply a configure file
• Install helm charts of controller

Configure file

kubectl apply -f https://raw.githubusercontent.com/bfenetworks/ingress-bfe/develop/examples/controller-all.yaml

• Above configure file uses latest version of BFE Ingress Controller image in Docker Hub. You can edit configure file to specify other version of the image.

• For details of permission configuration, please find more information in Role-Based Access Control

Helm

helm upgrade --install bfe-ingress-controller bfe-ingress-controller --repo https://bfenetworks.github.io/ingress-bfe  --namespace ingress-bfe --create-namespace

• helm3 is required.

Testing

• Create a testing service

kubectl apply -f https://raw.githubusercontent.com/bfenetworks/ingress-bfe/develop/examples/whoami.yaml

• Create ingress resource for testing service to verify the installation

kubectl apply -f https://raw.githubusercontent.com/bfenetworks/ingress-bfe/develop/examples/ingress.yaml  

• Create ingress resource for testing service to verify the installation if your kubernetes version > 1.19

kubectl apply -f ingress-gt-1.19.yaml  

cat ingress-gt-1.19.yaml
kind: Ingress
apiVersion: networking.k8s.io/v1
metadata:
  name: ingress-test
  namespace: ingress-bfe
  annotations:
    kubernetes.io/ingress.class: bfe

spec:
  rules:
    - host: "foo.com"
      http:
        paths:
          - path: /whoami
            pathType: Prefix
            backend:
              service:
                name: whoami
                port:
                  number: 80