Added migration guide for KIP-848 #2090

pranavrth · 2025-10-07T13:20:48Z

What

KIP-848 Migration Guide

Test & Review

Review rendered content here

confluent-cla-assistant · 2025-10-07T13:20:59Z

🎉 All Contributor License Agreements have been signed. Ready to merge.
_{Please push an empty commit if you would like to re-run the checks to verify CLA status for all contributors.}

Copilot

Pull Request Overview

This PR adds a comprehensive migration guide for KIP-848, the next generation consumer group rebalance protocol, to the CHANGELOG.md file. The guide provides detailed documentation for migrating from the classic consumer protocol to the new KIP-848 protocol.

Key changes:

Added extensive KIP-848 migration documentation with configuration changes, API differences, and code examples
Updated the v2.12.0b1 release notes to highlight KIP-848 general availability
Reorganized AsyncIO Producer documentation into a collapsible details section

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

Copilot · 2025-10-07T13:21:57Z

CHANGELOG.md

 ## v2.12.0b1 - 2025-10-01

-### Added
+ - **General Availability for Next Generation Consumer Group Protocol (KIP-848)**: 


Extra space at the end of line 5 should be removed.

Suggested change

- **General Availability for Next Generation Consumer Group Protocol (KIP-848)**:

- **General Availability for Next Generation Consumer Group Protocol (KIP-848)**:

Copilot · 2025-10-07T13:21:57Z

CHANGELOG.md

