nginx_image
Description
The nginx_image parameter allows you to specify a custom container image for the nginx ingress controller. This is useful for using a specific version or a custom-built nginx image.
Default Value
The default value is an empty string (""), which uses the built-in default image: registry.k8s.io/ingress-nginx/controller:v1.12.0.
Use Cases
- Version Pinning: Lock to a specific nginx ingress controller version for stability.
- Custom Builds: Use a custom nginx image with additional modules or patches.
- Air-Gapped Environments: Point to an image in a private registry.
Setting Parameters
To set the nginx_image parameter, use the following command:
$ convox rack params set nginx_image=registry.k8s.io/ingress-nginx/controller:v1.12.0 -r rackName
Setting parameters... OK
Additional Information
The image must be a valid nginx ingress controller image compatible with the Kubernetes ingress-nginx project. Using an incompatible image may cause routing failures.