ingress-nginx-helm/docs/deploy/upgrade.md

49 lines
1.4 KiB
Markdown
Raw Normal View History

2018-05-03 07:20:39 +00:00
# Upgrading
!!! important
2018-08-30 18:24:56 +00:00
No matter the method you use for upgrading, _if you use template overrides,
make sure your templates are compatible with the new version of ingress-nginx_.
2018-05-03 07:20:39 +00:00
## Without Helm
To upgrade your ingress-nginx installation, it should be enough to change the version of the image
in the controller Deployment.
I.e. if your deployment resource looks like (partial example):
```yaml
kind: Deployment
metadata:
name: nginx-ingress-controller
namespace: ingress-nginx
spec:
replicas: 1
selector: ...
template:
metadata: ...
spec:
containers:
- name: nginx-ingress-controller
2020-04-24 21:30:58 +00:00
image: quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.30.0
2018-05-03 07:20:39 +00:00
args: ...
```
2020-04-24 21:30:58 +00:00
simply change the `0.30.0` tag to the version you wish to upgrade to.
2018-05-03 07:20:39 +00:00
The easiest way to do this is e.g. (do note you may need to change the name parameter according to your installation):
```
kubectl set image deployment/nginx-ingress-controller \
2020-06-10 18:33:48 +00:00
nginx-ingress-controller=quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.33.0
2018-05-03 07:20:39 +00:00
```
For interactive editing, use `kubectl edit deployment nginx-ingress-controller`.
## With Helm
If you installed ingress-nginx using the Helm command in the deployment docs so its name is `ngx-ingress`,
you should be able to upgrade using
```shell
helm upgrade --reuse-values ngx-ingress stable/nginx-ingress
```