Hi David, In the original scheme of KIP-1011, we were going to maintain a deprecation period before 4.X, which means we won’t fail directly before 4.X, this is consistent with what we have done in KIP-894, currently the PR is not landed onto release-3.9, so there would be no deprecation period if we fail directly on a `UnsupportedVersionException`, even though the likelihood of it is low, it’s still worth considering it.
Luke also think the deprecation period is necessary giving that 4.0 will not remove `alterConfigs`, so I’m willing to maintain compatibility to the next period, for example 4.2, I will try to drive this smooth upgrade process. How do you think about it? Best, Ziming > On Nov 14, 2024, at 16:41, David Jacot <dja...@confluent.io.INVALID> wrote: > > Hi Ziming, > > I am not sure to understand the concern. What's wrong with keeping the > original plan? If I understood it correctly, the plan was to fail > directly if the incrementalAlterConfigs API is not available in 4.x > versions. The new API was introduced in AK 2.3. The likelihood of using the > updated tool with such an old cluster is pretty low in my opinion. > > alterConfigs was deprecated in AK 2.3. It would be great if we could > finally remove it. > > Best, > DJ > > On Thu, Nov 14, 2024 at 7:46 AM Luke Chen <show...@gmail.com > <mailto:show...@gmail.com>> wrote: > >> Hi Ziming, >> >> We should go through the depreciation period before removing/failing it. >> I remember the `alterConfigs` will still exist in v4.0.0, right? If so, I >> think we should go with option (1). >> >> Thanks. >> Luke >> >> On Thu, Nov 14, 2024 at 2:38 PM ziming deng <dengziming1...@gmail.com> >> wrote: >> >>> Hi Kafka devs, I have initiated KIP-1011 in which we have concluded that >>> we will replace deprecated `alterConfigs` with `incrementalAlterConfigs` in >>> command line tool `CommandConfig`. In the design, if the server doesn’t >>> support `incrementalAlterConfigs`, we would fallback to `alterConfigs` >>> for pre-4.0 client and directly fail for a post-4.0 client. >>> >>> The KIP-1011 document link: >>> KIP-1011: Use incrementalAlterConfigs when updating broker configs by >>> kafka-configs.sh - Apache Kafka - Apache Software Foundation >>> <https://cwiki.apache.org/confluence/display/KAFKA/KIP-1011%3A+Use+incrementalAlterConfigs+when+updating+broker+configs+by+kafka-configs.sh> >>> cwiki.apache.org <http://cwiki.apache.org/> >>> <https://cwiki.apache.org/confluence/display/KAFKA/KIP-1011%3A+Use+incrementalAlterConfigs+when+updating+broker+configs+by+kafka-configs.sh> >>> [image: favicon.ico] >>> <https://cwiki.apache.org/confluence/display/KAFKA/KIP-1011%3A+Use+incrementalAlterConfigs+when+updating+broker+configs+by+kafka-configs.sh> >>> <https://cwiki.apache.org/confluence/display/KAFKA/KIP-1011%3A+Use+incrementalAlterConfigs+when+updating+broker+configs+by+kafka-configs.sh> >>> >>> >>> I implemented it here: >>> KAFKA-16181: Use incrementalAlterConfigs when updating broker configs by >>> kafka-configs.sh by dengziming · Pull Request #15304 · apache/kafka >>> <https://github.com/apache/kafka/pull/15304> >>> github.com <http://github.com/> <https://github.com/apache/kafka/pull/15304> >>> [image: apple-touch-icon-180x180-a80b8e11abe2.png] >>> <https://github.com/apache/kafka/pull/15304> >>> <https://github.com/apache/kafka/pull/15304> >>> >>> >>> And I’m sorry that I failed to push forward the PR timely due to my >>> personal reason, and now we are preparing releasing 4.0 in which >>> `alterConfigs` >>> is supposed to be removed, so what’s the best way to improvised this KIP, >>> here are 2 ideas: >>> 1. Postponing removing `alterConfigs` until the new major release. >>> 2. Directly remove `alterConfigs` and use `incrementalAlterConfigs` in ` >>> CommandConfig`. >>> >>> Do you have some ideas, I’m looking forward to your points. >>> >>> --- >>> Best, >>> Ziming