From 2b6bb8de37120294c5de981d3e552f1b1ff21195 Mon Sep 17 00:00:00 2001 From: Michael Pleshakov Date: Mon, 24 Oct 2022 18:27:22 -0400 Subject: [PATCH 1/2] Use 0.2.0 version in release branch - Update the tag in the container image - Update image pull policy to IfNotPresent - Update the version in the Makefile - Checkout v0.2.0 tag in the git clone instructions --- Makefile | 2 +- deploy/manifests/nginx-gateway.yaml | 4 ++-- docs/building-the-image.md | 6 +++--- docs/installation.md | 2 +- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/Makefile b/Makefile index 08a81ab144..e18daa4034 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,4 @@ -VERSION = edge +VERSION = 0.2.0 TAG = $(VERSION) PREFIX ?= nginx-kubernetes-gateway diff --git a/deploy/manifests/nginx-gateway.yaml b/deploy/manifests/nginx-gateway.yaml index 98b591b2e8..c81bef0104 100644 --- a/deploy/manifests/nginx-gateway.yaml +++ b/deploy/manifests/nginx-gateway.yaml @@ -95,8 +95,8 @@ spec: - name: nginx-config mountPath: /etc/nginx containers: - - image: ghcr.io/nginxinc/nginx-kubernetes-gateway:edge - imagePullPolicy: Always + - image: ghcr.io/nginxinc/nginx-kubernetes-gateway:0.2.0 + imagePullPolicy: IfNotPresent name: nginx-gateway volumeMounts: - name: nginx-config diff --git a/docs/building-the-image.md b/docs/building-the-image.md index 6700e192bb..fb42fd71a9 100644 --- a/docs/building-the-image.md +++ b/docs/building-the-image.md @@ -12,7 +12,7 @@ Before you can build the NGINX Kubernetes Gateway, make sure you have the follow 1. Clone the repo and change into the `nginx-kubernetes-gateway` directory: ``` - git clone https://github.com/nginxinc/nginx-kubernetes-gateway.git + git clone https://github.com/nginxinc/nginx-kubernetes-gateway.git --branch v0.2.0 cd nginx-kubernetes-gateway ``` @@ -22,12 +22,12 @@ Before you can build the NGINX Kubernetes Gateway, make sure you have the follow make PREFIX=myregistry.example.com/nginx-kubernetes-gateway container ``` - Set the `PREFIX` variable to the name of the registry you'd like to push the image to. By default, the image will be named `nginx-kubernetes-gateway:edge`. + Set the `PREFIX` variable to the name of the registry you'd like to push the image to. By default, the image will be named `nginx-kubernetes-gateway:0.2.0`. 1. Push the image to your container registry: ``` - docker push myregistry.example.com/nginx-kubernetes-gateway:edge + docker push myregistry.example.com/nginx-kubernetes-gateway:0.2.0 ``` Make sure to substitute `myregistry.example.com/nginx-kubernetes-gateway` with your registry. diff --git a/docs/installation.md b/docs/installation.md index 1f6ad26390..297ce8e38f 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -13,7 +13,7 @@ This guide walks you through how to install NGINX Kubernetes Gateway on a generi 1. Clone the repo and change into the `nginx-kubernetes-gateway` directory: ``` - git clone https://github.com/nginxinc/nginx-kubernetes-gateway.git + git clone https://github.com/nginxinc/nginx-kubernetes-gateway.git --branch v0.2.0 cd nginx-kubernetes-gateway ``` From e507b068914544df024a1763d30f5e50f4b7e6c0 Mon Sep 17 00:00:00 2001 From: Michael Pleshakov Date: Mon, 24 Oct 2022 19:12:36 -0400 Subject: [PATCH 2/2] Update changelog and readme for release 0.2.0 --- CHANGELOG.md | 32 ++++++++++++++++++++++++++++++++ README.md | 10 +++++++--- 2 files changed, 39 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 98d6894ceb..e4e2a8570f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,38 @@ This document includes a curated changelog for each release. We also publish a changelog as the description of a [GitHub release](https://github.com/nginxinc/nginx-kubernetes-gateway/releases), which, by contrast, is auto-generated and includes links to all PRs that went into the release. +## Release 0.2.0 + +*October 24, 2022* + +This release extends the support of the features of the Gateway API resources. + +FEATURES: +* Support the Pod IPs instead of the virtual IP of a Service in the NGINX upstream. Additionally, NGINX Kubernetes Gateway will pick up any changes to the Pod IPs and update the NGINX upstream accordingly. [PR-221](https://github.com/nginxinc/nginx-kubernetes-gateway/pull/221) +* Support the redirect filter in an HTTPRoute rule. [PR-218](https://github.com/nginxinc/nginx-kubernetes-gateway/pull/218) +* Support weights in backendRefs in the HTTPRoute (traffic splitting). [PR-261](https://github.com/nginxinc/nginx-kubernetes-gateway/pull/261) +* Support the ObservedGeneration field in the HTTPRoute status. [PR-254](https://github.com/nginxinc/nginx-kubernetes-gateway/pull/254) + +BUG FIXES: +* Do not require the namespace in the `--gateway-ctlr-name` cli argument. [PR-235](https://github.com/nginxinc/nginx-kubernetes-gateway/pull/235) +* Ensure NGINX Kubernetes Gateway exits gracefully during shutdown. [PR-250](https://github.com/nginxinc/nginx-kubernetes-gateway/pull/250) +* Handle query param names in case-sensitive way. [PR-220](https://github.com/nginxinc/nginx-kubernetes-gateway/pull/220) + +DEPENDENCIES: +* Use the latest NGINX 1.23 image. [PR-275](https://github.com/nginxinc/nginx-kubernetes-gateway/pull/275) +* Bump sigs.k8s.io/gateway-api from 0.5.0 to 0.5.1 [PR-251](https://github.com/nginxinc/nginx-kubernetes-gateway/pull/251) + + +COMPATIBILITY: +- The Gateway API version: `0.5.1` +- NGINX version: `1.21.x` * +- Kubernetes version: `1.21+` + +\*the installation manifests use the `nginx:1.21` image, which always points to the latest version of 1.21.x releases. + +CONTAINER IMAGES: +- Control plane: `ghcr.io/nginxinc/nginx-kubernetes-gateway:0.2.0` + ## Release 0.1.0 *August 22, 2022* diff --git a/README.md b/README.md index c951ea2e9b..7a4ab08f2f 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,7 @@ For a list of supported Gateway API resources and features, see the [Gateway API We publish NGINX Kubernetes Gateway releases on GitHub. See our [releases page](https://github.com/nginxinc/nginx-kubernetes-gateway/releases). -The latest release is [0.1.0](https://github.com/nginxinc/kubernetes-ingress/releases/tag/v0.1.0). +The latest release is [0.2.0](https://github.com/nginxinc/kubernetes-ingress/releases/tag/v0.2.0). The edge version is useful for experimenting with new features that are not yet published in a release. To use, choose the *edge* version built from the [latest commit](https://github.com/nginxinc/nginx-kubernetes-gateway/commits/main) from the main branch. @@ -35,7 +35,7 @@ The table below summarizes the options regarding the images, manifests, document | Version | Description | Image | Installation Manifests | Documentation and Examples | |-|-|-|-|-| -| Latest release | For experimental use | Use the 0.1.0 image from [GitHub](https://github.com/nginxinc/nginx-kubernetes-gateway/pkgs/container/nginx-kubernetes-gateway) | [Manifests](https://github.com/nginxinc/nginx-kubernetes-gateway/tree/v0.1.0/deploy). | [Documentation](https://github.com/nginxinc/nginx-kubernetes-gateway/tree/v0.1.0/docs). [Examples](https://github.com/nginxinc/nginx-kubernetes-gateway/tree/v0.1.0/examples). | +| Latest release | For experimental use | Use the 0.2.0 image from [GitHub](https://github.com/nginxinc/nginx-kubernetes-gateway/pkgs/container/nginx-kubernetes-gateway) | [Manifests](https://github.com/nginxinc/nginx-kubernetes-gateway/tree/v0.2.0/deploy). | [Documentation](https://github.com/nginxinc/nginx-kubernetes-gateway/tree/v0.2.0/docs). [Examples](https://github.com/nginxinc/nginx-kubernetes-gateway/tree/v0.2.0/examples). | | Edge| For experimental use and latest features | Use the edge image from [GitHub](https://github.com/nginxinc/nginx-kubernetes-gateway/pkgs/container/nginx-kubernetes-gateway) | [Manifests](https://github.com/nginxinc/nginx-kubernetes-gateway/tree/main/deploy). | [Documentation](https://github.com/nginxinc/nginx-kubernetes-gateway/tree/main/docs). [Examples](https://github.com/nginxinc/nginx-kubernetes-gateway/tree/main/examples). | ## Technical Specifications @@ -43,7 +43,11 @@ The following table lists the software versions NGINX Kubernetes Gateway support | NGINX Kubernetes Gateway | Gateway API | Kubernetes | NGINX OSS | |-|-|-|-| -| 0.1.0 | 0.5.0 | 1.19+ | 1.21.3| +| Edge | 0.5.1 | 1.21+ | 1.21.x *| +| 0.2.0 | 0.5.1 | 1.21+ | 1.21.x *| +| 0.1.0 | 0.5.0 | 1.19+ | 1.21.3 | + +\*the installation manifests use the `nginx:1.21` image, which always points to the latest version of 1.21.x releases. ## Contacts