Skip to content

v2.6.0

Choose a tag to compare

@jamesx-improving jamesx-improving released this 10 Nov 23:53
· 63 commits to main since this release
c906cb0

Key Features

Connection Pooling (Preview): Introduced client-instance pooling (ClientPool) and isolated execution scopes for Java, Python, Node.js, and Go, backed by a single shared Rust implementation in glide-core. Pools eliminate multiplexer contention under high concurrency, while scopes provide dedicated connections for WATCH/MULTI/EXEC and CLIENT TRACKING. Connection state is reset when a client is returned to the pool, scopes inherit the parent client's database, credentials, and compression settings, and abandon detection reclaims leaked borrows after a configurable timeout. This feature is released as a preview: APIs and behavior may change in future releases, and we welcome feedback.

Experimental RDMA Support for Python: Added opt-in RDMA (Remote Direct Memory Access) to the Python sync client through RdmaConfiguration, with register_rdma_region, rdma_get, and rdma_set APIs. RDMA is built on the new glide-rdma crate, a transfer layer over libfabric loaded at runtime, and is exposed through glide-core and the FFI layer.

Valkey 9.x Command Support: Added new commands and options for Java, Python, Node.js, and Go:

  • Valkey 9.0: DELIFEQ for atomic compare-and-delete
  • Valkey 9.1: HGETDEL, key-level NX/XX conditions for HSETEX, and the cluster_info INFO section
  • Valkey 9.2: XX option for SISMEMBER, and IFNE option for SET

Node.js Native Binding Layer: The Node.js client now calls the Rust core through a direct NAPI layer instead of exchanging requests and responses with it over a Unix domain socket.

Client-Side Caching for MGET: Fully cached MGET requests are served locally, and partially cached requests fetch only the missing keys, preserving duplicate-key and nil semantics.

mTLS Client Certificates with Automatic Reloading: Added mutual TLS client certificate and private key support with automatic certificate reloading to Java, Node.js, and Go. Python, which already accepted in-memory PEM client certificates, adds file-based client certificates (client_cert_path / client_key_path) with the same automatic reloading. Java can also load the client identity from a keystore via useMutualTlsFromKeyStore.

AZ Affinity All Nodes Read Strategy: Added the AZ_AFFINITY_ALL_NODES read strategy to Go and Node.js, which is already available in Java and Python since 2.5.3. Reads are served by any node in the client's availability zone, both primaries and replicas.

Custom IAM Credential Providers: Added GlideCredentialProvider support to IamAuthConfig in Java, Python, Node.js, and Go, letting applications supply custom IAM credential sources instead of the default AWS credential chain.

Python OpenTelemetry Enhancements: Optional propagation of the active OpenTelemetry parent span to command, batch and script spans (enable_trace_context_propagation=True, off by default), and spans for script invocations (EVALSHA).

Python Unix Domain Socket Support: Python standalone clients (async and sync) can connect over a Unix domain socket with NodeAddress(unix_socket_path=...). TLS and cluster mode aren't supported over Unix domain sockets.

Zero-Copy Reads: Added a zero-copy receive path for GET/MGET in glide-core, zero-copy MGET buffers in the Python sync client, and GlideString.asReadOnlyByteBuffer() in Java for read-only access to binary payloads.

Jedis 4 Compatibility for Java: A new valkey-glide-jedis-4-compatibility artifact lets applications written against the Jedis 4.x API run on GLIDE, alongside the existing Jedis compatibility layer.

