Add --kafka-cluster flag to usm connect register - #3434

Open
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes
Open

Add --kafka-cluster flag to usm connect register#3434
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes

Conversation

@FlamedHunter

@FlamedHunterArman Garg (FlamedHunter) commented Aug 10, 2026

Copy link
Copy Markdown

Release Notes

Breaking Changes

  • NA

New Features

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.

Bug Fixes

  • NA

Checklist

  • I have successfully built and used a custom CLI binary, without linter issues from this PR.
  • I have clearly specified in the What section below whether this PR applies to Confluent Cloud, Confluent Platform, or both.
  • I have verified this PR in Confluent Cloud pre-prod or production environment, if applicable.
  • I have verified this PR in Confluent Platform on-premises environment, if applicable.
  • I have attached manual CLI verification results or screenshots in the Test & Review section below.
  • I have added appropriate CLI integration or unit tests for any new or updated commands and functionality.
  • I confirm that this PR introduces no breaking changes or backward compatibility issues.
  • I have indicated the potential customer impact if something goes wrong in the Blast Radius section below.
  • I have put checkmarks below confirming that the feature associated with this PR is enabled in:
    • Confluent Cloud prod
    • Confluent Cloud stag
    • Confluent Platform
    • Check this box if the feature is enabled for certain organizations only

What

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.
  • The two flags are mutually exclusive, and exactly one is required.
  • --confluent-platform-kafka-cluster's behavior and response shape are unchanged.
  • --kafka-cluster registrations print a new, simplified response (a single "Kafka Cluster" field) containing the value passed to the flag as-is. The CP-to-USM resolution lookup still runs internally but its result isn't surfaced in this response.
  • No backend/API contract change — both flags populate the same kafka_cluster_id field on the existing usm/v1/connect-clusters create request.

Blast Radius

  • Connect cluster registration for USM (Hybrid connect)

References

Test & Review

For cloud Kafka cluster (registered on USM as hybrid)

Existing behaviour

./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+--------------------------------+----------------------------------------+
| ID | usmcc-stgc30gb03wlh93wdqzslkjef43mnapp |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgceuimd7uloqul5uwkmlrbhb5blnfu |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+----------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+----------------------+----------------------------------------+
| ID | usmcc-stgc8aq12lv354p6uf0klhrzx2vwrzm6 |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | usmkc-stgcfpn5laljl8avz7te44hgdh06688 |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For cloud Kafka cluster

Existing behaviour

 ./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-10T22:01:17.679+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+--------------------------------+---------------------------------------+
| ID | usmcc-stgcgs8m3qmv6xm359enzrtm8p7gv77 |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+---------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-12T16:12:27.970+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+----------------------+----------------------------------------+
| ID | usmcc-stgc9jya08relxfv0k6ujlrmv6pnajgt |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For on-prem Kafka Cluster

Existing behaviour

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--confluent-platform-kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+--------------------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcx9ejliupphptsdbky9k4g5bgvaqy |
| Confluent Platform Connect | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Confluent Platform Kafka | JaH5VfLdRxi_CXfrA_jHxw |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+--------------------------------+------------------------------------------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+----------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcz0stkyddf3eqzex436ofpwtxmxje |
| Connect Cluster | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Kafka Cluster | JaH5VfLdRxi_CXfrA_jHxw |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+----------------------+------------------------------------------------------------------------+

CopilotAI lite review requested due to automatic review settings August 10, 2026 12:12
@confluent-cla-assistant

Copy link
Copy Markdown

🎉 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.

CopilotAI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds support for registering a USM Connect cluster using a new --kafka-cluster flag (in addition to the existing --confluent-platform-kafka-cluster), including updated help text and integration fixtures.

Changes:

  • Add --kafka-cluster flag to usm connect register, making the two Kafka cluster flags mutually exclusive and requiring one of them.
  • Introduce a “hybrid” output shape for the --kafka-cluster flow.
  • Update integration tests and golden outputs to reflect the new flag behavior and validation errors.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
FileDescription
internal/unified-stream-manager/command_connect_register.goAdds the new flag, updates examples, and adjusts flag validation/registration flow.
internal/unified-stream-manager/command_connect.goAdds a new output struct + printer used by the --kafka-cluster registration path.
test/usm_test.goExtends integration test coverage for new flag validation; currently includes commented-out success-path cases.
test/fixtures/output/unified-stream-manager/connect/register-help.goldenUpdates help output to include the new flag and example.
test/fixtures/output/unified-stream-manager/connect/create-fail-paired-flag-missing.goldenUpdates usage/help output shown on paired-flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.goldenAdds fixture for mutually-exclusive Kafka flag error.
test/fixtures/output/unified-stream-manager/connect/create-fail-missing-kafka-flag.goldenAdds fixture for “one required” Kafka flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-cp-kafka.goldenAdds fixture for the --kafka-cluster success-path output currently exercised by tests.
Suppressed comments (1)

internal/unified-stream-manager/command_connect_register.go:69

  • The --kafka-cluster path still flows through the on-prem→cloud Kafka ID mapping and the "not found" logging. For cloud IDs like "lkc-...", this will always miss the map, log a misleading error on success, and can even fail early if ListUsmKafkaClusters requires permissions (even though the mapping is irrelevant for --kafka-cluster).
	if cmd.Flags().Changed("kafka-cluster") {
kafkaClusterId, err = cmd.Flags().GetString("kafka-cluster")
if err != nil {
return err
}
}

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 33 to +34
cmd.Flags().String("confluent-platform-kafka-cluster", "", "The ID of the metadata Kafka cluster for the Connect Cluster.")
cmd.Flags().String("kafka-cluster", "", `The ID of the metadata Kafka cluster for the Connect Cluster.`)
Comment threadtest/usm_test.go
Comment on lines +43 to +46
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cloud-kafka.golden"},
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1 -o json", fixture: "unified-stream-manager/connect/create-cloud-kafka-json.golden"},
{args: "usm connect register connect-group-xyz123 --kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cp-kafka.golden"},
{args: "usm connect register connect-group-xyz123 --confluent-platform-kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.golden", exitCode: 1},
@sonarqube-confluent

Copy link
Copy Markdown

