# Kong 1.0 (rc3) available for testing

**URL:** <https://discuss.konghq.com/t/kong-1-0-rc3-available-for-testing/2316>\
**Category:** General\
**Tags:** service-mesh\
**Created:** [November 22, 2018, 3:04pm UTC](https://discuss.konghq.com/t/kong-1-0-rc3-available-for-testing/2316 "2018-11-22T15:04:43Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![bungle](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/bungle/32/13_2.png) [@bungle](https://discuss.konghq.com/u/bungle)\
**Post date:** [November 22, 2018, 3:04pm UTC](https://discuss.konghq.com/t/kong-1-0-rc3-available-for-testing/2316/1 "2018-11-22T15:04:43Z")

</div>

## Hello Everyone,

Continuing our release candidate cycle for Kong 1.0, we’re happy to announce the availability of RC3!

📦 [Download Kong 1.0.0rc3](https://bintray.com/kong) today and give us your feedback!

This third release candidate contains the first version of Service Mesh, and some fixes for problems detected while testing RC2. We’d like to thank everyone who reported issues - keep them coming!

### RC3 Contains the Following Improvements over RC2:

#### Service Mesh and Stream Routing:

- The Kong cluster creates a Certificate Authority shared by all Kong nodes,  
which they can use to establish mutual TLS authentication with other nodes in a service mesh
- New `stream_listen` directive in `kong.conf`, accepting IPs and hostnames, with the optional  
`proxy_protocol` and `transparent` 🆕 (for using iptables) suffixes
- Kong’s core router can now route raw TCP and TLS traffic
- Stream traffic routing is done in a new phase called `preread`
- Mutual TLS authentication happens in the new `preread` phase
- `protocol` property of Route and Service entities can now be `tcp` 🆕 and `tls` 🆕 in addition to `http` and `https`.
- Three new properties of Route entities are available for routing `tcp` and `tls` requests:  
`sources`, `destinations`, and `snis`

#### Other Changes in Core:

- The new `transparent` suffix also applies for `proxy_listen` directive in `kong.conf`
- Support for upgrading `0.14` nodes to `1.0.0rc3`
- Multiple improvements and fixes on the schema library
- The PDK has been extended to include Consumer, Service and Route handling variables
- Upgraded the `lua-cassandra` dependency and fixed issues
- Fixed an issue with the `kong quit` command timeouting with PostgreSQL
- Bumped the `luaossl` dependency
- Typos, style and grammar fixes (thanks [@saideepd](https://github.com/saideepd), [@gy741](https://github.com/gy741), [@arpitpandey0209](https://github.com/arpitpandey0209), [@joelvisroman](https://github.com/joealvisroman), [@vkmrishad](https://github.com/vkmrishad), [@mr-yamraj](https://github.com/mr-yamraj), [@geekysrm](https://github.com/geekysrm), [@Mehvix](https://github.com/Mehvix), [@vyaspranjal33](https://github.com/vyaspranjal33), [@iTechTR](https://github.com/iTechTR), [@shyamjalan](https://github.com/shyamjalan), and [@steffinstanly](https://github.com/@steffinstanly))

#### Changes in Plugins:

- Plugins can now execute code in the new `preread` phase

- All plugins have a new field, `run_on`, which will control their activation  
in service mesh and “regular API gateway” mode

- ACL: Fixed an error in the migrations which prevented upgrading

- Correlation-Id: Fixed an error when access phase did not execute

You can browse the complete list of changes for this release on [GitHub](https://github.com/Kong/kong/compare/1.0.0rc2...1.0.0rc3). Additionally, Kong 1.0rc3 contains all changes introduced by `1.0rc1` and `1.0rc2` listed [here](https://discuss.konghq.com/t/kong-1-0-rc2-available-for-download/2142).

### Upgrade Path from 0.14 ⬆

We have made sure that the following upgrade path from 0.14.x is supported, including “cold” nodes (Note: upgrading from a pre-0.14 cluster is **not** supported):

1. Download 1.0rc3, and configure it to point to the same datastore as your 0.14 cluster. Run `kong migrations up`.
2. Both 0.14 and 1.0rc3 nodes can now run simultaneously on the same datastore. Start provisioning 1.0rc3 nodes, but do not use their Admin API yet. Prefer making Admin API requests to your 0.14 nodes instead.
3. Gradually divert traffic away from your 0.14 nodes, and into your 1.0rc3 cluster. Monitor your traffic to make sure everything is going smoothly.
4. When your traffic is fully migrated to the 1.0rc3 cluster, decommission your 0.14 nodes.
5. From your 1.0rc3 cluster, run: `kong migrations finish`. From this point on, it will not be possible to start 0.14 nodes pointing to the same datastore anymore. Only run this command when you are confident that your migration was successful. From now on, you can safely make Admin API requests to your 1.0rc3 nodes.

### Install 1.0rc3 on a Fresh Datastore ⬇

1.0 introduces a new, improved migrations framework. The following commands can be run to prepare a new 1.0 cluster from a fresh datastore:

```auto
$ kong migrations bootstrap [-c config]
$ kong start [-c config]

```

### What’s Next 🚀

Our next release candidate, 1.0RC4, will add more features to Service Mesh. Stay tuned for more updates!

As always, feel free to reach out to us here or via [GitHub issues](https://github.com/Kong/kong/issues) if you have any questions or feedback about this upgrade path, or the contents of this release in general! We appreciate the feedback we receive from our release candidates testers and thank them in advance!

---

<div class="post-metadata">

**Author:** ![david-maumenee](https://avatars.discourse-cdn.com/v4/letter/d/e19adc/32.png) [@david-maumenee](https://discuss.konghq.com/u/david-maumenee)\
**Post date:** [November 23, 2018, 2:16pm UTC](https://discuss.konghq.com/t/kong-1-0-rc3-available-for-testing/2316/2 "2018-11-23T14:16:37Z")

</div>

Hi,

Have you planned to provided this rc3 on docker hub ? [https://hub.docker.com/\_/kong/](https://hub.docker.com/_/kong/)  
Currently the last version available is the rc2.

Thanks

---

<div class="post-metadata">

**Author:** ![bungle](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/bungle/32/13_2.png) [@bungle](https://discuss.konghq.com/u/bungle)\
**Post date:** [November 23, 2018, 3:21pm UTC](https://discuss.konghq.com/t/kong-1-0-rc3-available-for-testing/2316/3 "2018-11-23T15:21:11Z")

</div>

Yes. Our bad. We are working on it. Thanks for reminding us.

---

<div class="post-metadata">

**Author:** ![hutchic](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/hutchic/32/122_2.png) [@hutchic](https://discuss.konghq.com/u/hutchic)\
**Post date:** [November 23, 2018, 3:33pm UTC](https://discuss.konghq.com/t/kong-1-0-rc3-available-for-testing/2316/4 "2018-11-23T15:33:13Z")

</div>

Thanks for pointing that out. PR is open here to update the docker hub [https://github.com/docker-library/official-images/pull/5097](https://github.com/docker-library/official-images/pull/5097)

---

<div class="post-metadata">

**Author:** ![david-maumenee](https://avatars.discourse-cdn.com/v4/letter/d/e19adc/32.png) [@david-maumenee](https://discuss.konghq.com/u/david-maumenee)\
**Post date:** [November 23, 2018, 3:33pm UTC](https://discuss.konghq.com/t/kong-1-0-rc3-available-for-testing/2316/5 "2018-11-23T15:33:34Z")

</div>

Thanks,  
What’s the planned date of the 1.0 GA ?

---

<div class="post-metadata">

**Author:** ![mars](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/mars/32/491_2.png) [@mars](https://discuss.konghq.com/u/mars)\
**Post date:** [November 27, 2018, 7:15pm UTC](https://discuss.konghq.com/t/kong-1-0-rc3-available-for-testing/2316/6 "2018-11-27T19:15:05Z")

</div>

The third release candidate is now available in the Kong app for Heroku:

🥚 [Try Kong 1.0 rc3 on Heroku](https://github.com/heroku/heroku-kong/releases/tag/v7.0.0-rc3)