+ - **General Availability for Next Generation Consumer Group Protocol (KIP-848)**: 
+Starting with __confluent-kafka-python 2.12.0__, the next generation consumer group rebalance protocol defined in **[KIP-848](https://cwiki.apache.org/confluence/display/KAFKA/KIP-848%3A+The+Next+Generation+of+the+Consumer+Rebalance+Protocol)** is **production-ready**  (GA release).
+ - **AsyncIO Producer (experimental):** Introduces beta class `AIOProducer` for
+  asynchronous message production in asyncio applications.


Inconsistent indentation on line 8. The line should start with one space to match the bullet point indentation pattern used elsewhere in the document.

Suggested change

asynchronous message production in asyncio applications.

asynchronous message production in asyncio applications.

Copilot · 2025-10-07T13:21:58Z

CHANGELOG.md

+
+- **Enablement (client-side):**
+  - `group.protocol=consumer`
+  - `group.remote.assignor=<assignor>` (optional; broker-controlled if `NULL`; default broker assignor is **`uniform`**)


The term 'NULL' should be clarified or replaced with a more user-friendly term like 'unset' or 'not specified', as NULL may be confusing in the context of configuration properties.

Suggested change

- `group.remote.assignor=<assignor>` (optional; broker-controlled if `NULL`; default broker assignor is **`uniform`**)

- `group.remote.assignor=<assignor>` (optional; broker-controlled if unset; default broker assignor is **`uniform`**)

Copilot · 2025-10-07T13:21:58Z

CHANGELOG.md

+# Optional: select a remote assignor
+# Valid options currently: 'uniform' or 'range'
+#   group.remote.assignor=<uniform,range>
+# If unset(NULL), broker chooses the assignor (default: 'uniform')


Inconsistent terminology: 'unset(NULL)' should match the terminology used elsewhere in the document. Consider using 'unset' consistently instead of mixing 'NULL' and 'unset'.

Suggested change

# If unset(NULL), broker chooses the assignor (default: 'uniform')

# If unset, broker chooses the assignor (default: 'uniform')

emasab · 2025-10-08T15:46:54Z

CHANGELOG.md

 # Confluent Python Client for Apache Kafka - CHANGELOG

-## Unreleased
+## v2.12.0 - 2025-10-01


Suggested change

## v2.12.0 - 2025-10-01

## v2.12.0 - 2025-10-09

emasab · 2025-10-08T15:54:02Z

docs/kip-848-migration-guide.md

please add a target to the makefile to update this file with pandoc from the .rst

emasab · 2025-10-08T16:10:12Z

CHANGELOG.md


-## v2.12.0b1 - 2025-10-01
+### [KIP-848](https://cwiki.apache.org/confluence/display/KAFKA/KIP-848%3A+The+Next+Generation+of+the+Consumer+Rebalance+Protocol) – General Availability
+Starting with __confluent-kafka-python 2.12.0__, the next generation consumer group rebalance protocol defined in **[KIP-848](https://cwiki.apache.org/confluence/display/KAFKA/KIP-848%3A+The+Next+Generation+of+the+Consumer+Rebalance+Protocol)** is **production-ready**. Please refer the following [migration guide](docs/kip-848-migration-guide.md) for moving from `classic` to `consumer` protocol.


Suggested change

Starting with __confluent-kafka-python 2.12.0__, the next generation consumer group rebalance protocol defined in **[KIP-848](https://cwiki.apache.org/confluence/display/KAFKA/KIP-848%3A+The+Next+Generation+of+the+Consumer+Rebalance+Protocol)** is **production-ready**. Please refer the following [migration guide](docs/kip-848-migration-guide.md) for moving from `classic` to `consumer` protocol.

Starting with __confluent-kafka-python 2.12.0__, the next generation consumer group rebalance protocol defined in **[KIP-848](https://cwiki.apache.org/confluence/display/KAFKA/KIP-848%3A+The+Next+Generation+of+the+Consumer+Rebalance+Protocol)** is **production-ready**. Please refer to the following [migration guide](docs/kip-848-migration-guide.md) for moving from `classic` to `consumer` protocol.

emasab · 2025-10-09T09:14:52Z

docs/kip-848-migration-guide.md


-1.  Upgrade to **confluent-kafka-python ≥ 2.12.0** (GA release)
-2.  Run against **Kafka brokers ≥ 4.0.0**
+1.  Upgrade to **confluent-kafka-python ≥ v2.12.0** (GA release)


nit: actually the version in semver is 2.12.0 : v2.12.0 is the tag name and we can use it when referring to the tag

emasab

LGTM

sonarqube-confluent · 2025-10-09T15:20:46Z

Analysis Details

0 Issues

0 Bugs
0 Vulnerabilities
0 Code Smells

Coverage and Duplications

No coverage information (66.90% Estimated after merge)
No duplication information (4.90% Estimated after merge)

Project ID: confluent-kafka-python

View in SonarQube

Copilot AI review requested due to automatic review settings October 7, 2025 13:20

pranavrth requested review from a team and MSeal as code owners October 7, 2025 13:20

Copilot AI reviewed Oct 7, 2025

View reviewed changes

airlock-confluentinc bot force-pushed the dev_kip-848_migration-guide branch 2 times, most recently from c59dce8 to 84fc90d Compare October 8, 2025 11:43

This comment has been minimized.

Sign in to view

emasab requested changes Oct 8, 2025

View reviewed changes

emasab reviewed Oct 8, 2025

View reviewed changes

airlock-confluentinc bot force-pushed the dev_kip-848_migration-guide branch from 172ad84 to c0e823e Compare October 8, 2025 18:24

This comment has been minimized.

Sign in to view

emasab reviewed Oct 9, 2025

View reviewed changes

Added migration guide for KIP-848

320db0a

airlock-confluentinc bot force-pushed the dev_kip-848_migration-guide branch from c0e823e to 320db0a Compare October 9, 2025 14:15

This comment has been minimized.

Sign in to view

emasab approved these changes Oct 9, 2025

View reviewed changes

pranavrth merged commit ddeafbe into master Oct 9, 2025
3 checks passed

pranavrth deleted the dev_kip-848_migration-guide branch October 9, 2025 17:33

	- General Availability for Next Generation Consumer Group Protocol (KIP-848):
	- General Availability for Next Generation Consumer Group Protocol (KIP-848):

	asynchronous message production in asyncio applications.
	asynchronous message production in asyncio applications.

	- `group.remote.assignor=<assignor>` (optional; broker-controlled if `NULL`; default broker assignor is `uniform`)
	- `group.remote.assignor=<assignor>` (optional; broker-controlled if unset; default broker assignor is `uniform`)

	# If unset(NULL), broker chooses the assignor (default: 'uniform')
	# If unset, broker chooses the assignor (default: 'uniform')

Added migration guide for KIP-848 #2090

Added migration guide for KIP-848 #2090

Conversation

pranavrth commented Oct 7, 2025

What

Test & Review

Uh oh!

confluent-cla-assistant bot commented Oct 7, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Copilot AI Oct 7, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 7, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 7, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 7, 2025

Choose a reason for hiding this comment

Uh oh!

This comment has been minimized.

emasab Oct 8, 2025

Choose a reason for hiding this comment

Uh oh!

emasab Oct 8, 2025

Choose a reason for hiding this comment

Uh oh!

emasab Oct 8, 2025

Choose a reason for hiding this comment

Uh oh!

This comment has been minimized.

emasab Oct 9, 2025

Choose a reason for hiding this comment

Uh oh!

This comment has been minimized.

emasab left a comment

Choose a reason for hiding this comment

Uh oh!

sonarqube-confluent bot commented Oct 9, 2025

Analysis Details

0 Issues

Coverage and Duplications

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants