From 35005f0f0899394a6892062d4f8da3d70fa2a126 Mon Sep 17 00:00:00 2001
From: Mark Mandel <markmandel@google.com>
Date: Fri, 9 Jul 2021 09:42:27 -0700
Subject: [PATCH] Release 0.1.0 (#326)

* Added the CHANGELOG.md
* Update version numbers to the release versions
* Tweaks to the release checklist
* Added a README to quilkin-macros, otherwise `cargo publish --dry-run`
errored.

Work on #325
---
 CHANGELOG.md                     | 295 +++++++++++++++++++++++++++++++
 Cargo.toml                       |   4 +-
 build/templates/release-issue.md |  12 +-
 macros/Cargo.toml                |   2 +-
 macros/README.md                 |   7 +
 5 files changed, 311 insertions(+), 9 deletions(-)
 create mode 100644 CHANGELOG.md
 create mode 100644 macros/README.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000000..3ff93acd96
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,295 @@
+# Changelog
+
+## [v0.1.0](https://github.com/googleforgames/quilkin/tree/v0.1.0) (2021-07-08)
+
+[Full Changelog](https://github.com/googleforgames/quilkin/compare/d60c41ce257c77a4daafb5ab645536f8e1f2aa14...v0.1.0)
+
+**Implemented enhancements:**
+
+- Regular updates to Nightly for CI build step [\#287](https://github.com/googleforgames/quilkin/issues/287)
+- Convention: quilkin.yaml file [\#270](https://github.com/googleforgames/quilkin/issues/270)
+- Write a github PR comment notifier for cloudbuilds [\#259](https://github.com/googleforgames/quilkin/issues/259)
+- Idea: Proc macro for creating filters/filter factories [\#248](https://github.com/googleforgames/quilkin/issues/248)
+- Add cargo-deny config [\#239](https://github.com/googleforgames/quilkin/issues/239)
+- Example: Grafana dashboard\(s\) [\#234](https://github.com/googleforgames/quilkin/issues/234)
+- Examples for Alpha Launch [\#228](https://github.com/googleforgames/quilkin/issues/228)
+- Create release process + checklist [\#213](https://github.com/googleforgames/quilkin/issues/213)
+- Create linux docker images on release [\#201](https://github.com/googleforgames/quilkin/issues/201)
+- Metrics: Packet processing time [\#167](https://github.com/googleforgames/quilkin/issues/167)
+- Make metric port configurable [\#101](https://github.com/googleforgames/quilkin/issues/101)
+- Add support to invoke filter chain in reverse order [\#92](https://github.com/googleforgames/quilkin/issues/92)
+- Version configuration [\#77](https://github.com/googleforgames/quilkin/issues/77)
+- FilterChain for each Session [\#75](https://github.com/googleforgames/quilkin/issues/75)
+- \[Alpha Release\] Let's write some documentation [\#62](https://github.com/googleforgames/quilkin/issues/62)
+- Cross Compilation [\#19](https://github.com/googleforgames/quilkin/issues/19)
+- Expose Metrics [\#11](https://github.com/googleforgames/quilkin/issues/11)
+- gRPC configuration management control plane API [\#10](https://github.com/googleforgames/quilkin/issues/10)
+- Filter idea: Simple routing with every packet having the connection id appended [\#8](https://github.com/googleforgames/quilkin/issues/8)
+- Basic non-transparent UDP proxying from Receiver to all endpoints [\#7](https://github.com/googleforgames/quilkin/issues/7)
+- Basic non-transparent UDP proxying from Sender to Receiver [\#6](https://github.com/googleforgames/quilkin/issues/6)
+- \[Client\] LB across multiple endpoints? [\#3](https://github.com/googleforgames/quilkin/issues/3)
+- Design and Implementation of Filters [\#1](https://github.com/googleforgames/quilkin/issues/1)
+- Make + Docker toolchain for development [\#303](https://github.com/googleforgames/quilkin/pull/303) ([markmandel](https://github.com/markmandel))
+- Example Grafana dashboard for Quilkin Metrics [\#300](https://github.com/googleforgames/quilkin/pull/300) ([markmandel](https://github.com/markmandel))
+- Quilkin logo and Quilly the mascot [\#289](https://github.com/googleforgames/quilkin/pull/289) ([markmandel](https://github.com/markmandel))
+- Add rust-toolchain.toml to project [\#249](https://github.com/googleforgames/quilkin/pull/249) ([markmandel](https://github.com/markmandel))
+- Quickstart for Agones + Quilkin [\#235](https://github.com/googleforgames/quilkin/pull/235) ([markmandel](https://github.com/markmandel))
+- Quickstart using netcat [\#231](https://github.com/googleforgames/quilkin/pull/231) ([markmandel](https://github.com/markmandel))
+- Usage documentation [\#230](https://github.com/googleforgames/quilkin/pull/230) ([markmandel](https://github.com/markmandel))
+- Agones and Xonotic Examples [\#229](https://github.com/googleforgames/quilkin/pull/229) ([markmandel](https://github.com/markmandel))
+- Release checklist [\#226](https://github.com/googleforgames/quilkin/pull/226) ([markmandel](https://github.com/markmandel))
+- Create a CHANGELOG.md on release [\#225](https://github.com/googleforgames/quilkin/pull/225) ([markmandel](https://github.com/markmandel))
+- Add /live health endpoint to admin server [\#221](https://github.com/googleforgames/quilkin/pull/221) ([markmandel](https://github.com/markmandel))
+- Release and Debug image release pipeline [\#214](https://github.com/googleforgames/quilkin/pull/214) ([markmandel](https://github.com/markmandel))
+- Build Windows & Linux Binaries in Cloud Build [\#209](https://github.com/googleforgames/quilkin/pull/209) ([markmandel](https://github.com/markmandel))
+- Document xDS, filter/endpoint metadata [\#203](https://github.com/googleforgames/quilkin/pull/203) ([iffyio](https://github.com/iffyio))
+- Implementation and test of Filter ordering [\#198](https://github.com/googleforgames/quilkin/pull/198) ([markmandel](https://github.com/markmandel))
+- Add xDS metrics [\#195](https://github.com/googleforgames/quilkin/pull/195) ([iffyio](https://github.com/iffyio))
+- on\_read & on-write config for ConcatenateBytes  [\#186](https://github.com/googleforgames/quilkin/pull/186) ([markmandel](https://github.com/markmandel))
+- Documentation for the Compress filter [\#181](https://github.com/googleforgames/quilkin/pull/181) ([markmandel](https://github.com/markmandel))
+- Add XDS Filter implementation [\#171](https://github.com/googleforgames/quilkin/pull/171) ([iffyio](https://github.com/iffyio))
+- Implementation of Compression Filter. [\#162](https://github.com/googleforgames/quilkin/pull/162) ([markmandel](https://github.com/markmandel))
+- xds fail fast on invalid URI [\#161](https://github.com/googleforgames/quilkin/pull/161) ([iffyio](https://github.com/iffyio))
+- Endpoint metadata support from static config [\#160](https://github.com/googleforgames/quilkin/pull/160) ([iffyio](https://github.com/iffyio))
+- Generate proto files for XDS filter configs [\#159](https://github.com/googleforgames/quilkin/pull/159) ([iffyio](https://github.com/iffyio))
+- Include metadata for XDS endpoints [\#154](https://github.com/googleforgames/quilkin/pull/154) ([iffyio](https://github.com/iffyio))
+- Add dynamic proxy configuration [\#150](https://github.com/googleforgames/quilkin/pull/150) ([iffyio](https://github.com/iffyio))
+- Add session metrics to docs [\#143](https://github.com/googleforgames/quilkin/pull/143) ([iffyio](https://github.com/iffyio))
+- Add example integration architecture documentation [\#139](https://github.com/googleforgames/quilkin/pull/139) ([markmandel](https://github.com/markmandel))
+- Add an overview to the documentation [\#137](https://github.com/googleforgames/quilkin/pull/137) ([markmandel](https://github.com/markmandel))
+- EndpointAuthentication filter [\#135](https://github.com/googleforgames/quilkin/pull/135) ([markmandel](https://github.com/markmandel))
+- Add a ClusterManager abstraction [\#128](https://github.com/googleforgames/quilkin/pull/128) ([iffyio](https://github.com/iffyio))
+- Authentication Token Capture Filter [\#118](https://github.com/googleforgames/quilkin/pull/118) ([markmandel](https://github.com/markmandel))
+- Add XDS client [\#115](https://github.com/googleforgames/quilkin/pull/115) ([iffyio](https://github.com/iffyio))
+- Add XDS logic for cluster and endpoints [\#112](https://github.com/googleforgames/quilkin/pull/112) ([iffyio](https://github.com/iffyio))
+- Concat Byte Filter [\#111](https://github.com/googleforgames/quilkin/pull/111) ([markmandel](https://github.com/markmandel))
+- Add xds proto code generation [\#108](https://github.com/googleforgames/quilkin/pull/108) ([iffyio](https://github.com/iffyio))
+- Be able to pass data between Filters [\#107](https://github.com/googleforgames/quilkin/pull/107) ([markmandel](https://github.com/markmandel))
+- Add test helper to manage test resources [\#106](https://github.com/googleforgames/quilkin/pull/106) ([iffyio](https://github.com/iffyio))
+- Add GRPC proto submodules [\#105](https://github.com/googleforgames/quilkin/pull/105) ([iffyio](https://github.com/iffyio))
+- Added ConnectionConfig to CreateFilterArgs [\#93](https://github.com/googleforgames/quilkin/pull/93) ([markmandel](https://github.com/markmandel))
+- Add rate limiter metrics [\#87](https://github.com/googleforgames/quilkin/pull/87) ([iffyio](https://github.com/iffyio))
+- Add rate limiter config and integration test [\#81](https://github.com/googleforgames/quilkin/pull/81) ([iffyio](https://github.com/iffyio))
+- Convert connection\_id's to base64 byte arrays [\#79](https://github.com/googleforgames/quilkin/pull/79) ([markmandel](https://github.com/markmandel))
+- Validate that addresses are unique [\#74](https://github.com/googleforgames/quilkin/pull/74) ([markmandel](https://github.com/markmandel))
+- Lazy instantiation of Filters [\#71](https://github.com/googleforgames/quilkin/pull/71) ([markmandel](https://github.com/markmandel))
+- Add local rate limiting [\#69](https://github.com/googleforgames/quilkin/pull/69) ([iffyio](https://github.com/iffyio))
+- Add Validation to Config [\#68](https://github.com/googleforgames/quilkin/pull/68) ([markmandel](https://github.com/markmandel))
+- Implementation of endpoint\_receive\_filter [\#59](https://github.com/googleforgames/quilkin/pull/59) ([markmandel](https://github.com/markmandel))
+- Implementation of endpoint\_send\_filter [\#58](https://github.com/googleforgames/quilkin/pull/58) ([markmandel](https://github.com/markmandel))
+- Session should track Endpoint as destination [\#57](https://github.com/googleforgames/quilkin/pull/57) ([markmandel](https://github.com/markmandel))
+- Add client proxy load balancing support [\#56](https://github.com/googleforgames/quilkin/pull/56) ([iffyio](https://github.com/iffyio))
+- Implementation of local\_send\_filter [\#55](https://github.com/googleforgames/quilkin/pull/55) ([markmandel](https://github.com/markmandel))
+- Implementation of local\_receive\_filter [\#53](https://github.com/googleforgames/quilkin/pull/53) ([markmandel](https://github.com/markmandel))
+- Add recv\_addr to endpoint\_receive\_filter [\#51](https://github.com/googleforgames/quilkin/pull/51) ([markmandel](https://github.com/markmandel))
+- Implementation of FilterChain [\#45](https://github.com/googleforgames/quilkin/pull/45) ([markmandel](https://github.com/markmandel))
+- Implementation of DebugFilter [\#44](https://github.com/googleforgames/quilkin/pull/44) ([markmandel](https://github.com/markmandel))
+- Cleanup Server \> run - run\_recv\_from [\#43](https://github.com/googleforgames/quilkin/pull/43) ([markmandel](https://github.com/markmandel))
+- Integration Test for client-\>server and back [\#38](https://github.com/googleforgames/quilkin/pull/38) ([markmandel](https://github.com/markmandel))
+- Expand Filter Trait for sending and receiving [\#37](https://github.com/googleforgames/quilkin/pull/37) ([markmandel](https://github.com/markmandel))
+- Ability to be a library and binary [\#36](https://github.com/googleforgames/quilkin/pull/36) ([markmandel](https://github.com/markmandel))
+- Stub for default filters [\#35](https://github.com/googleforgames/quilkin/pull/35) ([markmandel](https://github.com/markmandel))
+- Implementation of Filter API and FilterRegistry [\#33](https://github.com/googleforgames/quilkin/pull/33) ([markmandel](https://github.com/markmandel))
+- Implementation of the Filter data structure. [\#31](https://github.com/googleforgames/quilkin/pull/31) ([markmandel](https://github.com/markmandel))
+- Implementation of Session expiration. [\#27](https://github.com/googleforgames/quilkin/pull/27) ([markmandel](https://github.com/markmandel))
+- Track expiration times for Sessions [\#26](https://github.com/googleforgames/quilkin/pull/26) ([markmandel](https://github.com/markmandel))
+- Architecture diagram for README page. [\#15](https://github.com/googleforgames/quilkin/pull/15) ([markmandel](https://github.com/markmandel))
+
+**Fixed bugs:**
+
+- CI should use stable clippy [\#281](https://github.com/googleforgames/quilkin/issues/281)
+- ICE when running `cargo +nightly test`. [\#276](https://github.com/googleforgames/quilkin/issues/276)
+- Flaky Test: local\_rate\_limit tests [\#177](https://github.com/googleforgames/quilkin/issues/177)
+- Bug: Changelog didn't have the version [\#324](https://github.com/googleforgames/quilkin/pull/324) ([markmandel](https://github.com/markmandel))
+- Bugs/cleanup in netcat quickstart [\#322](https://github.com/googleforgames/quilkin/pull/322) ([markmandel](https://github.com/markmandel))
+- Remove `name` from all examples and configurations [\#295](https://github.com/googleforgames/quilkin/pull/295) ([markmandel](https://github.com/markmandel))
+- Fix release cloudbuild with rust-toolchain.yaml [\#255](https://github.com/googleforgames/quilkin/pull/255) ([markmandel](https://github.com/markmandel))
+- Fix rate limiter flaky test [\#178](https://github.com/googleforgames/quilkin/pull/178) ([iffyio](https://github.com/iffyio))
+- Don't panic on debug when packets aren't utf-8 [\#156](https://github.com/googleforgames/quilkin/pull/156) ([markmandel](https://github.com/markmandel))
+- Fix bug in UpstreamEndpoints::retain [\#145](https://github.com/googleforgames/quilkin/pull/145) ([markmandel](https://github.com/markmandel))
+- Run clippy first in CI [\#100](https://github.com/googleforgames/quilkin/pull/100) ([iffyio](https://github.com/iffyio))
+- Filters shouldn't require configs [\#96](https://github.com/googleforgames/quilkin/pull/96) ([markmandel](https://github.com/markmandel))
+
+**Closed issues:**
+
+- Dev: make it easier to make build a container [\#296](https://github.com/googleforgames/quilkin/issues/296)
+- Give Quilkin Bot Art [\#278](https://github.com/googleforgames/quilkin/issues/278)
+- Add Error Handling Library [\#269](https://github.com/googleforgames/quilkin/issues/269)
+- Design Question: `FilterFactory::name` returning `String` [\#251](https://github.com/googleforgames/quilkin/issues/251)
+- Use `rust-toolchain` to manage Rust version. [\#241](https://github.com/googleforgames/quilkin/issues/241)
+- Migrate CI build step to Artifact Registry [\#202](https://github.com/googleforgames/quilkin/issues/202)
+- Refactor Compress Filter with on\_read & on\_write configuration [\#196](https://github.com/googleforgames/quilkin/issues/196)
+- Refactor Filter to have `read` and `write` methods [\#192](https://github.com/googleforgames/quilkin/issues/192)
+- Move deny warnings to CI [\#189](https://github.com/googleforgames/quilkin/issues/189)
+- CI: Reuse downloaded / compiled libraries between steps [\#173](https://github.com/googleforgames/quilkin/issues/173)
+- Mark a configuration as having passed validation before using it [\#172](https://github.com/googleforgames/quilkin/issues/172)
+- Pass shutdown channel to run\_prune\_sessions [\#165](https://github.com/googleforgames/quilkin/issues/165)
+- Implement session close inside drop [\#164](https://github.com/googleforgames/quilkin/issues/164)
+- Is there a benefit to proxy\_mode? [\#163](https://github.com/googleforgames/quilkin/issues/163)
+- Avoid need to clone metadata keys [\#155](https://github.com/googleforgames/quilkin/issues/155)
+- Set log level [\#153](https://github.com/googleforgames/quilkin/issues/153)
+- Remove name field from Endpoint objects [\#152](https://github.com/googleforgames/quilkin/issues/152)
+- Do not parse packets as utf8 [\#151](https://github.com/googleforgames/quilkin/issues/151)
+- Refactor UpstreamEndpoints retain to return enum [\#146](https://github.com/googleforgames/quilkin/issues/146)
+- Avoid copying endpoints list for every packet [\#138](https://github.com/googleforgames/quilkin/issues/138)
+- Proxy config file format [\#130](https://github.com/googleforgames/quilkin/issues/130)
+- Add default method impl to Filter trait [\#124](https://github.com/googleforgames/quilkin/issues/124)
+- Use custom struct implementation for filter values [\#122](https://github.com/googleforgames/quilkin/issues/122)
+- Add documentation entry for filter values [\#121](https://github.com/googleforgames/quilkin/issues/121)
+- Public chat room [\#119](https://github.com/googleforgames/quilkin/issues/119)
+- Refactor Client.lb\_policy into it's own filter [\#103](https://github.com/googleforgames/quilkin/issues/103)
+- FilterChain: Arguments should be a context object, and return a response object [\#94](https://github.com/googleforgames/quilkin/issues/94)
+- Add helper to manage test resources [\#84](https://github.com/googleforgames/quilkin/issues/84)
+- Add clippy to ci [\#82](https://github.com/googleforgames/quilkin/issues/82)
+- Consolidate Filter Trait to two functions [\#80](https://github.com/googleforgames/quilkin/issues/80)
+- Add health endpoint [\#73](https://github.com/googleforgames/quilkin/issues/73)
+- Avoid unnecessary cloning in Filter trait [\#72](https://github.com/googleforgames/quilkin/issues/72)
+- Use a consistent pattern for error handling [\#67](https://github.com/googleforgames/quilkin/issues/67)
+- Filter Idea: Compression Filter [\#47](https://github.com/googleforgames/quilkin/issues/47)
+- Should sender/receiver be client/server as concepts? [\#22](https://github.com/googleforgames/quilkin/issues/22)
+- Integration Tests [\#4](https://github.com/googleforgames/quilkin/issues/4)
+- Continuous Integration [\#2](https://github.com/googleforgames/quilkin/issues/2)
+
+**Merged pull requests:**
+
+- Ignore priority/wontfix for changelog [\#323](https://github.com/googleforgames/quilkin/pull/323) ([markmandel](https://github.com/markmandel))
+- Tweaks to release checklist. [\#314](https://github.com/googleforgames/quilkin/pull/314) ([markmandel](https://github.com/markmandel))
+- Move Cloud Build test and release to Makefile [\#312](https://github.com/googleforgames/quilkin/pull/312) ([markmandel](https://github.com/markmandel))
+- Exclude items from crate [\#311](https://github.com/googleforgames/quilkin/pull/311) ([markmandel](https://github.com/markmandel))
+- Remove redundant clones [\#307](https://github.com/googleforgames/quilkin/pull/307) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Nightly builds of CI and Release Cloud Build Steps [\#306](https://github.com/googleforgames/quilkin/pull/306) ([markmandel](https://github.com/markmandel))
+- Use `thiserror` for Error definitions [\#304](https://github.com/googleforgames/quilkin/pull/304) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Fix for Apache Licence header [\#302](https://github.com/googleforgames/quilkin/pull/302) ([markmandel](https://github.com/markmandel))
+- Fix metric typo in proxy documentation [\#299](https://github.com/googleforgames/quilkin/pull/299) ([markmandel](https://github.com/markmandel))
+- Center image in README [\#298](https://github.com/googleforgames/quilkin/pull/298) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Add Prometheus scraping to Xonotic example [\#297](https://github.com/googleforgames/quilkin/pull/297) ([markmandel](https://github.com/markmandel))
+- Update release checklist to include quilkin-macros [\#294](https://github.com/googleforgames/quilkin/pull/294) ([markmandel](https://github.com/markmandel))
+- Output the rust version for each build. [\#288](https://github.com/googleforgames/quilkin/pull/288) ([markmandel](https://github.com/markmandel))
+- Refactor and break out top-level filter module. [\#286](https://github.com/googleforgames/quilkin/pull/286) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Use `include\_str!` instead of `doc\(include\)` [\#284](https://github.com/googleforgames/quilkin/pull/284) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Use channel size of 1 to send xds updates [\#283](https://github.com/googleforgames/quilkin/pull/283) ([iffyio](https://github.com/iffyio))
+- Fixes from clippy [\#282](https://github.com/googleforgames/quilkin/pull/282) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Add default configuration file conventions. [\#279](https://github.com/googleforgames/quilkin/pull/279) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Use 2018 mod style [\#277](https://github.com/googleforgames/quilkin/pull/277) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Use sampled logging for token router errors [\#275](https://github.com/googleforgames/quilkin/pull/275) ([iffyio](https://github.com/iffyio))
+- Reject config if it contains unknown fields [\#274](https://github.com/googleforgames/quilkin/pull/274) ([iffyio](https://github.com/iffyio))
+- Wait for execution result channel before recving [\#273](https://github.com/googleforgames/quilkin/pull/273) ([iffyio](https://github.com/iffyio))
+- Token Router: Note about token authorship [\#271](https://github.com/googleforgames/quilkin/pull/271) ([markmandel](https://github.com/markmandel))
+- Remove Session metric upstream & downstream labels [\#268](https://github.com/googleforgames/quilkin/pull/268) ([markmandel](https://github.com/markmandel))
+- Implement Github notification bot. [\#264](https://github.com/googleforgames/quilkin/pull/264) ([markmandel](https://github.com/markmandel))
+- Add execution measurement metrics to `FilterChain` [\#262](https://github.com/googleforgames/quilkin/pull/262) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Update dependencies, add deny.toml [\#261](https://github.com/googleforgames/quilkin/pull/261) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Fix links in rustdoc documentation [\#260](https://github.com/googleforgames/quilkin/pull/260) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Use clap macros for about and name info [\#257](https://github.com/googleforgames/quilkin/pull/257) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Improvements to Agones+Xonotic examples [\#254](https://github.com/googleforgames/quilkin/pull/254) ([markmandel](https://github.com/markmandel))
+- Add shutdown-rx to SessionManager::run\_prune\_sessions [\#253](https://github.com/googleforgames/quilkin/pull/253) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Add proc-macro for importing protobuf and defining filter IDs. [\#252](https://github.com/googleforgames/quilkin/pull/252) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Roadmap Complete - Remove from README [\#250](https://github.com/googleforgames/quilkin/pull/250) ([markmandel](https://github.com/markmandel))
+- Update Rust version to 1.51 [\#247](https://github.com/googleforgames/quilkin/pull/247) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Clippy fixes  [\#246](https://github.com/googleforgames/quilkin/pull/246) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Refactor UpstreamEndpoints::retain [\#245](https://github.com/googleforgames/quilkin/pull/245) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Close Session on drop, refactor `SessionManager::prune\_sessions` [\#244](https://github.com/googleforgames/quilkin/pull/244) ([XAMPPRocky](https://github.com/XAMPPRocky))
+- Add documentation for writing filters [\#243](https://github.com/googleforgames/quilkin/pull/243) ([iffyio](https://github.com/iffyio))
+- Add missing licences. [\#242](https://github.com/googleforgames/quilkin/pull/242) ([markmandel](https://github.com/markmandel))
+- Point COC contact to a Google Group. [\#240](https://github.com/googleforgames/quilkin/pull/240) ([markmandel](https://github.com/markmandel))
+- It's a FAQ [\#238](https://github.com/googleforgames/quilkin/pull/238) ([markmandel](https://github.com/markmandel))
+- Prepare to be released on crates.io [\#237](https://github.com/googleforgames/quilkin/pull/237) ([markmandel](https://github.com/markmandel))
+- Updates to README.md [\#236](https://github.com/googleforgames/quilkin/pull/236) ([markmandel](https://github.com/markmandel))
+- iperf3 performance testing example [\#227](https://github.com/googleforgames/quilkin/pull/227) ([markmandel](https://github.com/markmandel))
+- Merge sessions map and pruning logic [\#224](https://github.com/googleforgames/quilkin/pull/224) ([iffyio](https://github.com/iffyio))
+- Debug Filter: Capitalise log statement. [\#223](https://github.com/googleforgames/quilkin/pull/223) ([markmandel](https://github.com/markmandel))
+- Tick off gRPC configuration management control plane API [\#222](https://github.com/googleforgames/quilkin/pull/222) ([markmandel](https://github.com/markmandel))
+- Pull `Admin` module out of `Metrics` [\#220](https://github.com/googleforgames/quilkin/pull/220) ([markmandel](https://github.com/markmandel))
+- Missing `source` in `ClusterManager` logger. [\#219](https://github.com/googleforgames/quilkin/pull/219) ([markmandel](https://github.com/markmandel))
+- Fix `Admin` Config model and documentation [\#218](https://github.com/googleforgames/quilkin/pull/218) ([markmandel](https://github.com/markmandel))
+- Update slog and update logging to be consistent [\#217](https://github.com/googleforgames/quilkin/pull/217) ([markmandel](https://github.com/markmandel))
+- Fix old comment on Config. [\#216](https://github.com/googleforgames/quilkin/pull/216) ([markmandel](https://github.com/markmandel))
+- Move setup logic to lib to enable reuse [\#215](https://github.com/googleforgames/quilkin/pull/215) ([iffyio](https://github.com/iffyio))
+- Update proto submodules [\#212](https://github.com/googleforgames/quilkin/pull/212) ([iffyio](https://github.com/iffyio))
+- Wrap metadata keys in Arc [\#211](https://github.com/googleforgames/quilkin/pull/211) ([iffyio](https://github.com/iffyio))
+- Add xDS integration test [\#210](https://github.com/googleforgames/quilkin/pull/210) ([iffyio](https://github.com/iffyio))
+- Expose binary version as debug/release [\#208](https://github.com/googleforgames/quilkin/pull/208) ([markmandel](https://github.com/markmandel))
+- Add validated config type [\#207](https://github.com/googleforgames/quilkin/pull/207) ([iffyio](https://github.com/iffyio))
+- Use the same metrics registry for filters [\#206](https://github.com/googleforgames/quilkin/pull/206) ([iffyio](https://github.com/iffyio))
+- Move deny warnings to CI [\#205](https://github.com/googleforgames/quilkin/pull/205) ([markmandel](https://github.com/markmandel))
+- Migrate Container Registry ➡ Artifact Registry [\#204](https://github.com/googleforgames/quilkin/pull/204) ([markmandel](https://github.com/markmandel))
+- Mention filter reverse ordering in docs [\#200](https://github.com/googleforgames/quilkin/pull/200) ([iffyio](https://github.com/iffyio))
+- Ticking off roadmap items [\#199](https://github.com/googleforgames/quilkin/pull/199) ([markmandel](https://github.com/markmandel))
+- Refactor Compress with on\_read & on\_write config [\#197](https://github.com/googleforgames/quilkin/pull/197) ([markmandel](https://github.com/markmandel))
+- Rename Filter to align with Envoy concepts [\#194](https://github.com/googleforgames/quilkin/pull/194) ([markmandel](https://github.com/markmandel))
+- Add proto config for all filters [\#193](https://github.com/googleforgames/quilkin/pull/193) ([iffyio](https://github.com/iffyio))
+- Use an async task pool to process packets [\#191](https://github.com/googleforgames/quilkin/pull/191) ([iffyio](https://github.com/iffyio))
+- Enable XDS filter manager [\#190](https://github.com/googleforgames/quilkin/pull/190) ([iffyio](https://github.com/iffyio))
+- Add Ifeanyi to the authors file [\#187](https://github.com/googleforgames/quilkin/pull/187) ([markmandel](https://github.com/markmandel))
+- Replace warp with hyper for http server impl [\#184](https://github.com/googleforgames/quilkin/pull/184) ([iffyio](https://github.com/iffyio))
+- Remove doctest workaround for proto generated comments [\#183](https://github.com/googleforgames/quilkin/pull/183) ([iffyio](https://github.com/iffyio))
+- Reuse config deserialization logic across filters [\#182](https://github.com/googleforgames/quilkin/pull/182) ([iffyio](https://github.com/iffyio))
+- Add proxy configuration reference to README.md [\#180](https://github.com/googleforgames/quilkin/pull/180) ([markmandel](https://github.com/markmandel))
+- Integration test for Compress filter [\#179](https://github.com/googleforgames/quilkin/pull/179) ([markmandel](https://github.com/markmandel))
+- Improve Cloud Build build times [\#176](https://github.com/googleforgames/quilkin/pull/176) ([markmandel](https://github.com/markmandel))
+- Reuse static config deserialise logic [\#175](https://github.com/googleforgames/quilkin/pull/175) ([iffyio](https://github.com/iffyio))
+- Upgrade to Tokio 1.0 [\#170](https://github.com/googleforgames/quilkin/pull/170) ([markmandel](https://github.com/markmandel))
+- Removal of Proxy Mode [\#168](https://github.com/googleforgames/quilkin/pull/168) ([markmandel](https://github.com/markmandel))
+- Perf improvements [\#166](https://github.com/googleforgames/quilkin/pull/166) ([iffyio](https://github.com/iffyio))
+- Bunch of files without licences [\#157](https://github.com/googleforgames/quilkin/pull/157) ([markmandel](https://github.com/markmandel))
+- Updated to the Roadmap [\#148](https://github.com/googleforgames/quilkin/pull/148) ([markmandel](https://github.com/markmandel))
+- Update proxy configuration format [\#144](https://github.com/googleforgames/quilkin/pull/144) ([iffyio](https://github.com/iffyio))
+- Fix for CI grabbing submodules [\#142](https://github.com/googleforgames/quilkin/pull/142) ([markmandel](https://github.com/markmandel))
+- Default Filter trait implementation [\#141](https://github.com/googleforgames/quilkin/pull/141) ([markmandel](https://github.com/markmandel))
+- Add wrapper over Endpoints [\#140](https://github.com/googleforgames/quilkin/pull/140) ([iffyio](https://github.com/iffyio))
+- Remove remanining returns of Tokio Result [\#136](https://github.com/googleforgames/quilkin/pull/136) ([iffyio](https://github.com/iffyio))
+- Fix unit test for CaptureBytes [\#134](https://github.com/googleforgames/quilkin/pull/134) ([markmandel](https://github.com/markmandel))
+- Rename CaptureBytes context\_key ➡ metadata\_key [\#133](https://github.com/googleforgames/quilkin/pull/133) ([markmandel](https://github.com/markmandel))
+- Refactor Filter Values to Dynamic Metadata [\#132](https://github.com/googleforgames/quilkin/pull/132) ([markmandel](https://github.com/markmandel))
+- Replace oneshot shutdown signal with watch channel [\#129](https://github.com/googleforgames/quilkin/pull/129) ([iffyio](https://github.com/iffyio))
+- Updated development and community documentation [\#127](https://github.com/googleforgames/quilkin/pull/127) ([markmandel](https://github.com/markmandel))
+- Upgrade Rust toolchain [\#126](https://github.com/googleforgames/quilkin/pull/126) ([markmandel](https://github.com/markmandel))
+- Make LoadBalancer a filter [\#125](https://github.com/googleforgames/quilkin/pull/125) ([iffyio](https://github.com/iffyio))
+- Typo: ConcatBytes ➡ ConcatenateBytes [\#117](https://github.com/googleforgames/quilkin/pull/117) ([markmandel](https://github.com/markmandel))
+- Docs: Config is an object not an any [\#116](https://github.com/googleforgames/quilkin/pull/116) ([markmandel](https://github.com/markmandel))
+- Removal of client-\>connection\_id [\#114](https://github.com/googleforgames/quilkin/pull/114) ([markmandel](https://github.com/markmandel))
+- Rename DebugFilter -\> Debug to avoid redundancy [\#113](https://github.com/googleforgames/quilkin/pull/113) ([markmandel](https://github.com/markmandel))
+- Let's clippy our tests 👍 [\#110](https://github.com/googleforgames/quilkin/pull/110) ([markmandel](https://github.com/markmandel))
+- Use builder to create Config [\#109](https://github.com/googleforgames/quilkin/pull/109) ([iffyio](https://github.com/iffyio))
+- Pass context objects in filter APIs [\#102](https://github.com/googleforgames/quilkin/pull/102) ([iffyio](https://github.com/iffyio))
+- Validate config from external docs [\#99](https://github.com/googleforgames/quilkin/pull/99) ([iffyio](https://github.com/iffyio))
+- Refactor: debug\_filter -\> debug [\#95](https://github.com/googleforgames/quilkin/pull/95) ([markmandel](https://github.com/markmandel))
+- Add missing licence [\#91](https://github.com/googleforgames/quilkin/pull/91) ([markmandel](https://github.com/markmandel))
+- Test utility for filters with no change. [\#90](https://github.com/googleforgames/quilkin/pull/90) ([markmandel](https://github.com/markmandel))
+- Add filters docs and external doc tests support [\#89](https://github.com/googleforgames/quilkin/pull/89) ([iffyio](https://github.com/iffyio))
+- Documentation for LocalRateLimit Filter Metrics [\#88](https://github.com/googleforgames/quilkin/pull/88) ([markmandel](https://github.com/markmandel))
+- Add clippy to ci and fix warnings [\#85](https://github.com/googleforgames/quilkin/pull/85) ([iffyio](https://github.com/iffyio))
+- Refactor Filter to two functions [\#83](https://github.com/googleforgames/quilkin/pull/83) ([markmandel](https://github.com/markmandel))
+- Integration test for DebugFilter [\#78](https://github.com/googleforgames/quilkin/pull/78) ([markmandel](https://github.com/markmandel))
+- Add metrics integration test [\#76](https://github.com/googleforgames/quilkin/pull/76) ([iffyio](https://github.com/iffyio))
+- Cloud Build timeout to 30m [\#66](https://github.com/googleforgames/quilkin/pull/66) ([markmandel](https://github.com/markmandel))
+- Add metrics support [\#65](https://github.com/googleforgames/quilkin/pull/65) ([iffyio](https://github.com/iffyio))
+- End to End test for the TestFilter [\#64](https://github.com/googleforgames/quilkin/pull/64) ([markmandel](https://github.com/markmandel))
+- Integration tests reusable components [\#61](https://github.com/googleforgames/quilkin/pull/61) ([markmandel](https://github.com/markmandel))
+- Unit test for endpoint send & local receive filter [\#60](https://github.com/googleforgames/quilkin/pull/60) ([markmandel](https://github.com/markmandel))
+- Remove redundant async and fix comment typos [\#54](https://github.com/googleforgames/quilkin/pull/54) ([iffyio](https://github.com/iffyio))
+- Move TestFilters into test\_utils [\#52](https://github.com/googleforgames/quilkin/pull/52) ([markmandel](https://github.com/markmandel))
+- Refactor UDP Test Utils to be more flexible [\#50](https://github.com/googleforgames/quilkin/pull/50) ([markmandel](https://github.com/markmandel))
+- Remove `async` from some Server functions [\#49](https://github.com/googleforgames/quilkin/pull/49) ([markmandel](https://github.com/markmandel))
+- Update Readme Roadmap [\#48](https://github.com/googleforgames/quilkin/pull/48) ([markmandel](https://github.com/markmandel))
+- Refactor Config.get\_endpoints\(\) [\#46](https://github.com/googleforgames/quilkin/pull/46) ([markmandel](https://github.com/markmandel))
+- Cleanup Server \> run - run\_prune\_sessions [\#42](https://github.com/googleforgames/quilkin/pull/42) ([markmandel](https://github.com/markmandel))
+- Server tests, drop 'server\_ prefix. [\#41](https://github.com/googleforgames/quilkin/pull/41) ([markmandel](https://github.com/markmandel))
+- Cleanup Server \> run - run\_receive\_packet [\#40](https://github.com/googleforgames/quilkin/pull/40) ([markmandel](https://github.com/markmandel))
+- Cleanup consistency with channel import [\#39](https://github.com/googleforgames/quilkin/pull/39) ([markmandel](https://github.com/markmandel))
+- Upgrade CI to Rust 1.42.0 [\#34](https://github.com/googleforgames/quilkin/pull/34) ([markmandel](https://github.com/markmandel))
+- Use Plain Terminal Logging for test output [\#32](https://github.com/googleforgames/quilkin/pull/32) ([markmandel](https://github.com/markmandel))
+- Refactor Session and Server into separate modules [\#29](https://github.com/googleforgames/quilkin/pull/29) ([markmandel](https://github.com/markmandel))
+- Cloud Build CI implementation [\#28](https://github.com/googleforgames/quilkin/pull/28) ([markmandel](https://github.com/markmandel))
+- Upgrade dependencies. [\#25](https://github.com/googleforgames/quilkin/pull/25) ([markmandel](https://github.com/markmandel))
+- Tests for Server::run [\#24](https://github.com/googleforgames/quilkin/pull/24) ([markmandel](https://github.com/markmandel))
+- Rename sender/receiver to client/server [\#23](https://github.com/googleforgames/quilkin/pull/23) ([markmandel](https://github.com/markmandel))
+- Tests for Session::new [\#21](https://github.com/googleforgames/quilkin/pull/21) ([markmandel](https://github.com/markmandel))
+- Test for Server::process\_receive\_packet\_channel [\#20](https://github.com/googleforgames/quilkin/pull/20) ([markmandel](https://github.com/markmandel))
+- Test for Server::process\_receive\_socket [\#18](https://github.com/googleforgames/quilkin/pull/18) ([markmandel](https://github.com/markmandel))
+- Test for Server::ensure\_session [\#17](https://github.com/googleforgames/quilkin/pull/17) ([markmandel](https://github.com/markmandel))
+- Test for Session::send\_to [\#16](https://github.com/googleforgames/quilkin/pull/16) ([markmandel](https://github.com/markmandel))
+
+
+
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*
diff --git a/Cargo.toml b/Cargo.toml
index 836da0d841..581d85e109 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -19,7 +19,7 @@ members = [".", "./macros"]
 
 [package]
 name = "quilkin"
-version = "0.1.0-dev"
+version = "0.1.0"
 authors = ["Mark Mandel <markmandel@google.com>", "Ifeanyi Ubah <ifeanyi.ubah@embark-studios.com>"]
 license-file = "LICENSE"
 description = "Quilkin is a non-transparent UDP proxy specifically designed for use with large scale multiplayer dedicated game server deployments, to ensure security, access control, telemetry data, metrics and more."
@@ -33,7 +33,7 @@ exclude = ["docs", "build", "examples", "image"]
 
 [dependencies]
 # Local
-quilkin-macros = { version = "0.1.0-dev", path = "./macros" }
+quilkin-macros = { version = "0.1.0", path = "./macros" }
 
 # Crates.io
 backoff = "0.3"
diff --git a/build/templates/release-issue.md b/build/templates/release-issue.md
index ab48dbc178..fe49211f4a 100644
--- a/build/templates/release-issue.md
+++ b/build/templates/release-issue.md
@@ -3,6 +3,7 @@
 ## Prerequisites
 
 - [ ] Have at least `Editor` level access to `quilkin` Google Cloud project.
+- [ ] Local gcloud configuration is pointing at the `quilkin` Google Cloud project. 
 - [ ] Local git remote `upstream` points at `git@github.com:googleforgames/quilkin.git`.
 
 ## Steps
@@ -18,14 +19,13 @@
 - [ ] cd to `./build/release` and run `make` to submit the cloud build
 - [ ] Download all the artifacts from the cloud build.
 - [ ] Move the CHANGELOG.md to the root of this repository, replacing any previous versions.
-- [ ] Review `license.html` to ensure that there aren't any new MPL, GPL, LGPL, or CDDL dependencies from the last 
+- [ ] Review `license.html` to ensure that there aren't any new MPL, or CDDL dependencies from the last 
   release. If there are:
-    - [ ] Add the dependencies to
-    [archive_dependencies.sh](https://github.com/googleforgames/quilkin/blob/main/build/release/archive_dependencies.sh) 
-    so that the source is archived in the container image.
+    - [ ] Add the dependencies to [archive_dependencies.sh](https://github.com/googleforgames/quilkin/blob/main/build/release/archive_dependencies.sh)
+          so that the source is archived in the container image.
     - [ ] Reset checklist back to "run `make` to submit the cloud build", and start from there again.
-- [ ] Run `cd macros && cargo publish --dry-run` and ensure there are no issues.
-- [ ] Run `cargo publish --dry-run` and ensure there are no issues.  
+- [ ] Run `cd macros && cargo publish --dry-run --allow-dirty` and ensure there are no issues.
+- [ ] Run `cargo publish --dry-run --allow-dirty` and ensure there are no issues.  
 - [ ] Submit these changes as a PR, and merge with approval.
 - [ ] Create a [Github release](https://github.com/googleforgames/quilkin/releases/new) using the 
   [Github release template](./github-release.md).
diff --git a/macros/Cargo.toml b/macros/Cargo.toml
index ff79b78d6a..66a5b7bf03 100644
--- a/macros/Cargo.toml
+++ b/macros/Cargo.toml
@@ -16,7 +16,7 @@
 
 [package]
 name = "quilkin-macros"
-version = "0.1.0-dev"
+version = "0.1.0"
 authors = ["Erin Power <erin.power@embark-studios.com>"]
 license-file = "../LICENSE"
 description = "Quilkin is a non-transparent UDP proxy specifically designed for use with large scale multiplayer dedicated game server deployments, to ensure security, access control, telemetry data, metrics and more."
diff --git a/macros/README.md b/macros/README.md
new file mode 100644
index 0000000000..cefa90affe
--- /dev/null
+++ b/macros/README.md
@@ -0,0 +1,7 @@
+# Quilkin Macros
+
+Macros for https://github.com/googleforgames/quilkin.
+
+## Licence
+
+Apache 2.0