Core Performance: Lower per-command overhead on the core hot path (+12–16% cluster throughput in the change's benchmarks) and vectored, zero-copy sends for large command arguments.

Go Inflight Requests Limit: Exposed inflightRequestsLimit via WithInflightRequestsLimit, bringing the Go client to parity with Java, Python, and Node.js.

Improved Core Reliability: A circular MOVED (a node redirecting to its own endpoint, e.g. an old primary kept alive behind the same hostname after a failover) now replaces the stale connection instead of reusing it.

The Rust client (valkey-glide crate, preview) is versioned and released separately under rust/v* tags, so its changes aren't listed here.

New Requirements

  • Node.js: requires Node.js 20 or later (was 16).

Known Issues

  • Go on Alpine Linux (musl): creating a TLS cluster client crashes with SIGSEGV. The TLS cluster connect needs more stack than musl gives Go's threads by default. Workaround: build with CGO_LDFLAGS="-Wl,-z,stack-size=8388608" (or go build -ldflags="-extldflags=-Wl,-z,stack-size=8388608"). Standalone, non-TLS, and glibc/macOS builds are not affected. Tracked in #7637.

What's Changed

The curated, user-facing list of every change in this release is in CHANGELOG.md. Pull requests are grouped below by binding; expand a section to see them.

Core and cross-binding (67)
  • feat: cross-language client pool and isolated execution scopes by @jduo in #6338
  • feat(core/java): mTLS configuration with client cert reload by @xShinnRyuu in #6386
  • perf(glide-core): reduce per-command hot-path overhead (+12–16% cluster throughput) by @omerrubi-amzn in #6399
  • fix(core): enforce RESP3 recursion-depth guard for all aggregate types by @xShinnRyuu in #6477
  • feat(ffi): add command_with_route_info entrypoint by @Aryex in #6494
  • perf(core): vectored zero-copy send for large command args by @omerrubi-amzn in #6523
  • fix(ffi): prevent pub/sub DoS from malformed server push frames by @xShinnRyuu in #6530
  • fix(ffi): forward Disconnection push notifications past the malformed-frame guard by @xShinnRyuu in #6543
  • Fix native panic for setex psetex and setnx commands by @Sasidharan3094 in #6551
  • perf(core): zero-copy receive path for GET/MGET by @omerrubi-amzn in #6559
  • feat(core): buffer pending requests during cluster reconnect with bounded recovery queue by @affonsov in #6640
  • feat: add abandon detection for pool-borrowed clients by @jeremyprime in #6642
  • FFI: Percent-decode userinfo in create_client_from_uri by @jamesx-improving in #6660
  • fix: bound mTLS cert reload interval and align Node field names across SDKs by @xShinnRyuu in #6678
  • fix(core, go): use uint32 for Go BackoffStrategy fields and harden reconnect RetryStrategy against out-of-range values by @xShinnRyuu in #6680
  • feat(glide-core): route CLIENT KILL to all nodes by @currantw in #6709
  • fix(ffi): handle IPv6 address literals in create_client_from_uri by @Aryex in #6714
  • fix: make TimeoutWatchdog singleton fork-safe by @jeremyprime in #6716
  • feat: Add clientInfoTag and libName to Java, Node, Go and Python clients by @Jonathan-Improving in #6755
  • fix(core): mark PSUBSCRIBE and PUNSUBSCRIBE as read only command by @arthur-jaumet-wmx in #6756
  • fix(core): retry empty-receivers multi-node fan-out under topology churn by @xShinnRyuu in #6768
  • fix(core): buffer pending requests for all recovery paths by @affonsov in #6770
  • fix(core): resolve cluster redirect addresses by @stevenzengg in #6788
  • feat(core): add MGET client-side caching by @ajzach in #6807
  • fix(core): allow the large reconnect Err variant to satisfy clippy by @xShinnRyuu in #6813
  • fix(core): Validate client library names by @nderraugh in #6891
  • fix(pool): eliminate abandon monitor race for blocking commands (#6971) by @affonsov in #7063
  • fix(core): honor blocking-command timeouts and discard poisoned scoped connections by @jeremyprime in #6978
  • fix(core): stop MONITOR and PubSub streams from dropping buffered handshake bytes by @xShinnRyuu in #6979
  • fix(core): authenticate scoped connections as the IAM identity by @jeremyprime in #7022
  • fix(core): accept max_total concurrent scopes, not max_total - 1 by @jeremyprime in #7030
  • fix(core): add credentials_provider to IAM test call sites by @jeremyprime in #7047
  • fix(core): Treat scope slot zero as concrete by @nderraugh in #7054
  • feat: add GlideCredentialProvider (custom IAM credentials) to Node.js, Python, Go + async support for Java by @affonsov in #7055
  • fix(core): scoped commands require a live parent client by @jeremyprime in #7062
  • fix(core): reset CLIENT SETNAME on scope release by @jeremyprime in #7094
  • fix(core): reused scoped connections keep the parent's runtime database by @jeremyprime in #7113
  • fix(core): reclaim scope-pool reservations on cancel and dedupe scope creation retries per acquire by @jeremyprime in #7120
  • fix(ffi): wait for the pool lock in glide_pool_metrics instead of reporting zeros by @xShinnRyuu in #7130
  • fix(core): re-authenticate pool-borrowed clients with a rotated IAM token on borrow by @jeremyprime in #7155
  • fix(core): build scoped connections without a redis:// URL round-trip by @jeremyprime in #7172
  • feat(rdma): add glide-rdma crate for later RDMA support by @anitarua in #7177
  • fix(ffi): preserve username-only userinfo in create_client_from_uri by @Aryex in #7193
  • fix(core): Report every ClientPool discard to the bindings by @nderraugh in #7256
  • fix(java/go): hash whole key for empty cluster hash tag by @jeremyprime in #7294
  • fix(core): scoped connections inherit parent TLS cert material and address resolver by @jeremyprime in #7296
  • fix(java,node): draw ordinary-client ids from the shared pool allocator by @jeremyprime in #7302
  • fix(core): validate a cluster scope's first command against its acquisition slot by @jeremyprime in #7308
  • feat(core/python): connect to standalone servers over Unix domain sockets by @cody-cheng in #7311
  • fix(core): Move scope acquire wait into glide-core, delete binding poll loops by @nderraugh in #7320
  • feat: add cluster_info INFO section and test Valkey 9.2 INFO fields by @currantw in #7364
  • fix(core): require TLS for IAM auth on ordinary and scoped connections by @jeremyprime in #7397
  • fix(core): reset pooled connection state conditionally and route DISCARD to all cluster nodes by @jeremyprime in #7398
  • feat: add SISMEMBER XX support to Java, Node, Go, and Rust by @currantw in #7404
  • feat(core): integrate glide-rdma into glide-core by @anitarua in #7412
  • fix(core): reserve warmup slots up front to stop pool over-creation by @jeremyprime in #7413
  • fix(core): Scoped connections use the client's current password by @nderraugh in #7419
  • fix(core): replace stale connection on circular MOVED by @jamesx-improving in #7427
  • feat(python,node,go): add key-level NX/XX condition support to HSETEX by @prateek-kumar-improving in #7428
  • fix(core): keep waiting for SpecificNode route connection across superseding refresh (#7434)
  • feat: add SET IFNE support to Java, Node, Go, and Rust by @currantw in #7453
  • feat(ffi): integrate rdma into ffi by @anitarua in #7458
  • fix(core): close scope sockets abandoned under a blocking command by @jeremyprime in #7462
  • fix(core): decompress MGET and batch replies per element by @nderraugh in #7524
  • fix(ffi, python): raise ConfigurationError when the core rejects a connection request by @jamesx-improving in #7535
  • fix(core): decrement standalone total_clients once per client, not per command by @omerrubi-amzn in #7548
  • fix(core): Discard pooled connections that fail release reset by @jeremyprime in #7554
Java (20)
Python (25)
Node.js (12)
Go (11)

New Contributors

Full Changelog: v2.5.3...v2.6.0