C.1 Installing Ingress Controller During OAA Installation

To install an Ingress Controller supplied with the OAA installation, you must edit the installOAA.properties file and update the Optional Configuration section with ingress properties.

The following example shows the ingress properties that needs to be updated in the installOAA.properties file to install an ingress controller using NodePort. 

##################################### 6. Optional configuration#########################################
install.global.ingress.enabled=true

## All the other properties in 6.Optional configuration section must be commented out.

##################################### 7. Ingress configuration#########################################
#Kubernetes name space which will be used to install ingress
ingress.install=true
ingress.namespace=ingress-nginx
#Admissions controller can be installed seperately.
#Ingress admissions name is not present the the controller.admissionWebhooks.enabled will be set to false in the nginx ingress chart.
#ingress.admissions.name=ingress-nginx-controller-admission
#Ingress class name that would be used for installation. Must not be exisiting
ingress.class.name=ingress-nginx-class
ingress.service.type=NodePort

#anything starting with ingress.install can be additionally supplied to set the ingress chart value.
#ingress.install.releaseNameOverride=base

Note:

  • ingress.namespace creates a namespace called ingress-nginx. You can change this to a name of your choice and the namespace is created for you.

Additional Considerations

When installing the Ingress Controller supplied with the OAA installation, the following additional image is installed:
  • controller:v1.0.0 from https://registry.k8s.io/ingress-nginx.

Administrators must whitelist this site to allow the Kubernetes cluster to pull this image.

If you cannot whitelist this site, then you must pull the image down manually and store it in your container registry.

It is recommended to pull the latest controller:v1.X version. See https://github.com/kubernetes/ingress-nginx/releases to find the latest release. For example:
podman pull registry.k8s.io/ingress-nginx/controller:v1.X.X
In order for the installation to know about the location of the controller:v1.X.X image, add the following parameters to the installOAA.properties in the ##7. Ingress configuration## section:

Note:

These parameters are not shown in the installOAA.properties file by default. 
ingress.install.controller.image.repository=<registry>
ingress.install.controller.image.image=<repository>
ingress.install.controller.image.tag=<tag>
For example: 
ingress.install.controller.image.repository=container-registry.example.com
ingress.install.controller.image.image=ingress-nginx/controller
ingress.install.controller.image.tag=v1.X.X
See Understanding installOAA.properties Parameters.