summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJames E. Blair <jeblair@redhat.com>2020-05-27 07:04:38 -0700
committerJames E. Blair <jeblair@redhat.com>2020-05-27 07:36:27 -0700
commita9543b3ba8e311ddfe19d68d0e5156895968b6e7 (patch)
treef23c7129d703a8fb1b5b649853fb67c6a860e409
parentccfeb49fcc5c06416461d03bace1f239924059f5 (diff)
downloadzuul-a9543b3ba8e311ddfe19d68d0e5156895968b6e7.tar.gz
Add release note about the final 3.x release
Change-Id: I8e83d8c40893a395dedb6afcbec3dc86f8be0ac9
-rw-r--r--doc/source/howtos/zookeeper.rst2
-rw-r--r--doc/source/reference/drivers/sql.rst2
-rw-r--r--releasenotes/notes/last3x-8682ada4910fa750.yaml26
3 files changed, 30 insertions, 0 deletions
diff --git a/doc/source/howtos/zookeeper.rst b/doc/source/howtos/zookeeper.rst
index ef127a599..902645684 100644
--- a/doc/source/howtos/zookeeper.rst
+++ b/doc/source/howtos/zookeeper.rst
@@ -18,6 +18,8 @@ The following general configuration setting in
This instructs ZooKeeper to purge old snapshots every 6 hours. This
will avoid filling the disk.
+.. _zk-encrypted-connections:
+
Encrypted Connections
---------------------
diff --git a/doc/source/reference/drivers/sql.rst b/doc/source/reference/drivers/sql.rst
index 85ee05c72..c0c22a984 100644
--- a/doc/source/reference/drivers/sql.rst
+++ b/doc/source/reference/drivers/sql.rst
@@ -1,5 +1,7 @@
:title: SQL Driver
+.. _sql-driver:
+
SQL
===
diff --git a/releasenotes/notes/last3x-8682ada4910fa750.yaml b/releasenotes/notes/last3x-8682ada4910fa750.yaml
new file mode 100644
index 000000000..82a8fc668
--- /dev/null
+++ b/releasenotes/notes/last3x-8682ada4910fa750.yaml
@@ -0,0 +1,26 @@
+---
+prelude: |
+ This is expected to be the last 3.x release of Zuul (barring any
+ unanticpated bugfix releases).
+
+ The next release of Zuul, 4.0.0, will require the following
+ deployment changes:
+
+ * TLS ZooKeeper connections
+ * Network connectivity from all components to ZooKeeper
+ * A SQL database
+
+ These features are supported now, so it is important that you take
+ this time to :ref:`switch your ZooKeeper connection to use
+ TLS<zk-encrypted-connections>`, and :ref:`configure a SQL
+ connection<sql-driver>`. Even though only some Zuul components
+ connect to ZooKeeper today, you should ensure that the
+ ``[zookeeper]`` section is present in ``zuul.conf`` for all
+ components, and that they have network connectivity to the ZooKeeper
+ servers. Doing so will make the upgrade to 4.0.0 seamless.
+
+ These changes are in support of ongoing work to enable multiple
+ scheduler processes for scaling and availability. After the 4.0.0
+ release, it is anticipated that further upgrades to Zuul made in
+ support of this work will be done with minimal disruption in the
+ course of normal releases.