Skip to content

KIP-559: bump JoinGroup v7 / SyncGroup v5; verify protocol_type/name#2998

Merged
dpkp merged 1 commit into
masterfrom
shelley/kip-559-protocol-type-name
May 26, 2026
Merged

KIP-559: bump JoinGroup v7 / SyncGroup v5; verify protocol_type/name#2998
dpkp merged 1 commit into
masterfrom
shelley/kip-559-protocol-type-name

Conversation

@dpkp
Copy link
Copy Markdown
Owner

@dpkp dpkp commented May 26, 2026

KIP-559 makes the Kafka protocol friendlier with L7 proxies by ensuring
that JoinGroup and SyncGroup messages explicitly carry the group's
ProtocolType / ProtocolName, so each message can be parsed independently.

The wire schemas already covered the new fields (JoinGroup v7,
SyncGroup v5 — both via generated stubs). Apply the client-side bits:

  • coordinator/base: send JoinGroupRequest max_version=7,
    SyncGroupRequest max_version=5, populating protocol_type and
    protocol_name on the SyncGroupRequest.
  • coordinator/base: validate response.protocol_type on the
    JoinGroupResponse and both protocol_type and protocol_name on the
    SyncGroupResponse; raise InconsistentGroupProtocolError on mismatch
    (treated equivalently to a broker-reported INCONSISTENT_GROUP_PROTOCOL).
  • tests: cover join/sync protocol_type and sync protocol_name mismatches.

Co-authored-by: Shelley shelley@exe.dev

KIP-559 makes the Kafka protocol friendlier with L7 proxies by ensuring
that JoinGroup and SyncGroup messages explicitly carry the group's
ProtocolType / ProtocolName, so each message can be parsed independently.

The wire schemas already covered the new fields (JoinGroup v7,
SyncGroup v5 — both via generated stubs). Apply the client-side bits:

- coordinator/base: send JoinGroupRequest max_version=7,
  SyncGroupRequest max_version=5, populating protocol_type and
  protocol_name on the SyncGroupRequest.
- coordinator/base: validate response.protocol_type on the
  JoinGroupResponse and both protocol_type and protocol_name on the
  SyncGroupResponse; raise InconsistentGroupProtocolError on mismatch
  (treated equivalently to a broker-reported INCONSISTENT_GROUP_PROTOCOL).
- tests: cover join/sync protocol_type and sync protocol_name mismatches.

Co-authored-by: Shelley <shelley@exe.dev>
@dpkp dpkp merged commit 4041668 into master May 26, 2026
19 checks passed
@dpkp dpkp deleted the shelley/kip-559-protocol-type-name branch May 26, 2026 19:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant