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 calledingress-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
fromhttps://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 theinstallOAA.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.