Add a note explaining the scenario in which an outage can happen

lsst-sqre · Aug 14, 2024 · e43282e · e43282e
1 parent b59a0cf
commit e43282e
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/developer-guide/strimzi-updates.rst b/docs/developer-guide/strimzi-updates.rst
@@ -32,6 +32,12 @@ Upgrading the Kafka brokers and client applications in Sasquatch (Kafka Connect
 
 Note that you do not explicitly set the Kafka ``metadataVersion`` in Sasquatch; instead, Strimzi automatically updates it to the current default after you update the Kafka version.
 
+.. note::
+
+    When upgrading Kafka from an unsupported version to a supported version, an outage will occur during the upgrade of the second broker.
+    This happens because, while the first broker will be running the new version supported by the operator, the third broker will still be on an unsupported version.
+    Since Sasquatch requires a minimum of two in-sync replicas for each Kafka topic, this mismatch causes the outage.
+
 Refer to the `Strimzi documentation`_ for more details.
 
 .. _latest version of the operator: https://strimzi.io/downloads/