[APIE-1087] AssociatedNameStrategy support for the Odyssey initiative - CLI by cqin-confluent · Pull Request #3373 · confluentinc/cli

Cynthia Qin (cqin-confluent) · 2026-05-29T13:05:19Z

Release Notes

Breaking Changes

PLACEHOLDER

New Features

Update confluent kafka topic produce and confluent kafka topic consume to resolve the Schema Registry subject via topic-to-subject associations when present(AssociatedNameStrategy), and otherwise fall back to the existing TopicNameStrategy (<topic>-key / <topic>-value).

Bug Fixes

PLACEHOLDER

Checklist

What

Applies to Confluent Cloud only.

For the Odyssey initiative, Schema Registry now supports explicit topic-to-subject associations, which decouple the SR subject from the topic name. Previously confluent kafka topic produce / consume hard-coded TopicNameStrategy and the subject was always assumed to be <topic>-key / <topic>-value.

This PR makes produce/consume resolve the subject using a lookup-then-fallback strategy:

Query the SR associations API by (kafkaClusterId, topic, mode).
If an association exists, use its subject.
Otherwise, fall back to TopicNameStrategy (the existing behavior).

Blast Radius

The new behavior adds an SR associations lookup to the produce/consume path on cloud. This change is designed to be backward compatible.

On-prem: unchanged. The path explicitly uses TopicNameStrategy and makes no associations call.
Cloud, no association: falls back to TopicNameStrategy, i.e. identical subject to today. The SR /associations endpoint is available in all regions and returns an empty result when no association exists, so the fallback is graceful.
Cloud, association exists: the subject resolves to the associated subject (the new behavior).

Existing and fall-back behavior has been manually tested and verified end-to-end (see Test & Review). However, if something goes wrong, Confluent Cloud customers who are using confluent kafka topic [consume | produce] may be blocked.

References

JIRA APIE-1087
INIT-11067 CLI/Terraform Workstream - Odyssey Explicit Topic Subject Association

Test & Review

Existing unit tests

❯ go test -count=1 ./pkg/serdes/... ./internal/kafka/...
... 
ok      github.com/confluentinc/cli/v4/pkg/serdes       3.060s
ok      github.com/confluentinc/cli/v4/internal/kafka   1.214s

New unit tests cover the helper and the SerDes wiring (associated subject vs. fallback)

❯ go test -count=1 -run 'TestResolveSubject|TestResolveProduceSubject|TestResolveAssociatedValueSubject|TestNewSchemaRegistryClient|TestConsumeMessage_ValueSubjectFallback|TestSubjectStrategy|TestPrimitiveSerdesInit|TestAvroSerdesUsesAssociatedSubject|TestJsonSerdesUsesAssociatedSubject|TestProtobufSerdesUsesAssociatedSubject' ./pkg/serdes/... ./internal/kafka/... -v
...
    --- PASS: TestResolveSubject/matching_association_returns_its_subject (0.00s)
    --- PASS: TestResolveSubject/association_for_other_mode_falls_back (0.00s)
    --- PASS: TestResolveSubject/association_under_different_cluster_id_falls_back (0.00s)
    --- PASS: TestResolveSubject/association_lookup_error_falls_back_to_TopicNameStrategy (0.00s)
PASS
ok      github.com/confluentinc/cli/v4/internal/kafka   1.090s

Manual tests (verified in DEVEL environment in Odyssey Testing org 722ddd57-b561-445c-88de-1a130e3783b8)
0-sanity-test.log
1-association-test-avro.log
2-association-lifecycle-test.log
3-association-test-protobuf.log
4-association-test-json.log
5-association-test-w-schema-flag.log
6-association-test-delete-key.log
7-association-test-schema-header.log
8-association-test-invalid-schema.log

confluent-cla-assistant · 2026-05-29T13:05:34Z

🎉 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 aims to add AssociatedNameStrategy support to the CLI’s Schema Registry serde flows by propagating a Kafka cluster ID into serializer/deserializer initialization and (for produce) resolving the SR subject via the associations API.

Changes:

