Skip to content

Commit

Permalink
docs: add a "releases" tab (envoyproxy#2160)
Browse files Browse the repository at this point in the history
* Add a release tab in docs

Signed-off-by: lemonlinger <lemonlinger@gmail.com>

* Add release notes docs

Signed-off-by: lemonlinger <lemonlinger@gmail.com>

---------

Signed-off-by: lemonlinger <lemonlinger@gmail.com>
Co-authored-by: Xunzhuo <bitliu@tencent.com>
  • Loading branch information
lemonlinger and Xunzhuo authored Dec 6, 2023
1 parent e0301d1 commit 8d65767
Show file tree
Hide file tree
Showing 13 changed files with 670 additions and 0 deletions.
5 changes: 5 additions & 0 deletions site/content/en/latest/releases/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Releases"
weight: 90
description: This section includes Releases of Envoy Gateway.
---
9 changes: 9 additions & 0 deletions site/content/en/latest/releases/v0.1.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
title: "v0.1.0"
publishdate: 2022-05-16
---

Date: May 16, 2022

## Documentation
- The initial open source release describing project goals and high-level design.
37 changes: 37 additions & 0 deletions site/content/en/latest/releases/v0.2.0-rc.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
title: "v0.2.0-rc.1"
publishdate: 2022-08-31
---

Date: August 31, 2022

## Documentation
- Added a quickstart guide for users to run and use Envoy Gateway.

## API
- Added the EnvoyGateway API type for configuring Envoy Gateway.
- Added the EnvoyProxy API type for configuring managed Envoys.

## CI
- Added tooling to build, run, etc. Envoy Gateway.

## Providers
- Added the Kubernetes provider.

## xDS
- Added xDS server to configure managed Envoys.

## IR
- Added xds and infra IRs to decouple user-facing APIs from Envoy Gateway.
- Added IR validation.

## Translator
- Added the gatewayapi translator to translate Gateway API and associated resources to the IR and manage
- Gateway API status.

## Message Service
- Added infra and xds IR watchable map messages for inter-component communication.
- Added a Runner to each component to support pub/sub between components.

## Infra Manager
- Added Kubernetes Infra Manager to manage Envoy infrastructure running in a Kubernetes cluster.
34 changes: 34 additions & 0 deletions site/content/en/latest/releases/v0.2.0-rc.2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
---
title: "v0.2.0-rc.2"
publishdate: 2022-09-29
---

Date: September 29, 2022

## Documentation
- Updated and expanded developer documentation.
- Added `kube-demo` target to demonstrate Envoy Gateway functionality.
- Added developer debugging documentation.

## CI
- Added Gateway API conformance tests.

## Providers
- Added watchers for dependent resources of managed Envoy infrastructure.
- Added Gateway namespace/name labels to managed resources.
- Added support for finalizing the managed GatewayClass.

## xDS
- Updated xds server and Envoy bootstrap config to use Delta xDS.
- Added initial support for mTLS between the xDS server and Envoy.

## Translator
- Expanded support for Gateway API status.
- Added support for request modifier and redirect filters.
- Added support to return 500 responses for invalid backends.

## Message Service
- Updated IRs to support managing multiple Envoy fleets.

## Infra Manager
- Separate Envoy infrastructure is created per Gateway.
53 changes: 53 additions & 0 deletions site/content/en/latest/releases/v0.2.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
---
title: "v0.2.0"
publishdate: 2022-10-19
---

Date: October 19, 2022

## Documentation
- Added Config API, translator, roadmap, and message bus design documentation.
- Added documentation for releasing Envoy Gateway.
- Added user guides for configuring common tasks, e.g. HTTP request routing.
- Added support for the Sphinx documentation generator.

## API
- Added the EnvoyGateway API type for configuring Envoy Gateway.
- Added the EnvoyProxy API type for configuring managed Envoys.

## CI Tooling Testing
- Added tooling to build, run, etc. Envoy Gateway.
- Added Gateway API conformance tests.
- Added Make-based tooling to fetch all tools so checks (code lint, spellchecks) and tests can be run locally.
- Added support for releasing latest artifacts to GitHub.
- Added code coverage with a minimum 60% threshold.

## IR
- Added xds and infra IRs to decouple user-facing APIs from Envoy Gateway.
- Added IR validation.

## Translator
- Added the gatewayapi translator to translate Gateway API and associated resources to the IR and manage the status of Gateway API resources.
- Added the xDS translator to translate the xds IR to xDS resources.

## Message Service
- Added infra and xds IR watchable map messages for inter-component communication.
- Added a Runner to each Envoy Gateway component to support pub/sub between components.
- Added support for managing multiple separate Envoy proxy fleets.

## Infra Manager
- Added Kubernetes Infra Manager to manage Envoy infrastructure running in a Kubernetes cluster.
- Added support for managing a separate Envoy infrastructure per Gateway.

## Providers
- Added the Kubernetes provider with support for managing GatewayClass, Gateway, HTTPRoute, ReferenceGrant, and TLSRoute resources.
- Due to Issue #539, a ReferenceGrant is not removed from the system when unreferenced.
- Due to Issue #577, TLSRoute is not being tested for Gateway API conformance.
- Added watchers for dependent resources of managed Envoy infrastructure to trigger reconciliation.
- Added support for labeling managed infrastructure using Gateway namespace/name labels.
- Added support for finalizing the managed GatewayClass.

## xDS
- Added xDS server support to configure managed Envoys using Delta xDS.
- Added initial support for mTLS between the xDS server and managed Envoys.
- Due to envoyproxy/go-control-plane Issue #599, Envoy Gateway logs the private key of HTTPS listeners.
64 changes: 64 additions & 0 deletions site/content/en/latest/releases/v0.3.0-rc.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
---
title: "v0.3.0-rc.1"
publishdate: 2023-02-02
---

Date: February 02, 2023

## Documentation
- Added Support for Multiple Release Versions
- Added Support for Versioned Docs
- Added Release Details Docs
- Refactored Layout for User Docs

## API
- Upgraded to v0.6.0 Gateway API
- Added Support for the TCPRoute API
- Added Support for the UDPRoute API
- Added Support for the GRPCRoute API (Add to the ListenerStatus.SupportedKinds Field until https://github.com/envoyproxy/gateway/issues/950 is fixed.)
- Added Support for HTTPRoute URLRewrite Filter
- Added Support for HTTPRoute RequestMirror Filter
- Added Support for HTTPRoute ResponseHeaderModifier Filter
- Added APIs to Manage Envoy Deployment
- Added Support for Request Authentication
- Added Support for Global Rate Limiting
- Added Support for Routes ReferenceGrant
- Added Support for Namespace Server Config Type

## CI Tooling Testing
- Fixes Make Image Failed in Darwin
- Fixes Wait for Job Succeeded before conformance test
- Upgraded Echoserver Image Tag
- Added Support for User-Facing Version
- Added Support for Testing EG against Multiple Kubernetes Versions

## Conformance
- Enabled HTTPRouteInvalidParentRefNotMatchingListenerPort conformance test
- Enabled GatewayInvalidTLSConfiguration conformance test
- Enabled GatewayInvalidRouteKind conformance test
- Enabled HTTPRoutePartiallyInvalidViaInvalidReferenceGrant conformance test
- Enabled HTTPRouteReferenceGrant conformance test
- Enabled HTTPRouteMethodMatching conformance test

## IR
- Added TCP Listener per TLSRoute

## Translator
- Fixes Remove Stale Listener Condition
- Added Support for Suffix Matches for Headers
- Added Support for HTTP Method Matching to HTTPRoute
- Added Support for Regex Match Type
- Added Support for HTTPQueryParamMatch

## Providers
- Refactored Kubernetes Provider to Single Reconciler
- Upgraded Kube Provider Test Data Manifests to v0.6.0
- Removed Duplicate Settings from Bootstrap Config
- Updated Certgen to Use EG Namespace Env
- Added EnvoyProxy to Translator and Kube Infra Manager
- Upgraded Envoyproxy Image to envoy-dev latest in Main
- Removed EG Logs Private Key

## xDS
- Fixed Start xDS Server Watchable Map Panics
- Enabled Access Logging for xDS Components
77 changes: 77 additions & 0 deletions site/content/en/latest/releases/v0.3.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
---
title: "v0.3.0"
publishdate: 2023-02-09
---

Date: February 09, 2023

## Documentation
- Added Global Rate Limit User Docs
- Added Request Authentication User Docs
- Added TCP Routing User Docs
- Added UDP Routing User Docs
- Added GRPC Routing User Docs
- Added HTTP Response Headers User Docs
- Added TCP and UDP Proxy Design Docs
- Added egctl Design Docs
- Added Rate Limit Design Docs
- Added Request Authentication Design Docs
- Added Support for Versioned Docs
- Added Support for Multiple Release Versions
- Added Release Details Docs
- Added API Docs Generating Tooling
- Refactored Layout for User Docs

## API
- Upgraded to v0.6.1 Gateway API
- Added Support for the TCPRoute API
- Added Support for the UDPRoute API
- Added Support for the GRPCRoute API
- Added Support for HTTPRoute URLRewrite Filter
- Added Support for HTTPRoute RequestMirror Filter
- Added Support for HTTPRoute ResponseHeaderModifier Filter
- Added Support for Request Authentication
- Added Support for Global Rate Limiting
- Added Support for Routes ReferenceGrant
- Added Support for Namespace Server Config Type
- Added initial management of Envoy Proxy deployment via EnvoyProxy API

## CI Tooling Testing
- Fixed Make Image Failed in Darwin
- Fixed Wait for Job Succeeded before conformance test
- Upgraded Echoserver Image Tag
- Added Support for User-Facing Version
- Added Support for Testing EG against Multiple Kubernetes Versions

## Conformance
- Enabled GatewayClassObservedGenerationBump conformance test
- Enabled GatewayInvalidTLSConfiguration conformance test
- Enabled GatewayInvalidRouteKind conformance test
- Enabled HTTPRouteReferenceGrant conformance test
- Enabled HTTPRouteMethodMatching conformance test
- Enabled HTTPRoutePartiallyInvalidViaInvalidReferenceGrant conformance test
- Enabled HTTPRouteInvalidParentRefNotMatchingListenerPort conformance test
- (Currently EG passes all conformance tests except redirect and gateway/httproute ObservedGenerationBump tests. Redirect tests are failing due to a possible issue with the way upstream conformance tests have made assumptions. Skip them for now until below issues #992 #993 #994 are resolved)

## IR
- Added TCP Listener per TLSRoute

## Translator
- Fixes Remove Stale Listener Condition
- Added Support for Suffix Matches for Headers
- Added Support for HTTP Method Matching to HTTPRoute
- Added Support for Regex Match Type
- Added Support for HTTPQueryParamMatch

## Providers
- Refactored Kubernetes Provider to Single Reconciler
- Upgraded Kube Provider Test Data Manifests to v0.6.1
- Removed Duplicate Settings from Bootstrap Config
- Updated Certgen to Use EG Namespace Env
- Added EnvoyProxy to Translator and Kube Infra Manager
- Upgraded Envoyproxy Image to envoy-dev latest in Main
- Removed EG Logs Private Key

## xDS
- Fixed Start xDS Server Watchable Map Panics
- Enabled Access Logging for xDS Components
56 changes: 56 additions & 0 deletions site/content/en/latest/releases/v0.4.0-rc.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: "v0.4.0-rc.1"
publishdate: 2023-04-13
---

Date: April 13, 2023

## Documentation
- Added Docs for Installing and Using egctl

## Installation
- Added Helm Installation Support
- Added Support for Ratelimiting Based On IP Subnet
- Added Gateway API Support Doc

## API
- Upgraded to Gateway API v0.6.2
- Added Support for Custom Envoy Proxy Bootstrap Config
- Added Support for Configuring the Envoy Proxy Image and Service
- Added Support for Configuring Annotations, Resources, and Securitycontext Settings on Ratelimit Infra and Envoy Proxy
- Added Support for Using Multiple Certificates on a Single Fully Qualified Domain Name
- Gateway Status Address is now Populated for ClusterIP type Envoy Services
- Envoy Proxy Pod and Container SecurityContext is now Configurable
- Added Custom Envoy Gateway Extensions Framework
- Added Support for Service Method Match in GRPCRoute

## CI Tooling Testing
- Fixed CI Flakes During Helm Install
- Added Test To Ensure Static xDS Cluster Has Same Field Values as Dynamic Cluster
- Added egctl to Build and Test CI Workflow
- Code Coverage Thresholds are now Enforced by CI
- Fixed latest-release-check CI Job Failures
- Added Auto Release Tooling for Charts

## Conformance
- Enabled GatewayWithAttachedRoutes Test
- Enabled Enable HTTPRouteInvalidParentRefNotMatchingSectionName Test
- Enabled Enable HTTPRouteDisallowedKind Test
- Re-Enabled Gateway/HTTPRouteObservedGenerationBump Test

## Translator
- Added Support for Dynamic GatewayControllerName in Route Status

## Providers
- Update GatewayClass Status Based on EnvoyProxy Config Validation

## xDS
- Added EDS Support
- Fixed PathSeparatedPrefix and Optimized Logic for Prefixes Ending With Trailing Slash
- Updated Deprecated RegexMatcher
- Refactored Authn and Ratelimit Features to Reuse buildXdsCluster

## Cli
- Added egctl CLI Tool
- Added egctl Support for Dry Runs of Gateway API Config
- Added egctl Support for Dumping Envoy Proxy xDS Resources
Loading

0 comments on commit 8d65767

Please sign in to comment.