type connectHybridOut struct {
Id string `human:"ID" serialized:"id"`
ConnectCluster string `human:"Connect Cluster" serialized:"connect_cluster"`
USMKafkaClusterId string `human:"USM Kafka Cluster ID" serialized:"usm_kafka_cluster_id"`

@rishabhbits038Rishabh Sharma (rishabhbits038)Aug 13, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we check with the cli team is it is okay to remove this flag altogether?
or is the recommendation to deprecate this first?

Sign up for freeto 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.

3 participants

@FlamedHunter@rishabhbits038
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Add --kafka-cluster flag to usm connect register - #3434

Open
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes
Open

Add --kafka-cluster flag to usm connect register#3434
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes

Conversation

@FlamedHunter

@FlamedHunterArman Garg (FlamedHunter) commented Aug 10, 2026

Copy link
Copy Markdown

Release Notes

Breaking Changes

  • NA

New Features

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.

Bug Fixes

  • NA

Checklist

  • I have successfully built and used a custom CLI binary, without linter issues from this PR.
  • I have clearly specified in the What section below whether this PR applies to Confluent Cloud, Confluent Platform, or both.
  • I have verified this PR in Confluent Cloud pre-prod or production environment, if applicable.
  • I have verified this PR in Confluent Platform on-premises environment, if applicable.
  • I have attached manual CLI verification results or screenshots in the Test & Review section below.
  • I have added appropriate CLI integration or unit tests for any new or updated commands and functionality.
  • I confirm that this PR introduces no breaking changes or backward compatibility issues.
  • I have indicated the potential customer impact if something goes wrong in the Blast Radius section below.
  • I have put checkmarks below confirming that the feature associated with this PR is enabled in:
    • Confluent Cloud prod
    • Confluent Cloud stag
    • Confluent Platform
    • Check this box if the feature is enabled for certain organizations only

What

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.
  • The two flags are mutually exclusive, and exactly one is required.
  • --confluent-platform-kafka-cluster's behavior and response shape are unchanged.
  • --kafka-cluster registrations print a new, simplified response (a single "Kafka Cluster" field) containing the value passed to the flag as-is. The CP-to-USM resolution lookup still runs internally but its result isn't surfaced in this response.
  • No backend/API contract change — both flags populate the same kafka_cluster_id field on the existing usm/v1/connect-clusters create request.

Blast Radius

  • Connect cluster registration for USM (Hybrid connect)

References

Test & Review

For cloud Kafka cluster (registered on USM as hybrid)

Existing behaviour

./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+--------------------------------+----------------------------------------+
| ID | usmcc-stgc30gb03wlh93wdqzslkjef43mnapp |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgceuimd7uloqul5uwkmlrbhb5blnfu |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+----------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+----------------------+----------------------------------------+
| ID | usmcc-stgc8aq12lv354p6uf0klhrzx2vwrzm6 |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | usmkc-stgcfpn5laljl8avz7te44hgdh06688 |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For cloud Kafka cluster

Existing behaviour

 ./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-10T22:01:17.679+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+--------------------------------+---------------------------------------+
| ID | usmcc-stgcgs8m3qmv6xm359enzrtm8p7gv77 |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+---------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-12T16:12:27.970+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+----------------------+----------------------------------------+
| ID | usmcc-stgc9jya08relxfv0k6ujlrmv6pnajgt |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For on-prem Kafka Cluster

Existing behaviour

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--confluent-platform-kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+--------------------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcx9ejliupphptsdbky9k4g5bgvaqy |
| Confluent Platform Connect | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Confluent Platform Kafka | JaH5VfLdRxi_CXfrA_jHxw |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+--------------------------------+------------------------------------------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+----------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcz0stkyddf3eqzex436ofpwtxmxje |
| Connect Cluster | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Kafka Cluster | JaH5VfLdRxi_CXfrA_jHxw |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+----------------------+------------------------------------------------------------------------+

CopilotAI lite review requested due to automatic review settings August 10, 2026 12:12
@confluent-cla-assistant

Copy link
Copy Markdown

🎉 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.

CopilotAI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds support for registering a USM Connect cluster using a new --kafka-cluster flag (in addition to the existing --confluent-platform-kafka-cluster), including updated help text and integration fixtures.

Changes:

  • Add --kafka-cluster flag to usm connect register, making the two Kafka cluster flags mutually exclusive and requiring one of them.
  • Introduce a “hybrid” output shape for the --kafka-cluster flow.
  • Update integration tests and golden outputs to reflect the new flag behavior and validation errors.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
FileDescription
internal/unified-stream-manager/command_connect_register.goAdds the new flag, updates examples, and adjusts flag validation/registration flow.
internal/unified-stream-manager/command_connect.goAdds a new output struct + printer used by the --kafka-cluster registration path.
test/usm_test.goExtends integration test coverage for new flag validation; currently includes commented-out success-path cases.
test/fixtures/output/unified-stream-manager/connect/register-help.goldenUpdates help output to include the new flag and example.
test/fixtures/output/unified-stream-manager/connect/create-fail-paired-flag-missing.goldenUpdates usage/help output shown on paired-flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.goldenAdds fixture for mutually-exclusive Kafka flag error.
test/fixtures/output/unified-stream-manager/connect/create-fail-missing-kafka-flag.goldenAdds fixture for “one required” Kafka flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-cp-kafka.goldenAdds fixture for the --kafka-cluster success-path output currently exercised by tests.
Suppressed comments (1)

internal/unified-stream-manager/command_connect_register.go:69

  • The --kafka-cluster path still flows through the on-prem→cloud Kafka ID mapping and the "not found" logging. For cloud IDs like "lkc-...", this will always miss the map, log a misleading error on success, and can even fail early if ListUsmKafkaClusters requires permissions (even though the mapping is irrelevant for --kafka-cluster).
	if cmd.Flags().Changed("kafka-cluster") {
kafkaClusterId, err = cmd.Flags().GetString("kafka-cluster")
if err != nil {
return err
}
}

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 33 to +34
cmd.Flags().String("confluent-platform-kafka-cluster", "", "The ID of the metadata Kafka cluster for the Connect Cluster.")
cmd.Flags().String("kafka-cluster", "", `The ID of the metadata Kafka cluster for the Connect Cluster.`)
Comment threadtest/usm_test.go
Comment on lines +43 to +46
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cloud-kafka.golden"},
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1 -o json", fixture: "unified-stream-manager/connect/create-cloud-kafka-json.golden"},
{args: "usm connect register connect-group-xyz123 --kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cp-kafka.golden"},
{args: "usm connect register connect-group-xyz123 --confluent-platform-kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.golden", exitCode: 1},
@sonarqube-confluent

Copy link
Copy Markdown

type connectHybridOut struct {
Id string `human:"ID" serialized:"id"`
ConnectCluster string `human:"Connect Cluster" serialized:"connect_cluster"`
USMKafkaClusterId string `human:"USM Kafka Cluster ID" serialized:"usm_kafka_cluster_id"`

@rishabhbits038Rishabh Sharma (rishabhbits038)Aug 13, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we check with the cli team is it is okay to remove this flag altogether?
or is the recommendation to deprecate this first?

Sign up for freeto 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.

3 participants

@FlamedHunter@rishabhbits038
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add --kafka-cluster flag to usm connect register - #3434

Open
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes
Open

Add --kafka-cluster flag to usm connect register#3434
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes

Conversation

@FlamedHunter

@FlamedHunterArman Garg (FlamedHunter) commented Aug 10, 2026

Copy link
Copy Markdown

Release Notes

Breaking Changes

  • NA

New Features

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.

Bug Fixes

  • NA

Checklist

  • I have successfully built and used a custom CLI binary, without linter issues from this PR.
  • I have clearly specified in the What section below whether this PR applies to Confluent Cloud, Confluent Platform, or both.
  • I have verified this PR in Confluent Cloud pre-prod or production environment, if applicable.
  • I have verified this PR in Confluent Platform on-premises environment, if applicable.
  • I have attached manual CLI verification results or screenshots in the Test & Review section below.
  • I have added appropriate CLI integration or unit tests for any new or updated commands and functionality.
  • I confirm that this PR introduces no breaking changes or backward compatibility issues.
  • I have indicated the potential customer impact if something goes wrong in the Blast Radius section below.
  • I have put checkmarks below confirming that the feature associated with this PR is enabled in:
    • Confluent Cloud prod
    • Confluent Cloud stag
    • Confluent Platform
    • Check this box if the feature is enabled for certain organizations only

What

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.
  • The two flags are mutually exclusive, and exactly one is required.
  • --confluent-platform-kafka-cluster's behavior and response shape are unchanged.
  • --kafka-cluster registrations print a new, simplified response (a single "Kafka Cluster" field) containing the value passed to the flag as-is. The CP-to-USM resolution lookup still runs internally but its result isn't surfaced in this response.
  • No backend/API contract change — both flags populate the same kafka_cluster_id field on the existing usm/v1/connect-clusters create request.

Blast Radius

  • Connect cluster registration for USM (Hybrid connect)

References

Test & Review

For cloud Kafka cluster (registered on USM as hybrid)

Existing behaviour

./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+--------------------------------+----------------------------------------+
| ID | usmcc-stgc30gb03wlh93wdqzslkjef43mnapp |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgceuimd7uloqul5uwkmlrbhb5blnfu |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+----------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+----------------------+----------------------------------------+
| ID | usmcc-stgc8aq12lv354p6uf0klhrzx2vwrzm6 |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | usmkc-stgcfpn5laljl8avz7te44hgdh06688 |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For cloud Kafka cluster

Existing behaviour

 ./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-10T22:01:17.679+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+--------------------------------+---------------------------------------+
| ID | usmcc-stgcgs8m3qmv6xm359enzrtm8p7gv77 |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+---------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-12T16:12:27.970+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+----------------------+----------------------------------------+
| ID | usmcc-stgc9jya08relxfv0k6ujlrmv6pnajgt |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For on-prem Kafka Cluster

Existing behaviour

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--confluent-platform-kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+--------------------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcx9ejliupphptsdbky9k4g5bgvaqy |
| Confluent Platform Connect | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Confluent Platform Kafka | JaH5VfLdRxi_CXfrA_jHxw |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+--------------------------------+------------------------------------------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+----------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcz0stkyddf3eqzex436ofpwtxmxje |
| Connect Cluster | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Kafka Cluster | JaH5VfLdRxi_CXfrA_jHxw |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+----------------------+------------------------------------------------------------------------+

CopilotAI lite review requested due to automatic review settings August 10, 2026 12:12
@confluent-cla-assistant

Copy link
Copy Markdown

🎉 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.

CopilotAI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds support for registering a USM Connect cluster using a new --kafka-cluster flag (in addition to the existing --confluent-platform-kafka-cluster), including updated help text and integration fixtures.

Changes:

  • Add --kafka-cluster flag to usm connect register, making the two Kafka cluster flags mutually exclusive and requiring one of them.
  • Introduce a “hybrid” output shape for the --kafka-cluster flow.
  • Update integration tests and golden outputs to reflect the new flag behavior and validation errors.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
FileDescription
internal/unified-stream-manager/command_connect_register.goAdds the new flag, updates examples, and adjusts flag validation/registration flow.
internal/unified-stream-manager/command_connect.goAdds a new output struct + printer used by the --kafka-cluster registration path.
test/usm_test.goExtends integration test coverage for new flag validation; currently includes commented-out success-path cases.
test/fixtures/output/unified-stream-manager/connect/register-help.goldenUpdates help output to include the new flag and example.
test/fixtures/output/unified-stream-manager/connect/create-fail-paired-flag-missing.goldenUpdates usage/help output shown on paired-flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.goldenAdds fixture for mutually-exclusive Kafka flag error.
test/fixtures/output/unified-stream-manager/connect/create-fail-missing-kafka-flag.goldenAdds fixture for “one required” Kafka flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-cp-kafka.goldenAdds fixture for the --kafka-cluster success-path output currently exercised by tests.
Suppressed comments (1)

internal/unified-stream-manager/command_connect_register.go:69

  • The --kafka-cluster path still flows through the on-prem→cloud Kafka ID mapping and the "not found" logging. For cloud IDs like "lkc-...", this will always miss the map, log a misleading error on success, and can even fail early if ListUsmKafkaClusters requires permissions (even though the mapping is irrelevant for --kafka-cluster).
	if cmd.Flags().Changed("kafka-cluster") {
kafkaClusterId, err = cmd.Flags().GetString("kafka-cluster")
if err != nil {
return err
}
}

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 33 to +34
cmd.Flags().String("confluent-platform-kafka-cluster", "", "The ID of the metadata Kafka cluster for the Connect Cluster.")
cmd.Flags().String("kafka-cluster", "", `The ID of the metadata Kafka cluster for the Connect Cluster.`)
Comment threadtest/usm_test.go
Comment on lines +43 to +46
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cloud-kafka.golden"},
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1 -o json", fixture: "unified-stream-manager/connect/create-cloud-kafka-json.golden"},
{args: "usm connect register connect-group-xyz123 --kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cp-kafka.golden"},
{args: "usm connect register connect-group-xyz123 --confluent-platform-kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.golden", exitCode: 1},
@sonarqube-confluent

Copy link
Copy Markdown

type connectHybridOut struct {
Id string `human:"ID" serialized:"id"`
ConnectCluster string `human:"Connect Cluster" serialized:"connect_cluster"`
USMKafkaClusterId string `human:"USM Kafka Cluster ID" serialized:"usm_kafka_cluster_id"`

@rishabhbits038Rishabh Sharma (rishabhbits038)Aug 13, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we check with the cli team is it is okay to remove this flag altogether?
or is the recommendation to deprecate this first?

Sign up for freeto 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.

3 participants

@FlamedHunter@rishabhbits038
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add --kafka-cluster flag to usm connect register - #3434

Open
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes
Open

Add --kafka-cluster flag to usm connect register#3434
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes

Conversation

@FlamedHunter

@FlamedHunterArman Garg (FlamedHunter) commented Aug 10, 2026

Copy link
Copy Markdown

Release Notes

Breaking Changes

  • NA

New Features

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.

Bug Fixes

  • NA

Checklist

  • I have successfully built and used a custom CLI binary, without linter issues from this PR.
  • I have clearly specified in the What section below whether this PR applies to Confluent Cloud, Confluent Platform, or both.
  • I have verified this PR in Confluent Cloud pre-prod or production environment, if applicable.
  • I have verified this PR in Confluent Platform on-premises environment, if applicable.
  • I have attached manual CLI verification results or screenshots in the Test & Review section below.
  • I have added appropriate CLI integration or unit tests for any new or updated commands and functionality.
  • I confirm that this PR introduces no breaking changes or backward compatibility issues.
  • I have indicated the potential customer impact if something goes wrong in the Blast Radius section below.
  • I have put checkmarks below confirming that the feature associated with this PR is enabled in:
    • Confluent Cloud prod
    • Confluent Cloud stag
    • Confluent Platform
    • Check this box if the feature is enabled for certain organizations only

What

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.
  • The two flags are mutually exclusive, and exactly one is required.
  • --confluent-platform-kafka-cluster's behavior and response shape are unchanged.
  • --kafka-cluster registrations print a new, simplified response (a single "Kafka Cluster" field) containing the value passed to the flag as-is. The CP-to-USM resolution lookup still runs internally but its result isn't surfaced in this response.
  • No backend/API contract change — both flags populate the same kafka_cluster_id field on the existing usm/v1/connect-clusters create request.

Blast Radius

  • Connect cluster registration for USM (Hybrid connect)

References

Test & Review

For cloud Kafka cluster (registered on USM as hybrid)

Existing behaviour

./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+--------------------------------+----------------------------------------+
| ID | usmcc-stgc30gb03wlh93wdqzslkjef43mnapp |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgceuimd7uloqul5uwkmlrbhb5blnfu |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+----------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+----------------------+----------------------------------------+
| ID | usmcc-stgc8aq12lv354p6uf0klhrzx2vwrzm6 |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | usmkc-stgcfpn5laljl8avz7te44hgdh06688 |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For cloud Kafka cluster

Existing behaviour

 ./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-10T22:01:17.679+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+--------------------------------+---------------------------------------+
| ID | usmcc-stgcgs8m3qmv6xm359enzrtm8p7gv77 |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+---------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-12T16:12:27.970+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+----------------------+----------------------------------------+
| ID | usmcc-stgc9jya08relxfv0k6ujlrmv6pnajgt |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For on-prem Kafka Cluster

Existing behaviour

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--confluent-platform-kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+--------------------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcx9ejliupphptsdbky9k4g5bgvaqy |
| Confluent Platform Connect | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Confluent Platform Kafka | JaH5VfLdRxi_CXfrA_jHxw |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+--------------------------------+------------------------------------------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+----------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcz0stkyddf3eqzex436ofpwtxmxje |
| Connect Cluster | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Kafka Cluster | JaH5VfLdRxi_CXfrA_jHxw |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+----------------------+------------------------------------------------------------------------+

CopilotAI lite review requested due to automatic review settings August 10, 2026 12:12
@confluent-cla-assistant

Copy link
Copy Markdown

🎉 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.

CopilotAI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds support for registering a USM Connect cluster using a new --kafka-cluster flag (in addition to the existing --confluent-platform-kafka-cluster), including updated help text and integration fixtures.

Changes:

  • Add --kafka-cluster flag to usm connect register, making the two Kafka cluster flags mutually exclusive and requiring one of them.
  • Introduce a “hybrid” output shape for the --kafka-cluster flow.
  • Update integration tests and golden outputs to reflect the new flag behavior and validation errors.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
FileDescription
internal/unified-stream-manager/command_connect_register.goAdds the new flag, updates examples, and adjusts flag validation/registration flow.
internal/unified-stream-manager/command_connect.goAdds a new output struct + printer used by the --kafka-cluster registration path.
test/usm_test.goExtends integration test coverage for new flag validation; currently includes commented-out success-path cases.
test/fixtures/output/unified-stream-manager/connect/register-help.goldenUpdates help output to include the new flag and example.
test/fixtures/output/unified-stream-manager/connect/create-fail-paired-flag-missing.goldenUpdates usage/help output shown on paired-flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.goldenAdds fixture for mutually-exclusive Kafka flag error.
test/fixtures/output/unified-stream-manager/connect/create-fail-missing-kafka-flag.goldenAdds fixture for “one required” Kafka flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-cp-kafka.goldenAdds fixture for the --kafka-cluster success-path output currently exercised by tests.
Suppressed comments (1)

internal/unified-stream-manager/command_connect_register.go:69

  • The --kafka-cluster path still flows through the on-prem→cloud Kafka ID mapping and the "not found" logging. For cloud IDs like "lkc-...", this will always miss the map, log a misleading error on success, and can even fail early if ListUsmKafkaClusters requires permissions (even though the mapping is irrelevant for --kafka-cluster).
	if cmd.Flags().Changed("kafka-cluster") {
kafkaClusterId, err = cmd.Flags().GetString("kafka-cluster")
if err != nil {
return err
}
}

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 33 to +34
cmd.Flags().String("confluent-platform-kafka-cluster", "", "The ID of the metadata Kafka cluster for the Connect Cluster.")
cmd.Flags().String("kafka-cluster", "", `The ID of the metadata Kafka cluster for the Connect Cluster.`)
Comment threadtest/usm_test.go
Comment on lines +43 to +46
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cloud-kafka.golden"},
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1 -o json", fixture: "unified-stream-manager/connect/create-cloud-kafka-json.golden"},
{args: "usm connect register connect-group-xyz123 --kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cp-kafka.golden"},
{args: "usm connect register connect-group-xyz123 --confluent-platform-kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.golden", exitCode: 1},
@sonarqube-confluent

Copy link
Copy Markdown

type connectHybridOut struct {
Id string `human:"ID" serialized:"id"`
ConnectCluster string `human:"Connect Cluster" serialized:"connect_cluster"`
USMKafkaClusterId string `human:"USM Kafka Cluster ID" serialized:"usm_kafka_cluster_id"`

@rishabhbits038Rishabh Sharma (rishabhbits038)Aug 13, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we check with the cli team is it is okay to remove this flag altogether?
or is the recommendation to deprecate this first?

Sign up for freeto 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.

3 participants

@FlamedHunter@rishabhbits038
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Add --kafka-cluster flag to usm connect register - #3434

Open
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes
Open

Add --kafka-cluster flag to usm connect register#3434
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes

Conversation

@FlamedHunter

@FlamedHunterArman Garg (FlamedHunter) commented Aug 10, 2026

Copy link
Copy Markdown

Release Notes

Breaking Changes

  • NA

New Features

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.

Bug Fixes

  • NA

Checklist

  • I have successfully built and used a custom CLI binary, without linter issues from this PR.
  • I have clearly specified in the What section below whether this PR applies to Confluent Cloud, Confluent Platform, or both.
  • I have verified this PR in Confluent Cloud pre-prod or production environment, if applicable.
  • I have verified this PR in Confluent Platform on-premises environment, if applicable.
  • I have attached manual CLI verification results or screenshots in the Test & Review section below.
  • I have added appropriate CLI integration or unit tests for any new or updated commands and functionality.
  • I confirm that this PR introduces no breaking changes or backward compatibility issues.
  • I have indicated the potential customer impact if something goes wrong in the Blast Radius section below.
  • I have put checkmarks below confirming that the feature associated with this PR is enabled in:
    • Confluent Cloud prod
    • Confluent Cloud stag
    • Confluent Platform
    • Check this box if the feature is enabled for certain organizations only

What

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.
  • The two flags are mutually exclusive, and exactly one is required.
  • --confluent-platform-kafka-cluster's behavior and response shape are unchanged.
  • --kafka-cluster registrations print a new, simplified response (a single "Kafka Cluster" field) containing the value passed to the flag as-is. The CP-to-USM resolution lookup still runs internally but its result isn't surfaced in this response.
  • No backend/API contract change — both flags populate the same kafka_cluster_id field on the existing usm/v1/connect-clusters create request.

Blast Radius

  • Connect cluster registration for USM (Hybrid connect)

References

Test & Review

For cloud Kafka cluster (registered on USM as hybrid)

Existing behaviour

./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+--------------------------------+----------------------------------------+
| ID | usmcc-stgc30gb03wlh93wdqzslkjef43mnapp |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgceuimd7uloqul5uwkmlrbhb5blnfu |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+----------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+----------------------+----------------------------------------+
| ID | usmcc-stgc8aq12lv354p6uf0klhrzx2vwrzm6 |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | usmkc-stgcfpn5laljl8avz7te44hgdh06688 |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For cloud Kafka cluster

Existing behaviour

 ./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-10T22:01:17.679+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+--------------------------------+---------------------------------------+
| ID | usmcc-stgcgs8m3qmv6xm359enzrtm8p7gv77 |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+---------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-12T16:12:27.970+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+----------------------+----------------------------------------+
| ID | usmcc-stgc9jya08relxfv0k6ujlrmv6pnajgt |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For on-prem Kafka Cluster

Existing behaviour

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--confluent-platform-kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+--------------------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcx9ejliupphptsdbky9k4g5bgvaqy |
| Confluent Platform Connect | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Confluent Platform Kafka | JaH5VfLdRxi_CXfrA_jHxw |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+--------------------------------+------------------------------------------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+----------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcz0stkyddf3eqzex436ofpwtxmxje |
| Connect Cluster | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Kafka Cluster | JaH5VfLdRxi_CXfrA_jHxw |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+----------------------+------------------------------------------------------------------------+

CopilotAI lite review requested due to automatic review settings August 10, 2026 12:12
@confluent-cla-assistant

Copy link
Copy Markdown

🎉 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.

CopilotAI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds support for registering a USM Connect cluster using a new --kafka-cluster flag (in addition to the existing --confluent-platform-kafka-cluster), including updated help text and integration fixtures.

Changes:

  • Add --kafka-cluster flag to usm connect register, making the two Kafka cluster flags mutually exclusive and requiring one of them.
  • Introduce a “hybrid” output shape for the --kafka-cluster flow.
  • Update integration tests and golden outputs to reflect the new flag behavior and validation errors.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
FileDescription
internal/unified-stream-manager/command_connect_register.goAdds the new flag, updates examples, and adjusts flag validation/registration flow.
internal/unified-stream-manager/command_connect.goAdds a new output struct + printer used by the --kafka-cluster registration path.
test/usm_test.goExtends integration test coverage for new flag validation; currently includes commented-out success-path cases.
test/fixtures/output/unified-stream-manager/connect/register-help.goldenUpdates help output to include the new flag and example.
test/fixtures/output/unified-stream-manager/connect/create-fail-paired-flag-missing.goldenUpdates usage/help output shown on paired-flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.goldenAdds fixture for mutually-exclusive Kafka flag error.
test/fixtures/output/unified-stream-manager/connect/create-fail-missing-kafka-flag.goldenAdds fixture for “one required” Kafka flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-cp-kafka.goldenAdds fixture for the --kafka-cluster success-path output currently exercised by tests.
Suppressed comments (1)

internal/unified-stream-manager/command_connect_register.go:69

  • The --kafka-cluster path still flows through the on-prem→cloud Kafka ID mapping and the "not found" logging. For cloud IDs like "lkc-...", this will always miss the map, log a misleading error on success, and can even fail early if ListUsmKafkaClusters requires permissions (even though the mapping is irrelevant for --kafka-cluster).
	if cmd.Flags().Changed("kafka-cluster") {
kafkaClusterId, err = cmd.Flags().GetString("kafka-cluster")
if err != nil {
return err
}
}

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 33 to +34
cmd.Flags().String("confluent-platform-kafka-cluster", "", "The ID of the metadata Kafka cluster for the Connect Cluster.")
cmd.Flags().String("kafka-cluster", "", `The ID of the metadata Kafka cluster for the Connect Cluster.`)
Comment threadtest/usm_test.go
Comment on lines +43 to +46
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cloud-kafka.golden"},
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1 -o json", fixture: "unified-stream-manager/connect/create-cloud-kafka-json.golden"},
{args: "usm connect register connect-group-xyz123 --kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cp-kafka.golden"},
{args: "usm connect register connect-group-xyz123 --confluent-platform-kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.golden", exitCode: 1},
@sonarqube-confluent

Copy link
Copy Markdown

type connectHybridOut struct {
Id string `human:"ID" serialized:"id"`
ConnectCluster string `human:"Connect Cluster" serialized:"connect_cluster"`
USMKafkaClusterId string `human:"USM Kafka Cluster ID" serialized:"usm_kafka_cluster_id"`

@rishabhbits038Rishabh Sharma (rishabhbits038)Aug 13, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we check with the cli team is it is okay to remove this flag altogether?
or is the recommendation to deprecate this first?

Sign up for freeto 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.

3 participants

@FlamedHunter@rishabhbits038
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add --kafka-cluster flag to usm connect register - #3434

Open
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes
Open

Add --kafka-cluster flag to usm connect register#3434
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes

Conversation

@FlamedHunter

@FlamedHunterArman Garg (FlamedHunter) commented Aug 10, 2026

Copy link
Copy Markdown

Release Notes

Breaking Changes

  • NA

New Features

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.

Bug Fixes

  • NA

Checklist

  • I have successfully built and used a custom CLI binary, without linter issues from this PR.
  • I have clearly specified in the What section below whether this PR applies to Confluent Cloud, Confluent Platform, or both.
  • I have verified this PR in Confluent Cloud pre-prod or production environment, if applicable.
  • I have verified this PR in Confluent Platform on-premises environment, if applicable.
  • I have attached manual CLI verification results or screenshots in the Test & Review section below.
  • I have added appropriate CLI integration or unit tests for any new or updated commands and functionality.
  • I confirm that this PR introduces no breaking changes or backward compatibility issues.
  • I have indicated the potential customer impact if something goes wrong in the Blast Radius section below.
  • I have put checkmarks below confirming that the feature associated with this PR is enabled in:
    • Confluent Cloud prod
    • Confluent Cloud stag
    • Confluent Platform
    • Check this box if the feature is enabled for certain organizations only

What

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.
  • The two flags are mutually exclusive, and exactly one is required.
  • --confluent-platform-kafka-cluster's behavior and response shape are unchanged.
  • --kafka-cluster registrations print a new, simplified response (a single "Kafka Cluster" field) containing the value passed to the flag as-is. The CP-to-USM resolution lookup still runs internally but its result isn't surfaced in this response.
  • No backend/API contract change — both flags populate the same kafka_cluster_id field on the existing usm/v1/connect-clusters create request.

Blast Radius

  • Connect cluster registration for USM (Hybrid connect)

References

Test & Review

For cloud Kafka cluster (registered on USM as hybrid)

Existing behaviour

./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+--------------------------------+----------------------------------------+
| ID | usmcc-stgc30gb03wlh93wdqzslkjef43mnapp |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgceuimd7uloqul5uwkmlrbhb5blnfu |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+----------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+----------------------+----------------------------------------+
| ID | usmcc-stgc8aq12lv354p6uf0klhrzx2vwrzm6 |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | usmkc-stgcfpn5laljl8avz7te44hgdh06688 |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For cloud Kafka cluster

Existing behaviour

 ./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-10T22:01:17.679+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+--------------------------------+---------------------------------------+
| ID | usmcc-stgcgs8m3qmv6xm359enzrtm8p7gv77 |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+---------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-12T16:12:27.970+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+----------------------+----------------------------------------+
| ID | usmcc-stgc9jya08relxfv0k6ujlrmv6pnajgt |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For on-prem Kafka Cluster

Existing behaviour

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--confluent-platform-kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+--------------------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcx9ejliupphptsdbky9k4g5bgvaqy |
| Confluent Platform Connect | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Confluent Platform Kafka | JaH5VfLdRxi_CXfrA_jHxw |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+--------------------------------+------------------------------------------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+----------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcz0stkyddf3eqzex436ofpwtxmxje |
| Connect Cluster | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Kafka Cluster | JaH5VfLdRxi_CXfrA_jHxw |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+----------------------+------------------------------------------------------------------------+

CopilotAI lite review requested due to automatic review settings August 10, 2026 12:12
@confluent-cla-assistant

Copy link
Copy Markdown

🎉 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.

CopilotAI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds support for registering a USM Connect cluster using a new --kafka-cluster flag (in addition to the existing --confluent-platform-kafka-cluster), including updated help text and integration fixtures.

Changes:

  • Add --kafka-cluster flag to usm connect register, making the two Kafka cluster flags mutually exclusive and requiring one of them.
  • Introduce a “hybrid” output shape for the --kafka-cluster flow.
  • Update integration tests and golden outputs to reflect the new flag behavior and validation errors.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
FileDescription
internal/unified-stream-manager/command_connect_register.goAdds the new flag, updates examples, and adjusts flag validation/registration flow.
internal/unified-stream-manager/command_connect.goAdds a new output struct + printer used by the --kafka-cluster registration path.
test/usm_test.goExtends integration test coverage for new flag validation; currently includes commented-out success-path cases.
test/fixtures/output/unified-stream-manager/connect/register-help.goldenUpdates help output to include the new flag and example.
test/fixtures/output/unified-stream-manager/connect/create-fail-paired-flag-missing.goldenUpdates usage/help output shown on paired-flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.goldenAdds fixture for mutually-exclusive Kafka flag error.
test/fixtures/output/unified-stream-manager/connect/create-fail-missing-kafka-flag.goldenAdds fixture for “one required” Kafka flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-cp-kafka.goldenAdds fixture for the --kafka-cluster success-path output currently exercised by tests.
Suppressed comments (1)

internal/unified-stream-manager/command_connect_register.go:69

  • The --kafka-cluster path still flows through the on-prem→cloud Kafka ID mapping and the "not found" logging. For cloud IDs like "lkc-...", this will always miss the map, log a misleading error on success, and can even fail early if ListUsmKafkaClusters requires permissions (even though the mapping is irrelevant for --kafka-cluster).
	if cmd.Flags().Changed("kafka-cluster") {
kafkaClusterId, err = cmd.Flags().GetString("kafka-cluster")
if err != nil {
return err
}
}

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 33 to +34
cmd.Flags().String("confluent-platform-kafka-cluster", "", "The ID of the metadata Kafka cluster for the Connect Cluster.")
cmd.Flags().String("kafka-cluster", "", `The ID of the metadata Kafka cluster for the Connect Cluster.`)
Comment threadtest/usm_test.go
Comment on lines +43 to +46
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cloud-kafka.golden"},
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1 -o json", fixture: "unified-stream-manager/connect/create-cloud-kafka-json.golden"},
{args: "usm connect register connect-group-xyz123 --kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cp-kafka.golden"},
{args: "usm connect register connect-group-xyz123 --confluent-platform-kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.golden", exitCode: 1},
@sonarqube-confluent

Copy link
Copy Markdown

type connectHybridOut struct {
Id string `human:"ID" serialized:"id"`
ConnectCluster string `human:"Connect Cluster" serialized:"connect_cluster"`
USMKafkaClusterId string `human:"USM Kafka Cluster ID" serialized:"usm_kafka_cluster_id"`

@rishabhbits038Rishabh Sharma (rishabhbits038)Aug 13, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we check with the cli team is it is okay to remove this flag altogether?
or is the recommendation to deprecate this first?

Sign up for freeto 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.

3 participants

@FlamedHunter@rishabhbits038
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add --kafka-cluster flag to usm connect register - #3434

Open
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes
Open

Add --kafka-cluster flag to usm connect register#3434
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes

Conversation

@FlamedHunter

@FlamedHunterArman Garg (FlamedHunter) commented Aug 10, 2026

Copy link
Copy Markdown

Release Notes

Breaking Changes

  • NA

New Features

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.

Bug Fixes

  • NA

Checklist

  • I have successfully built and used a custom CLI binary, without linter issues from this PR.
  • I have clearly specified in the What section below whether this PR applies to Confluent Cloud, Confluent Platform, or both.
  • I have verified this PR in Confluent Cloud pre-prod or production environment, if applicable.
  • I have verified this PR in Confluent Platform on-premises environment, if applicable.
  • I have attached manual CLI verification results or screenshots in the Test & Review section below.
  • I have added appropriate CLI integration or unit tests for any new or updated commands and functionality.
  • I confirm that this PR introduces no breaking changes or backward compatibility issues.
  • I have indicated the potential customer impact if something goes wrong in the Blast Radius section below.
  • I have put checkmarks below confirming that the feature associated with this PR is enabled in:
    • Confluent Cloud prod
    • Confluent Cloud stag
    • Confluent Platform
    • Check this box if the feature is enabled for certain organizations only

What

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.
  • The two flags are mutually exclusive, and exactly one is required.
  • --confluent-platform-kafka-cluster's behavior and response shape are unchanged.
  • --kafka-cluster registrations print a new, simplified response (a single "Kafka Cluster" field) containing the value passed to the flag as-is. The CP-to-USM resolution lookup still runs internally but its result isn't surfaced in this response.
  • No backend/API contract change — both flags populate the same kafka_cluster_id field on the existing usm/v1/connect-clusters create request.

Blast Radius

  • Connect cluster registration for USM (Hybrid connect)

References

Test & Review

For cloud Kafka cluster (registered on USM as hybrid)

Existing behaviour

./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+--------------------------------+----------------------------------------+
| ID | usmcc-stgc30gb03wlh93wdqzslkjef43mnapp |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgceuimd7uloqul5uwkmlrbhb5blnfu |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+----------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+----------------------+----------------------------------------+
| ID | usmcc-stgc8aq12lv354p6uf0klhrzx2vwrzm6 |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | usmkc-stgcfpn5laljl8avz7te44hgdh06688 |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For cloud Kafka cluster

Existing behaviour

 ./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-10T22:01:17.679+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+--------------------------------+---------------------------------------+
| ID | usmcc-stgcgs8m3qmv6xm359enzrtm8p7gv77 |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+---------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-12T16:12:27.970+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+----------------------+----------------------------------------+
| ID | usmcc-stgc9jya08relxfv0k6ujlrmv6pnajgt |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For on-prem Kafka Cluster

Existing behaviour

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--confluent-platform-kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+--------------------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcx9ejliupphptsdbky9k4g5bgvaqy |
| Confluent Platform Connect | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Confluent Platform Kafka | JaH5VfLdRxi_CXfrA_jHxw |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+--------------------------------+------------------------------------------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+----------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcz0stkyddf3eqzex436ofpwtxmxje |
| Connect Cluster | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Kafka Cluster | JaH5VfLdRxi_CXfrA_jHxw |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+----------------------+------------------------------------------------------------------------+

CopilotAI lite review requested due to automatic review settings August 10, 2026 12:12
@confluent-cla-assistant

Copy link
Copy Markdown

🎉 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.

CopilotAI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds support for registering a USM Connect cluster using a new --kafka-cluster flag (in addition to the existing --confluent-platform-kafka-cluster), including updated help text and integration fixtures.

Changes:

  • Add --kafka-cluster flag to usm connect register, making the two Kafka cluster flags mutually exclusive and requiring one of them.
  • Introduce a “hybrid” output shape for the --kafka-cluster flow.
  • Update integration tests and golden outputs to reflect the new flag behavior and validation errors.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
FileDescription
internal/unified-stream-manager/command_connect_register.goAdds the new flag, updates examples, and adjusts flag validation/registration flow.
internal/unified-stream-manager/command_connect.goAdds a new output struct + printer used by the --kafka-cluster registration path.
test/usm_test.goExtends integration test coverage for new flag validation; currently includes commented-out success-path cases.
test/fixtures/output/unified-stream-manager/connect/register-help.goldenUpdates help output to include the new flag and example.
test/fixtures/output/unified-stream-manager/connect/create-fail-paired-flag-missing.goldenUpdates usage/help output shown on paired-flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.goldenAdds fixture for mutually-exclusive Kafka flag error.
test/fixtures/output/unified-stream-manager/connect/create-fail-missing-kafka-flag.goldenAdds fixture for “one required” Kafka flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-cp-kafka.goldenAdds fixture for the --kafka-cluster success-path output currently exercised by tests.
Suppressed comments (1)

internal/unified-stream-manager/command_connect_register.go:69

  • The --kafka-cluster path still flows through the on-prem→cloud Kafka ID mapping and the "not found" logging. For cloud IDs like "lkc-...", this will always miss the map, log a misleading error on success, and can even fail early if ListUsmKafkaClusters requires permissions (even though the mapping is irrelevant for --kafka-cluster).
	if cmd.Flags().Changed("kafka-cluster") {
kafkaClusterId, err = cmd.Flags().GetString("kafka-cluster")
if err != nil {
return err
}
}

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 33 to +34
cmd.Flags().String("confluent-platform-kafka-cluster", "", "The ID of the metadata Kafka cluster for the Connect Cluster.")
cmd.Flags().String("kafka-cluster", "", `The ID of the metadata Kafka cluster for the Connect Cluster.`)
Comment threadtest/usm_test.go
Comment on lines +43 to +46
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cloud-kafka.golden"},
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1 -o json", fixture: "unified-stream-manager/connect/create-cloud-kafka-json.golden"},
{args: "usm connect register connect-group-xyz123 --kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cp-kafka.golden"},
{args: "usm connect register connect-group-xyz123 --confluent-platform-kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.golden", exitCode: 1},
@sonarqube-confluent

Copy link
Copy Markdown

type connectHybridOut struct {
Id string `human:"ID" serialized:"id"`
ConnectCluster string `human:"Connect Cluster" serialized:"connect_cluster"`
USMKafkaClusterId string `human:"USM Kafka Cluster ID" serialized:"usm_kafka_cluster_id"`

@rishabhbits038Rishabh Sharma (rishabhbits038)Aug 13, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we check with the cli team is it is okay to remove this flag altogether?
or is the recommendation to deprecate this first?

Sign up for freeto 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.

3 participants

@FlamedHunter@rishabhbits038
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Add --kafka-cluster flag to usm connect register - #3434

Open
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes
Open

Add --kafka-cluster flag to usm connect register#3434
Arman Garg (FlamedHunter) wants to merge 2 commits into
mainfrom
CC-43569-usm-changes

Conversation

@FlamedHunter

@FlamedHunterArman Garg (FlamedHunter) commented Aug 10, 2026

Copy link
Copy Markdown

Release Notes

Breaking Changes

  • NA

New Features

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.

Bug Fixes

  • NA

Checklist

  • I have successfully built and used a custom CLI binary, without linter issues from this PR.
  • I have clearly specified in the What section below whether this PR applies to Confluent Cloud, Confluent Platform, or both.
  • I have verified this PR in Confluent Cloud pre-prod or production environment, if applicable.
  • I have verified this PR in Confluent Platform on-premises environment, if applicable.
  • I have attached manual CLI verification results or screenshots in the Test & Review section below.
  • I have added appropriate CLI integration or unit tests for any new or updated commands and functionality.
  • I confirm that this PR introduces no breaking changes or backward compatibility issues.
  • I have indicated the potential customer impact if something goes wrong in the Blast Radius section below.
  • I have put checkmarks below confirming that the feature associated with this PR is enabled in:
    • Confluent Cloud prod
    • Confluent Cloud stag
    • Confluent Platform
    • Check this box if the feature is enabled for certain organizations only

What

  • Add a new --kafka-cluster flag to confluent unified-stream-manager connect register, accepting either a Confluent Platform Kafka cluster ID or a Confluent Cloud Kafka cluster ID (lkc-...), as an alternative to --confluent-platform-kafka-cluster.
  • The two flags are mutually exclusive, and exactly one is required.
  • --confluent-platform-kafka-cluster's behavior and response shape are unchanged.
  • --kafka-cluster registrations print a new, simplified response (a single "Kafka Cluster" field) containing the value passed to the flag as-is. The CP-to-USM resolution lookup still runs internally but its result isn't surfaced in this response.
  • No backend/API contract change — both flags populate the same kafka_cluster_id field on the existing usm/v1/connect-clusters create request.

Blast Radius

  • Connect cluster registration for USM (Hybrid connect)

References

Test & Review

For cloud Kafka cluster (registered on USM as hybrid)

Existing behaviour

./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+--------------------------------+----------------------------------------+
| ID | usmcc-stgc30gb03wlh93wdqzslkjef43mnapp |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgceuimd7uloqul5uwkmlrbhb5blnfu |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+----------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
+----------------------+----------------------------------------+
| ID | usmcc-stgc8aq12lv354p6uf0klhrzx2vwrzm6 |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | usmkc-stgcfpn5laljl8avz7te44hgdh06688 |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For cloud Kafka cluster

Existing behaviour

 ./confluent usm connect register connect-cc-cluster \
--confluent-platform-kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-10T22:01:17.679+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+--------------------------------+---------------------------------------+
| ID | usmcc-stgcgs8m3qmv6xm359enzrtm8p7gv77 |
| Confluent Platform Connect | connect-cc-cluster |
| Cluster | |
| USM Kafka Cluster ID | |
| Confluent Platform Kafka | lkc-stgcqoxq3p |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+--------------------------------+---------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register connect-cc-cluster \
--kafka-cluster lkc-stgcqoxq3p \
--cloud aws --region us-west-2
2026-08-12T16:12:27.970+0530 [ERROR] USM Kafka cluster corresponding to Confluent Platform Kafka cluster lkc-stgcqoxq3p not found
+----------------------+----------------------------------------+
| ID | usmcc-stgc9jya08relxfv0k6ujlrmv6pnajgt |
| Connect Cluster | connect-cc-cluster |
| USM Kafka Cluster ID | |
| Kafka Cluster | lkc-stgcqoxq3p |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcnqgrj3 |
+----------------------+----------------------------------------+

For on-prem Kafka Cluster

Existing behaviour

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--confluent-platform-kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+--------------------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcx9ejliupphptsdbky9k4g5bgvaqy |
| Confluent Platform Connect | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| Cluster | |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Confluent Platform Kafka | JaH5VfLdRxi_CXfrA_jHxw |
| Cluster ID | |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+--------------------------------+------------------------------------------------------------------------+

Using new flag (kafka-cluster)

./confluent usm connect register argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect \
--kafka-cluster JaH5VfLdRxi_CXfrA_jHxw \
--cloud aws --region us-west-2
+----------------------+------------------------------------------------------------------------+
| ID | usmcc-stgcz0stkyddf3eqzex436ofpwtxmxje |
| Connect Cluster | argarg-setu-20260809-11f7f8c9-029e-4239-9f12-1ae0ff6a6a29-main-connect |
| USM Kafka Cluster ID | usmkc-stgcppuy2f6x8q1dbkskllrgzlt84bb |
| Kafka Cluster | JaH5VfLdRxi_CXfrA_jHxw |
| Cloud | AWS |
| Region | us-west-2 |
| Environment | env-stgcn37oy6 |
+----------------------+------------------------------------------------------------------------+

CopilotAI lite review requested due to automatic review settings August 10, 2026 12:12
@confluent-cla-assistant

Copy link
Copy Markdown

🎉 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.

CopilotAI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds support for registering a USM Connect cluster using a new --kafka-cluster flag (in addition to the existing --confluent-platform-kafka-cluster), including updated help text and integration fixtures.

Changes:

  • Add --kafka-cluster flag to usm connect register, making the two Kafka cluster flags mutually exclusive and requiring one of them.
  • Introduce a “hybrid” output shape for the --kafka-cluster flow.
  • Update integration tests and golden outputs to reflect the new flag behavior and validation errors.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
FileDescription
internal/unified-stream-manager/command_connect_register.goAdds the new flag, updates examples, and adjusts flag validation/registration flow.
internal/unified-stream-manager/command_connect.goAdds a new output struct + printer used by the --kafka-cluster registration path.
test/usm_test.goExtends integration test coverage for new flag validation; currently includes commented-out success-path cases.
test/fixtures/output/unified-stream-manager/connect/register-help.goldenUpdates help output to include the new flag and example.
test/fixtures/output/unified-stream-manager/connect/create-fail-paired-flag-missing.goldenUpdates usage/help output shown on paired-flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.goldenAdds fixture for mutually-exclusive Kafka flag error.
test/fixtures/output/unified-stream-manager/connect/create-fail-missing-kafka-flag.goldenAdds fixture for “one required” Kafka flag validation error.
test/fixtures/output/unified-stream-manager/connect/create-cp-kafka.goldenAdds fixture for the --kafka-cluster success-path output currently exercised by tests.
Suppressed comments (1)

internal/unified-stream-manager/command_connect_register.go:69

  • The --kafka-cluster path still flows through the on-prem→cloud Kafka ID mapping and the "not found" logging. For cloud IDs like "lkc-...", this will always miss the map, log a misleading error on success, and can even fail early if ListUsmKafkaClusters requires permissions (even though the mapping is irrelevant for --kafka-cluster).
	if cmd.Flags().Changed("kafka-cluster") {
kafkaClusterId, err = cmd.Flags().GetString("kafka-cluster")
if err != nil {
return err
}
}

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 33 to +34
cmd.Flags().String("confluent-platform-kafka-cluster", "", "The ID of the metadata Kafka cluster for the Connect Cluster.")
cmd.Flags().String("kafka-cluster", "", `The ID of the metadata Kafka cluster for the Connect Cluster.`)
Comment threadtest/usm_test.go
Comment on lines +43 to +46
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cloud-kafka.golden"},
//{args: "usm connect register connect-group-xyz123 --kafka-cluster lkc-abc123 --cloud aws --region us-east-1 -o json", fixture: "unified-stream-manager/connect/create-cloud-kafka-json.golden"},
{args: "usm connect register connect-group-xyz123 --kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-cp-kafka.golden"},
{args: "usm connect register connect-group-xyz123 --confluent-platform-kafka-cluster 4k0R9d1GTS5tI9f4Y2xZ0Q --kafka-cluster lkc-abc123 --cloud aws --region us-east-1", fixture: "unified-stream-manager/connect/create-fail-mutually-exclusive-kafka-flags.golden", exitCode: 1},
@sonarqube-confluent

Copy link
Copy Markdown

type connectHybridOut struct {
Id string `human:"ID" serialized:"id"`
ConnectCluster string `human:"Connect Cluster" serialized:"connect_cluster"`
USMKafkaClusterId string `human:"USM Kafka Cluster ID" serialized:"usm_kafka_cluster_id"`

@rishabhbits038Rishabh Sharma (rishabhbits038)Aug 13, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we check with the cli team is it is okay to remove this flag altogether?
or is the recommendation to deprecate this first?

Sign up for freeto 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.

3 participants

@FlamedHunter@rishabhbits038