Extend serde provider interfaces to accept kafkaClusterId and thread it through produce/consume paths.
Configure JSON/Protobuf serializers & deserializers to use serde.AssociatedNameStrategyType when a Kafka cluster ID is available.
Add helpers to create an SR client and resolve a subject via SR associations (with fallback).

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
pkg/serdes/serdes.go	Updates provider interfaces; adds SR client helper and subject resolution via associations.
pkg/serdes/protobuf_serialization_provider.go	Enables AssociatedNameStrategy for Protobuf serialization when Kafka cluster ID is provided.
pkg/serdes/protobuf_deserialization_provider.go	Enables AssociatedNameStrategy for Protobuf deserialization when Kafka cluster ID is provided.
pkg/serdes/json_serialization_provider.go	Enables AssociatedNameStrategy for JSON Schema serialization when Kafka cluster ID is provided.
pkg/serdes/json_deserialization_provider.go	Enables AssociatedNameStrategy for JSON Schema deserialization when Kafka cluster ID is provided.
pkg/serdes/integer_serialization_provider.go	Adjusts `InitSerializer` signature to match updated interface.
pkg/serdes/integer_deserialization_provider.go	Adjusts `InitDeserializer` signature to match updated interface.
pkg/serdes/double_serialization_provider.go	Adjusts `InitSerializer` signature to match updated interface.
pkg/serdes/double_deserialization_provider.go	Adjusts `InitDeserializer` signature to match updated interface.
internal/kafka/confluent_kafka.go	Threads Kafka cluster ID into deserializer initialization during consume.
internal/kafka/command_topic_produce.go	Passes Kafka cluster ID to serializers and resolves subject via associations for registration/lookup.
internal/kafka/command_topic_consume.go	Captures Kafka cluster ID in the consume handler for downstream deserializer initialization.
internal/asyncapi/command_export.go	Updates deserializer init callsite for the new signature (passes empty Kafka cluster ID).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

 type SerializationProvider interface {
-	InitSerializer(srClientUrl, srClusterId, mode string, schemaId int, srAuth SchemaRegistryAuth) error
+	InitSerializer(srClientUrl, srClusterId, kafkaClusterId, mode string, schemaId int, srAuth SchemaRegistryAuth) error
 	LoadSchema(string, map[string]string) error


 type DeserializationProvider interface {
-	InitDeserializer(srClientUrl, srClusterId, mode string, srAuth SchemaRegistryAuth, existingClient schemaregistry.Client) error
+	InitDeserializer(srClientUrl, srClusterId, kafkaClusterId, mode string, srAuth SchemaRegistryAuth, existingClient schemaregistry.Client) error
 	LoadSchema(string, string, serde.Type, *kafka.Message) error


+// returns the SR subject for (topic, mode) by querying the associations API with the Kafka cluster id
+// as resource namespace. Falls backt o default TopicNameStrategy (<topic>-<mode>) if unmatched.
+func ResolveSubject(client schemaregistry.Client, kafkaClusterId, topic, mode string) string {


+	associations, err := client.GetAssociationsByResourceName(topic, kafkaClusterId, "topic", []string{mode}, "", 0, -1)
+	if err != nil || len(associations) == 0 {
+		return fallback


+	// Resolve subject via SR associations, fall back to TopicNameStrategy on miss.
+	subject := topicNameStrategy(topic, mode)
+	if kafkaClusterId != "" && srEndpoint != "" {
+		if client, err := serdes.NewSchemaRegistryClient(srEndpoint, srClusterId, srAuth); err == nil {
+			subject = serdes.ResolveSubject(client, kafkaClusterId, topic, mode)
+		}


 type DeserializationProvider interface {
-	InitDeserializer(srClientUrl, srClusterId, mode string, srAuth SchemaRegistryAuth, existingClient schemaregistry.Client) error
+	InitDeserializer(srClientUrl, srClusterId, kafkaClusterId, mode string, srAuth SchemaRegistryAuth, existingClient schemaregistry.Client) error
 	LoadSchema(string, string, serde.Type, *kafka.Message) error


+// returns the SR subject for (topic, mode) by querying the associations API with the Kafka cluster id
+// as resource namespace. Falls backt o default TopicNameStrategy (<topic>-<mode>) if unmatched.
+func ResolveSubject(client schemaregistry.Client, kafkaClusterId, topic, mode string) string {


+	associations, err := client.GetAssociationsByResourceName(topic, kafkaClusterId, "topic", []string{mode}, "", 0, -1)
+	if err != nil || len(associations) == 0 {
+		return fallback


+	// Resolve subject via SR associations, fall back to TopicNameStrategy on miss.
+	subject := topicNameStrategy(topic, mode)
+	if kafkaClusterId != "" && srEndpoint != "" {
+		if client, err := serdes.NewSchemaRegistryClient(srEndpoint, srClusterId, srAuth); err == nil {
+			subject = serdes.ResolveSubject(client, kafkaClusterId, topic, mode)
+		}


+func ResolveSubject(client schemaregistry.Client, kafkaClusterId, topic, mode string) string {
+	fallback := topic + "-" + mode
+	if kafkaClusterId == "" || client == nil {
+		return fallback
+	}
+	associations, err := client.GetAssociationsByResourceName(topic, kafkaClusterId, "topic", []string{mode}, "", 0, -1)
+	if err != nil || len(associations) == 0 {


sonarqube-confluent · 2026-05-30T00:29:43Z

Quality Gate failed

Failed conditions
50.0% Coverage on New Code (required ≥ 80%)

See analysis details on SonarQube

…ey-cli

sonarqube-confluent · 2026-06-17T00:08:48Z

Quality Gate failed

Failed conditions
62.5% Coverage on New Code (required ≥ 80%)

See analysis details on SonarQube

sonarqube-confluent · 2026-06-26T01:12:51Z

Quality Gate passed

Issues
4 New issues
2 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
83.8% Coverage on New Code
1.0% Duplication on New Code

See analysis details on SonarQube

Cynthia Qin (cqin-confluent) added 3 commits May 29, 2026 00:24

Update produce and consume w/ association support

884641f

Update InitDeserializer

7844204

Add NewSchemaRegistryClient and more associate logic

a17aa87

Cynthia Qin (cqin-confluent) requested a review from a team as a code owner May 29, 2026 13:05

Copilot AI review requested due to automatic review settings May 29, 2026 13:05

Copilot started reviewing on behalf of Cynthia Qin (cqin-confluent) May 29, 2026 13:05 View session

Copilot AI reviewed May 29, 2026

View reviewed changes

Cynthia Qin (cqin-confluent) added 5 commits May 29, 2026 10:27

More initDeserializer and initSerializer

e9011c8

Update avro

7a72450

Refactor to use helper instead

356c25b

Clean up serdes and more SR client to internal/kafka

3b49e15

Add debug logs

b187cb3

Cynthia Qin (cqin-confluent) changed the title ~~AssociatedNameStrategy support for the Odyssey initiative - CLI~~ [APIE-1087] AssociatedNameStrategy support for the Odyssey initiative - CLI Jun 1, 2026

Cynthia Qin (cqin-confluent) added 3 commits June 11, 2026 15:07

Merge branch 'main' of https://github.com/confluentinc/cli into odyss…

7150452

…ey-cli

Add unit tests for AssociatedNameStrategy

37a64c7

Add unit tests for JSON and Protobuf

7767ace

Cynthia Qin (cqin-confluent) added 2 commits June 25, 2026 12:58

Fix protobuf consume for associations

266035a

Refactor and add more tests

e6eaf47

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[APIE-1087] AssociatedNameStrategy support for the Odyssey initiative - CLI#3373

[APIE-1087] AssociatedNameStrategy support for the Odyssey initiative - CLI#3373
Cynthia Qin (cqin-confluent) wants to merge 13 commits into
mainfrom
odyssey-cli

Cynthia Qin (cqin-confluent) commented May 29, 2026 •

edited

Loading

Uh oh!

confluent-cla-assistant Bot commented May 29, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

sonarqube-confluent Bot commented May 30, 2026

Uh oh!

sonarqube-confluent Bot commented Jun 17, 2026

Uh oh!

sonarqube-confluent Bot commented Jun 26, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

Cynthia Qin (cqin-confluent) commented May 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Release Notes

Checklist

What

Blast Radius

References

Test & Review

Uh oh!

confluent-cla-assistant Bot commented May 29, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

sonarqube-confluent Bot commented May 30, 2026

Quality Gate failed

Uh oh!

sonarqube-confluent Bot commented Jun 17, 2026

Quality Gate failed

Uh oh!

sonarqube-confluent Bot commented Jun 26, 2026

Quality Gate passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Cynthia Qin (cqin-confluent) commented May 29, 2026 •

edited

Loading