Confluent CLI Release Notes¶
[9/22/2022] Confluent CLI v2.26.0 Release Notes¶
- New Features
- Display
State
,Error
andError Message
inconfluent kafka link list
- Show more detailed error messages for Confluent Cloud API routes
- Display
[9/13/2022] Confluent CLI v2.25.0 Release Notes¶
- New Features
- Add
confluent environment describe
- Add
confluent api-key describe
- The
-vvv
flag now notifies the user that$PATH
is recursively searched for plugins
- Add
- Bug Fixes
- Fix the example for
confluent kafka acl create
- Allow deletion of ksqlDB clusters that failed to provision
- Fix the example for
Note
The new CLI plugins functionality, introduced in v2.24.0, searches your
entire $PATH
and can cause slow response time.
If you are experiencing CLI commands hanging, set the following in the
~/.confluent/config.json
file to disable the plugins:
"disable_plugins": true
[8/22/2022] Confluent CLI v2.24.2 Release Notes¶
- Bug Fixes
- Fix 404 error for
kafka acl
commands - Fix non-root user in Docker image
- Fix 404 error for
[8/21/2022] Confluent CLI v2.24.1 Release Notes¶
- Bug Fixes
--unsafe-trace
works with every command that uses HTTP- Fix panic that could occur when user was unauthenticated
[8/18/2022] Confluent CLI v2.24.0 Release Notes¶
- New Features
- Added plugin framework and
confluent plugin list
command - Signed Windows binaries
- Add non-root user to Dockerfile
- Added examples for
confluent login
- Warn when updating read-only topic configurations in
confluent kafka topic update
- Added plugin framework and
- Bug Fixes
- Add global
--unsafe-trace
flag - Netrc auto-login should use the current context
- Update command list on login in
confluent shell
- Prevent error when fetching Kafka cluster from within an API key context
- Improve error messages in
confluent kafka topic create
- Add global
[7/28/2022] Confluent CLI v2.23.0 Release Notes¶
- Bug Fixes
- Correctly identify Confluent Cloud contexts created with
confluent context create
- Fix panic when running
confluent local services connect start
without “plugin.path”
- Correctly identify Confluent Cloud contexts created with
[7/20/2022] Confluent CLI v2.22.0 Release Notes¶
- New Features
- Add
confluent iam user update
- Add
--package
flag toconfluent schema-registry cluster enable --package
- Add
confluent schema-registry cluster upgrade
- Improve error message when trying to delete a cluster with active connectors
- Add “Detailed Processing Log” field to
confluent ksql cluster create
andconfluent ksql cluster describe
- Add “Usage” field to
confluent service-quota list
- Add
- Bug Fixes
- Properly identify organizations on free trial
- Fix panic when creating kSQL API keys with
confluent api-key create
exceeds the quota - Reformat error message when shrinking a cluster by more than 1 CKU in
confluent kafka cluster update
[7/11/2022] Confluent CLI v2.21.0 Release Notes¶
- New Features
- Add
confluent iam service-account describe
- Show more detailed error messages for Confluent Cloud API routes
- Add
- Bug Fixes
- Fix issue where organizations are marked as suspended, even after being reactivated
[6/30/2022] Confluent CLI v2.20.0 Release Notes¶
- New Features
- Support
--dry-run
and--no-validate
flags forconfluent kafka link create
- Support
- Bug Fixes
- Refresh cached Kafka cluster metadata on a weekly basis, instead of infinitely
[5/8/2023] Confluent CLI v2.19.1 Release Notes¶
- Bug Fixes
- Encrypt authenticated context and login credentials on local storage
[6/23/2022] Confluent CLI v2.19.0 Release Notes¶
- New Features
- Improve free remaining credit message in
confluent login
andconfluent cloud-signup
- Improve free remaining credit message in
[6/16/2022] Confluent CLI v2.18.0 Release Notes¶
- New Features
- Show service account role bindings in
confluent iam role-binding list
- Improve examples for
confluent ksql cluster create
- Make errors more descriptive in
confluent api-key create
- Add “Service Provider Region” and “Package” fields to
confluent schema-registry cluster describe
- Add
--source-topic
flag toconfluent kafka mirror topic create
- Show service account role bindings in
- Bug Fixes
- Allow configuration values to contain commas in
--config
- Allow configuration values to contain commas in
Confluent CLI v2.17.2 Release Notes¶
- Bug Fixes
- When running
confluent update
, Alpine Linux users will update to a statically-linked CLI build, while other users will update to a dynamically-linked CLI build. See Supported Environments for Confluent CLI for details. - On Alpine Linux, you cannot use
confluent update
to update from Confluent CLI versions earlier than v2.17.2. Theconfluent update
command works for v2.17.2 or later. From the older versions, usecurl
or tarball installation to update to the latest version. See Install Confluent CLI for details.
- When running
Confluent CLI v2.17.1 Release Notes¶
- New Features
- When running
confluent update
, Alpine Linux users will update to a statically-linked CLI build, while other users will update to a dynamically-linked CLI build.
- When running
Confluent CLI v2.17.0 Release Notes¶
- New Features
- Allow suspended users to connect a credit card and redeem promo codes
- Add
confluent schema-registry cluster delete
- Bug Fixes
- Improve error message when running
confluent kafka topic produce <topic> --value-format
without a schema path or schema ID specified
- Improve error message when running
Confluent CLI v2.16.0 Release Notes¶
- New Features
- Retry 5 times if request fails in a subset of commands.
- Add
--offset
flag toconfluent kafka topic consume
command, allowing users to set an offset from the beginning to consume from - Add
--partition
flag toconfluent kafka topic consume
command, allowing users to consume from a certain partition of topic
- Bug Fixes
- Fix
environment not found in context
error when passing audit log or connect event environment via--environment
flag - Remove the null byte prepended to messages when running
confluent kafka topic consume
command without a schema
- Fix
Confluent CLI v2.15.1 Release Notes¶
- Bug Fixes
- Resolve auth token refresh failure for a group of SSO users
Confluent CLI v2.15.0 Release Notes¶
- New Features
- Add the ability to disable cloud features in the event of a security incident
- Clarify that
confluent login --save
should not be used with SSO login
Confluent CLI v2.14.0 Release Notes¶
- New Features
- Added
confluent schema-registry exporter
commands for Confluent Platform - Return a more specific error message if resource quota limits are exceeded
- Added
- Bug Fixes
- Ignore redundant
--save
flag atconfluent login
for SSO users
- Ignore redundant
Confluent CLI v2.13.2 Release Notes¶
- Bug Fixes
- Fix panic on
confluent login
when user context is not defined
- Fix panic on
Confluent CLI v2.13.1 Release Notes¶
- Bug Fixes
- If user is already authenticated with a username and password,
confluent login
will prompt for new credentials instead of refreshing the existing session
- If user is already authenticated with a username and password,
Confluent CLI v2.13.0 Release Notes¶
- New Features
- Automatically refresh sessions, keeping users logged in while the CLI is in use
- Add
--principal
flag toconfluent kafka acl
commands for filtering by service account or user - Add
--config
,--config-file
, and--schema-id
flags toconfluent kafka topic produce
andconfluent kafka topic consume
- Improve documentation for
confluent kafka topic
,confluent ksql
, andconfluent secret
- Bug Fixes
- Fix typos in various command descriptions
Confluent CLI v2.12.0 Release Notes¶
- New Features
- Let
--kafka-cluster-id
imply--cloud-cluster
inconfluent iam rbac role-binding list
- In
confluent schema-registry describe
optionally print the entire schema graph
- Let
- Bug Fixes
- Add dataplane roles to suggestion message in
iam rbac role describe
- Delete temporary schema directories after producing or consuming
- Remove redundant log messages during API pagination
- Add dataplane roles to suggestion message in
Confluent CLI v2.11.0 Release Notes¶
- New Features
- Add
--full-header
flag toconfluent kafka topic consume
to print untruncated message headers - Add support for source-initiated cluster links in Confluent Cloud
- Add
- Bug Fixes
- Validate
--geo
flag values when creating Schema Registry clusters - Show all available roles with
confluent iam rbac role list
- Fix error message when resizing a Kafka cluster
- Validate
Confluent CLI v2.10.1 Release Notes¶
- Bug Fixes
- Add back
-D
shorthand for--deleted
flag inschema-registry subject describe
- Add back
Confluent CLI v2.10.0 Release Notes¶
- New Features
- New commands for Confluent Cloud:
schema-registry compatibility
andschema-registry config
- New commands for Confluent Platform:
schema-registry compatibility
,schema-registry config
,schema-registry subject
, andschema-registry schema
- New commands for Confluent Cloud:
- Bug Fixes
- Fix bug where locally stored API key could be cleared
- Refresh SSO tokens on auto-login
Confluent CLI v2.9.0 Release Notes¶
- New Features
- Migrated to new APIs that support faster cluster provisioning
- Bug Fixes
- Fixed issue that prevented
HTTPS_PROXY
environment variable from having an effect - Fixed incorrect options for updating Schema Registry subject modes
- Improved error messages and help examples
- Fixed issue that prevented
Confluent CLI v2.8.1 Release Notes¶
- New Features
- Show user email, organization name, and organization ID on login
- Bug Fixes
- Show the correct email when listing API keys for users with dataplane roles
Confluent CLI v2.8.0 Release Notes¶
- New Features
confluent service-quota list
command for Confluent Cloud- Add schema ID field in
confluent schema-registry schema describe
output
- Bug Fixes
- Fix parsing of quoted flag values and arguments in
confluent shell
- Fix parsing of multi-value flags in
confluent shell
- Fix error with protobuf schema references for produce and consume commands
- Fix parsing of quoted flag values and arguments in
Confluent CLI v2.7.0 Release Notes¶
- New Features
- Added
confluent kafka client-config
commands - Improved logging for produce and consume commands, and during SSO login
- Added support for multiline properties in cluster link configuration files
- Added
- Bug Fixes
- Fixed capitalization in human-readable output
Confluent CLI v2.6.2 Release Notes¶
- Bug Fixes
- Encrypt authenticated context and login credentials on local storage
Confluent CLI v2.6.1 Release Notes¶
- New Features
- Improved cipher algorithm used for
secret
command
- Improved cipher algorithm used for
- Bug Fixes
- Fix issue with updating cluster links
Confluent CLI v2.6.0 Release Notes¶
- New Features
- Verify checksums during
confluent update
- Enforce TLS 1.2 or greater
- Added organization ID to login message
- Produce and consume support for Confluent Platform
- Add
kafka link
commands for Confluent Platform
- Verify checksums during
- Bug Fixes
- Allow colons in role binding subject resources
- Improve error when logging in to a suspended org
Confluent CLI v2.5.1 Release Notes¶
- Bug Fixes
- List ACLs created with service account resource IDs in
kafka acl list
- Improve suggestion when API key is not recognized as valid
- List ACLs created with service account resource IDs in
Confluent CLI v2.5.0 Release Notes¶
- Breaking Changes
- Due to backend changes, the
--dry-run
and--no-validate
flags in thekafka link create
commands no longer have an effect. Deprecation notices are added to the flag descriptions.
- Due to backend changes, the
- New Features
- Improved shell completions for
bash
andzsh
- Add
ksql cluster
commands and add deprecation warnings toksql app
commands
- Improved shell completions for
- Bug Fixes
- Fix potential panic in
kafka cluster describe
- Fix potential request failures for users with large number of resources
- Improvements to error and help messages
- Fix potential panic in
Confluent CLI v2.4.0 Release Notes¶
- New Features
- Add support for logging into specific Confluent Cloud organizations
- Update
librdkafka
to 1.8.2 - Don’t show deactivated users (or those with expired invitations) in role binding list command
- Add on-prem replica management commands
- Improved version of
confluent shell
command - Add autocompletion support for remaining command flags (
--api-key
,--context
,--environment
)
- Bug Fixes
- Fix issue where CLI would not show additional information with verbosity flags set (
-v
,-vv
,-vvv
,-vvvv
) - Return error if SSO user enters different emails in CLI prompt and their SSO provider
- Fix regression in
--ca-cert-path
flag so that it uses absolute filepaths - Check whether service account exists before attempting to create or delete a Kafka ACL
- Add friendlier error messages for RBAC commands
- Fix issue where CLI would not show additional information with verbosity flags set (
Confluent CLI v2.3.1 Release Notes¶
- Bug Fixes
- Show the correct error for
confluent api-key list
andconfluent audit-log describe
if audit logs are disabled for an organization
- Show the correct error for
Confluent CLI v2.3.0 Release Notes¶
- New Features
- Expand existing autocompletion functionality to include many command arguments and flags
- Add built-in aliases for several long command names
- Add reference support for JSON and protobuf in schema producer and consumer
- Add
--subject-format
flag toschema-registry exporter
commands - Notify user when ksqlDB cluster provisioning fails
- Add extra validation logic for login URLs
- Warn Confluent Platform users before enabling updates
- Bug Fixes
- Create audit log API keys using the correct service account
- Err if a process is already listening on the SSO callback port
- Fix panic when autocompleting
service-account
commands inconfluent shell
Confluent CLI v2.2.0 Release Notes¶
- New Features
- Properly label “PAUSED” ksqlDB clusters
- Bug Fixes
- Fix Windows failures due to missing
pthreads
library - NOTE: Users of
confluent
v2.0.0, v2.1.0, or v2.1.1 must manually update to this version withcurl -sL https://cnfl.io/cli | sh -s -- -b $(dirname $(which confluent))
- Fix Windows failures due to missing
Confluent CLI v2.1.0 Release Notes¶
- New Features
- Restore partition count field when describing a topic’s configuration
- Show success message when deleting a service account
- Allow
CONFLUENT_PLATFORM_MDS_URL
andCONFLUENT_PLATFORM_CA_CERT_PATH
to be used withconfluent cluster describe
- Bug Fixes
- Fix issue with listing pending user invitations
- Fix issue with logging into SSO-enabled organizations when user is not already logged in
- Only auto-login to the current context
- Update description of
confluent prompt
- Hide
confluent iam acl
commands when logged into a cloud context
Confluent CLI v2.0.0 Release Notes¶
- Breaking Changes
- WARNING: If you are updating from a prior Confluent CLI v1.x client, note that this version is NOT interoperable with Confluent Platform v7.0 or earlier. See Supported Versions and Interoperability for full details on CLI client to Confluent Platform interoperability.
- If you are updating from the Confluent Cloud CLI, the client name will change to
confluent
with this version. - See Migration Guide for a full list of breaking changes and details regarding differences from v1.x.
- New Features
This version of Confluent CLI supports both Confluent Cloud and Confluent Platform management.
To use Confluent CLI v2.0 for Confluent Cloud, sign up with
confluent cloud-signup
or authenticate withconfluent login
.
Confluent CLI v1.43.2 Release Notes¶
- Bug Fixes
- Encrypt authenticated context and login credentials on local storage
Confluent CLI v1.43.1 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.43.0 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.42.0 Release Notes¶
- Bug Fixes
- Fix 404 error in
confluent kafka acl list
- Fix 404 error in
Confluent CLI v1.41.0 Release Notes¶
- New Features
- Add support for managing brokers and partitions
Confluent CLI v1.40.2 Release Notes¶
- Bug Fixes
- Encrypt authenticated context and login credentials on local storage
Confluent CLI v1.40.1 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.40.0 Release Notes¶
- Bug Fixes
- Fix issues when changing directories after logging in with a custom CA cert path
- Make
confluent iam rolebinding list
support filtering by resource - Fix
confluent iam rolebinding list
when no role is specified
Confluent CLI v1.39.1 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.39.0 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.38.0 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.37.1 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.37.0 Release Notes¶
- Bug Fixes
- Improved error messaging and help output
Confluent CLI v1.36.0 Release Notes¶
- Bug Fixes
- Fix the issue of inserting
+
for whitespace iniam rolebinding
parameters
- Fix the issue of inserting
Confluent CLI v1.35.0 Release Notes¶
- New Features
- Performance improvements
- Bug Fixes
- Show all new release notes on CLI update
Confluent CLI v1.34.0 Release Notes¶
- New Features
- Kafka ACL management via Confluent REST Proxy
- Bug Fixes
- Fix logout panic when removing netrc entry
Confluent CLI v1.33.0 Release Notes¶
- New Features
- Remove credentials from
.netrc
file whenlogout
command is run - Move non-interactive login/environment messages to debug-level printouts to
stderr
- Remove credentials from
- Bug Fixes
- Fix supporting custom home directories specified via the
$HOME
environment variable
- Fix supporting custom home directories specified via the
Confluent CLI v1.32.0 Release Notes¶
- Bug Fixes
- Fix
iam acl create
bug for User principals with@
symbol
- Fix
Confluent CLI v1.31.0 Release Notes¶
- New Features
- Increase default number of metadata key iterations from 1000 to 10000
Confluent CLI v1.30.0 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.29.0 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.28.1 Release Notes¶
- Bug Fixes
- Fix bug where update command fails to find some versions
Confluent CLI v1.28.0 Release Notes¶
- New Features
- Improved help text and examples
Confluent CLI v1.27.0 Release Notes¶
- New Features
- Build and release darwin/arm64 binaries and archives
Confluent CLI v1.26.0 Release Notes¶
- New Features
- Topic management commands via Confluent REST Proxy API
- Bug Fixes
- Use
CONFLUENT_MDS_URL
andCONFLUENT_CA_CERT_PATH
for login command when set - Require
--role
flag foriam rolebinding delete
command
- Use
Confluent CLI v1.25.0 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.24.0 Release Notes¶
- New Features
- Non-interactive login
- CONFLUENT_MDS_URL and CONFLUENT_CA_CERT_PATH environment variable support
Confluent CLI v1.23.0 Release Notes¶
- Bug Fixes
- Better handling of
--ca-cert-path
flag for saved logins
- Better handling of
Confluent CLI v1.22.0 Release Notes¶
- New Features
- Stateless mode
- Support self-signed certs for
confluent cluster describe
- Bug Fixes
- Fix
confluent local services start
bug for Centos - Fix no newline bug when auto injected configs are appended to manually added configs for
confluent local
commands
- Fix
Confluent CLI v1.21.1 Release Notes¶
- New Features
- Fix case where wrong ca-cert-path might be used when logging in
Confluent CLI v1.21.0 Release Notes¶
- New Features
--prompt
flag for login command to bypass non-interactive login
- Bug Fixes
- Fix automatic update of auth tokens for username/email with special characters
Confluent CLI v1.20.1 Release Notes¶
- New Features
- Prompt for credentials instead of throwing error when non-interactive login fails
Confluent CLI v1.20.0 Release Notes¶
- New Features
- Verbose HTTP and TLS information is logged (with trace log level) when logging in to the CLI.
- Non-interactive login supported via environment variables
- Binaries and archives are now shipped for Alpine Linux
- Bug Fixes
- Fixed issue where update command may not detect new CLI versions
Confluent CLI v1.19.1 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.19.0 Release Notes¶
- New Features
- Infer default protocol and port number for URLs when logging in
- Bug Fixes
- When using local Kafka sub-commands, only check status of Kafka cluster if it is a locally-running cluster
- Fix flushing of logs and log processing during CLI startup
Confluent CLI v1.18.0 Release Notes¶
- New Features
- Improve warning messages for audit log commands
Confluent CLI v1.17.0 Release Notes¶
- New Features
- Expose context management commands
- Bug Fixes
- Add additional logging when setting custom CA cert path
- Updated list of connectors for CP 6.0
- Fix KSQL path issue for CP verions older than 5.5
- Minor documentation/example fixes
Confluent CLI v1.16.0 Release Notes¶
- New Features
- Add audit log migration commands
- Support piping credentials to login commands
Confluent CLI v1.15.0 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.14.0 Release Notes¶
No changes relating to Confluent CLI for this version.
Confluent CLI v1.13.1 Release Notes¶
- Bug Fixes
- Fix command output bug for commands that were supposed to output to Stdout but were outputting to Stderr
Confluent CLI v1.13.0 Release Notes¶
- New Features
- Allow for pipe-able log output from
confluent local services ... log
.
- Allow for pipe-able log output from
- Bug Fixes
- Fix panic when invalid role is specified during resource-scoped rolebinding commands.
- Fix grammar and typos in command help and examples.
Confluent CLI v1.12.1 Release Notes¶
- Bug Fixes
- Fix success and error message display bug
Confluent CLI v1.12.0 Release Notes¶
- Bug Fixes
- Improve error message handling for audit log commands
- Fix parsing of credentials on Windows for login command
Confluent CLI v1.11.0 Release Notes¶
- New Features
- Rewrite
confluent local
command to use consistent grammar and eliminate need for passing – to subcommands with arguments - Add
confluent cluster
command to register/unregister clusters from a Confluent Cluster Registry instance (Confluent Platform 5.5+) - Update RBAC rolebinding commands to support friendly cluster names
- Add Schema Registry ACLs commands for
confluent local
- Improve error and success messages and add suggestions for commands that don’t succeed
- Rewrite
- Bug Fixes
- Update macOS system requirements for Confluent Platform 6.0
- Fix handling of errors from invalid RBAC rolebinding commands for Confluent Platform 6.0
- Handle errors with loading CLI configuration files and ignore them when configs aren’t needed
- Respect log output/verbosity levels when loading configuration files
- Only check for updates once every 24 hours
Confluent CLI v1.10.0 Release Notes¶
- Bug Fixes
- Compatibility fix for RBAC in Confluent Platform 5.x
Confluent CLI v1.9.0 Release Notes¶
- Bug Fixes
- Restrict feedback nudges to fewer commands
- Skip update check when running the update command
Confluent CLI v1.8.0 Release Notes¶
- New Features
- Update RBAC rolebinding commands to support friendly cluster names (CP 6.0)
- Add
feedback
command so users can give direct in-product feeback - Start publishing release notes with each release
- Bug Fixes
- Fix panics when metadata service returns internal server errors
- Improve command examples in help output