Update repo files for release 1.5.1

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:

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