From df3ed2a2ac7e99f87b8cd08d2fd7d89f72993b41 Mon Sep 17 00:00:00 2001 From: Michael Pleshakov Date: Wed, 3 Jul 2019 14:32:30 +0100 Subject: [PATCH] Update repo files for release 1.5.1 --- CHANGELOG.md | 25 +++++++++++++++++++++++++ README.md | 4 ++-- 2 files changed, 27 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e46afb55bc..9c87d96adf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,30 @@ # Changelog +### 1.5.1 + +CHANGES: +* Update NGINX version to 1.17.1. + +HELM CHART: +* The version of the Helm chart is now 0.3.1. +* [593](https://github.com/nginxinc/kubernetes-ingress/pull/593): Fix the selector in the Ingress Controller service when the `controller.name` parameter is set. This introduces a change, see the HELM UPGRADE section. + +UPGRADE: +* For NGINX, use the 1.5.1 image from our DockerHub: `nginx/nginx-ingress:1.5.1` or `nginx/nginx-ingress:1.5.1-alpine` +* For NGINX Plus, please build your own image using the 1.5.1 source code. +* For Helm, use version 0.3.1 of the chart. + +HELM UPGRADE: + +In the changelog of Release 1.5.0, we advised not to upgrade the helm chart from `0.2.1` to `0.3.0` unless the mentioned in the changelog problems were acceptable. This release we provide mitigation instructions on how to upgrade from `0.2.1` to `0.3.1` without disruptions. + +When you upgrade from `0.2.1` to `0.3.1`, make sure to configure the following parameters: +* `controller.name` is set to `nginx-ingress` or the previously used value in case you customized it. This ensures the Deployment/Daemonset will not be recreated. +* `controller.service.name` is set to `nginx-ingress`. This ensures the service will not be recreated. +* `controller.config.name` is set to `nginx-config`. This ensures the ConfigMap will not be recreated. + +Upgrading from `0.3.0` to `0.3.1`: Upgrading is not affected unless you customized `controller.name`. In that case, because of the fix [593](https://github.com/nginxinc/kubernetes-ingress/pull/593), the upgraded service will have a new selector, and the upgraded pod spec will have a new label. As a result, during an upgrade, the old pods will be immediately excluded from the service. Also, for the Deployment, the old pods will not terminate but continue to run. To terminate the old pods, manually remove the corresponding ReplicaSet. + ### 1.5.0 FEATURES: diff --git a/README.md b/README.md index 96b49e242e..83aa26fe59 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ Read [this doc](docs/nginx-plus.md) to learn more about NGINX Ingress controller We publish Ingress controller releases on GitHub. See our [releases page](https://github.com/nginxinc/kubernetes-ingress/releases). -The latest stable release is [1.5.0](https://github.com/nginxinc/kubernetes-ingress/releases/tag/v1.5.0). For production use, we recommend that you choose the latest stable release. As an alternative, you can choose the *edge* version built from the [latest commit](https://github.com/nginxinc/kubernetes-ingress/commits/master) from the master branch. The edge version is useful for experimenting with new features that are not yet published in a stable release. +The latest stable release is [1.5.1](https://github.com/nginxinc/kubernetes-ingress/releases/tag/v1.5.1). For production use, we recommend that you choose the latest stable release. As an alternative, you can choose the *edge* version built from the [latest commit](https://github.com/nginxinc/kubernetes-ingress/commits/master) from the master branch. The edge version is useful for experimenting with new features that are not yet published in a stable release. To use the Ingress controller, you need to have access to: * An Ingress controller image. @@ -62,7 +62,7 @@ The table below summarizes the options regarding the images, manifests, helm cha | Version | Description | Image for NGINX | Image for NGINX Plus | Installation Manifests and Helm Chart | Documentation and Examples | | ------- | ----------- | --------------- | -------------------- | ---------------------------------------| -------------------------- | -| Latest stable release | For production use | `nginx/nginx-ingress:1.5.0`, `nginx/nginx-ingress:1.5.0-alpine` from [DockerHub](https://hub.docker.com/r/nginx/nginx-ingress/) or [build your own image](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.0/build). | [Build your own image](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.0/build). | [Manifests](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.0/deployments). [Helm chart](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.0/deployments/helm-chart). | [Documentation](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.0/docs). [Examples](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.0/examples). | +| Latest stable release | For production use | `nginx/nginx-ingress:1.5.1`, `nginx/nginx-ingress:1.5.1-alpine` from [DockerHub](https://hub.docker.com/r/nginx/nginx-ingress/) or [build your own image](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.1/build). | [Build your own image](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.1/build). | [Manifests](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.1/deployments). [Helm chart](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.1/deployments/helm-chart). | [Documentation](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.1/docs). [Examples](https://github.com/nginxinc/kubernetes-ingress/tree/v1.5.1/examples). | | Edge | For testing and experimenting | `nginx/nginx-ingress:edge`, `nginx/nginx-ingress:edge-alpine` from [DockerHub](https://hub.docker.com/r/nginx/nginx-ingress/) or [build your own image](https://github.com/nginxinc/kubernetes-ingress/tree/master/build). | [Build your own image](https://github.com/nginxinc/kubernetes-ingress/tree/master/build). | [Manifests](https://github.com/nginxinc/kubernetes-ingress/tree/master/deployments). [Helm chart](https://github.com/nginxinc/kubernetes-ingress/tree/master/deployments/helm-chart). | [Documentation](https://github.com/nginxinc/kubernetes-ingress/tree/master/docs). [Examples](https://github.com/nginxinc/kubernetes-ingress/tree/master/examples). | ## Contacts