Merge branch 'main' into preview-rc-rdi

Author: cmilesb

assets/css/index.css

@@ -1073,4 +1073,25 @@ a[href*="#no-click"], img[src*="#no-click"] {
 
 .dd-item .highlight:hover {
   color: #5961ff;
+}
+
+.copy-button {
+  background-color: #eee;
+  border: none;
+  padding: 4px;
+  cursor: pointer;
+  border-radius: 4px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.copy-button svg {
+  width: 16px;
+  height: 16px;
+  fill: #333;
+}
+
+.copy-button:hover {
+  background-color: #ddd;
 }

config.toml

@@ -55,7 +55,7 @@ rdi_redis_gears_version = "1.2.6"
 rdi_debezium_server_version = "2.3.0.Final"
 rdi_db_types = "cassandra|mysql|oracle|postgresql|sqlserver"
 rdi_cli_latest = "latest"
-rdi_current_version = "v1.6.7"
+rdi_current_version = "1.8.0"
 
 [params.clientsConfig]
 "Python"={quickstartSlug="redis-py"}

content/develop/_index.md

@@ -2,4 +2,44 @@
 title: Develop with Redis
 description: Learn how to develop with Redis
 linkTitle: Develop
+hideListLinks: true
+hideTOC: true
 ---
+
+Get a Redis server running in minutes with a free trial of
+[Redis Cloud]({{< relref "/operate/rc" >}}), or install
+[Redis Open Source]({{< relref "/operate/oss_and_stack" >}}) locally
+on your machine. Then, explore Redis with your favorite
+[programming language]({{< relref "/develop/clients" >}})
+or analyze and manage your database with our
+[UI tools]({{< relref "/develop/tools" >}}):
+
+| | Get started | Document search | Vector search |
+|:----- | :-----: | :-----: | :-----:|
+| [Python]({{< relref "/develop/clients/redis-py" >}}) | [See Python examples]({{< relref "/develop/clients/redis-py/connect" >}}) | [See Python examples]({{< relref "/develop/clients/redis-py/queryjson" >}}) | [See Python examples]({{< relref "/develop/clients/redis-py/vecsearch" >}}) |
+| [C#/.NET]({{< relref "/develop/clients/dotnet" >}}) | [See C# examples]({{< relref "/develop/clients/dotnet/connect" >}}) | [See C# examples]({{< relref "/develop/clients/dotnet/queryjson" >}}) | [See C# examples]({{< relref "/develop/clients/dotnet/vecsearch" >}}) |
+| [Node.js]({{< relref "/develop/clients/nodejs" >}}) | [See JS examples]({{< relref "/develop/clients/nodejs/connect" >}}) | [See JS examples]({{< relref "/develop/clients/nodejs/queryjson" >}}) | [See JS examples]({{< relref "/develop/clients/nodejs/vecsearch" >}}) |
+| [Java]({{< relref "/develop/clients/jedis" >}}) | [See Java examples]({{< relref "/develop/clients/jedis/connect" >}}) | [See Java examples]({{< relref "/develop/clients/jedis/queryjson" >}}) | [See Java examples]({{< relref "/develop/clients/jedis/vecsearch" >}}) |
+| [Go]({{< relref "/develop/clients/go" >}}) | [See Go examples]({{< relref "/develop/clients/go/connect" >}}) | [See Go examples]({{< relref "/develop/clients/go/queryjson" >}}) | [See Go examples]({{< relref "/develop/clients/go/vecsearch" >}}) |
+| [PHP]({{< relref "/develop/clients/php" >}}) | [See PHP examples]({{< relref "/develop/clients/php/connect" >}}) | [See PHP examples]({{< relref "/develop/clients/php/queryjson" >}}) | [See PHP examples]({{< relref "/develop/clients/php/vecsearch" >}}) |
+
+<div class="flex flex-col gap-5">
+  <div class="flex items-start">
+    {{< image filename="develop/tools/insight/images/Browser.png" class="w-[300px] mr-4" >}}
+    <div>
+      <h3><a href='{{< relref "/develop/tools/insight">}}'>Redis Insight</a></h3>
+      <p>Visual client tool for creating, managing, and analyzing Redis databases.</p>
+    </div>
+  </div>
+  <div class="flex items-start">
+    {{< image filename="images/dev/connect/vscode/vscode-cli.png" class="w-[300px] mr-4" >}}
+    <div>
+      <h3><a href='{{< relref "/develop/tools/redis-for-vscode" >}}'>Redis for VS Code</a></h3>
+      <p>Visual client tool for creating, managing, and analyzing Redis databases.</p>
+    </div>
+  </div>
+</div>
+
+| {{< image filename="images/icon_logo/icon-developers-32-midnight.png" >}} </br>[**Quick start**]({{< relref "/develop/get-started" >}}) | {{< image filename="images/icon_logo/icon-data-structures-32-midnight.png" >}} </br>[**Data types**]({{< relref "/develop/data-types" >}}) | {{< image filename="images/icon_logo/icon-text-search-32-midnight.png" >}} </br>[**Query engine**]({{< relref "/develop/interact/search-and-query" >}}) |
+|---|---|---|
+| [Vector database]({{< relref "/develop/get-started/vector-database" >}})</br>[Document store]({{< relref "/develop/get-started/document-database" >}})</br>[Data structure store]({{< relref "/develop/get-started/data-store" >}})</br>[RAG with Redis]({{< relref "/develop/get-started/rag" >}})</br>[GenAI]({{< relref "/develop/get-started/redis-in-ai" >}}) | [String]({{< relref "/develop/data-types/strings" >}})</br>[JSON]({{< relref "/develop/data-types/json" >}})</br>[Hash]({{< relref "/develop/data-types/hashes" >}})</br>[Vector set]({{< relref "/develop/data-types/vector-sets" >}})</br>[Probabilistic types]({{< relref "/develop/data-types/probabilistic" >}}) | [Get started]({{< relref "/develop/interact/search-and-query" >}})</br>[Schema field types]({{< relref "/develop/interact/search-and-query/basic-constructs/field-and-type-options" >}})</br>[Indexing]({{< relref "/develop/interact/search-and-query/indexing" >}})</br>[Querying]({{< relref "/develop/interact/search-and-query/query" >}})</br>[Use cases]({{< relref "/develop/interact/search-and-query/query-use-cases" >}})

content/develop/ai/index.md renamed to content/develop/ai/_index.md

@@ -0,0 +1,70 @@
+---
+categories:
+- docs
+- develop
+- stack
+- oss
+- rs
+- rc
+- oss
+- kubernetes
+- clients
+description: Get your `go-redis` app ready for production
+linkTitle: Production usage
+title: Production usage
+weight: 6
+---
+
+This guide offers recommendations to get the best reliability and
+performance in your production environment.
+
+## Checklist
+
+Each item in the checklist below links to the section
+for a recommendation. Use the checklist icons to record your
+progress in implementing the recommendations.
+
+{{< checklist "goprodlist" >}}
+    {{< checklist-item "#health-checks" >}}Health checks{{< /checklist-item >}}
+    {{< checklist-item "#error-handling" >}}Error handling{{< /checklist-item >}}
+    {{< checklist-item "#monitor-performance-and-errors">}}Monitor performance and errors{{< /checklist-item >}}
+{{< /checklist >}}
+
+## Recommendations
+
+The sections below offer recommendations for your production environment. Some
+of them may not apply to your particular use case.
+
+### Health checks
+
+If your code doesn't access the Redis server continuously then it
+might be useful to make a "health check" periodically (perhaps once
+every few seconds). You can do this using a simple
+[`PING`]({{< relref "/commands/ping" >}}) command:
+
+```go
+err := rdb.Ping(ctx).Err()
+
+if err != nil {
+  // Report failed health check.
+}
+```
+
+Health checks help to detect problems as soon as possible without
+waiting for a user to report them.
+
+### Error handling
+
+The `Result()` method of a command returns both the command result
+and an error value. Although you are mainly interested in the result,
+you should also always check that the error value is `nil` before
+proceeding. Errors can be returned for failed connections, network
+problems, and invalid command parameters, among other things.
+
+### Monitor performance and errors
+
+`go-redis` supports [OpenTelemetry](https://opentelemetry.io/). This lets
+you trace command execution and monitor your server's performance.
+You can use this information to detect problems before they are reported
+by users. See [Observability]({{< relref "/develop/clients/go#observability" >}})
+for more information.

content/develop/clients/go/produsage.md

@@ -0,0 +1,203 @@
+---
+categories:
+- docs
+- develop
+- stack
+- oss
+- rs
+- rc
+- oss
+- kubernetes
+- clients
+description: Learn how to authenticate to an Azure Managed Redis (AMR) database
+linkTitle: Connect to AMR
+title: Connect to Azure Managed Redis
+weight: 2
+---
+
+The [`redis-authx-entraid`](https://github.com/redis/jvm-redis-authx-entraid) package
+lets you authenticate your app to
+[Azure Managed Redis (AMR)](https://azure.microsoft.com/en-us/products/managed-redis)
+using [Microsoft Entra ID](https://learn.microsoft.com/en-us/entra/identity/).
+You can authenticate using a system-assigned or user-assigned
+[managed identity](https://learn.microsoft.com/en-us/entra/identity/managed-identities-azure-resources/overview)
+or a [service principal](https://learn.microsoft.com/en-us/entra/identity-platform/app-objects-and-service-principals),
+letting `redis-authx-entraid` fetch and renew the authentication tokens for you automatically.
+
+See
+[Use Microsoft Entra for cache authentication](https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-azure-active-directory-for-authentication)
+in the Microsoft docs to learn how to configure Azure to use Entra ID authentication.
+
+## Install
+
+Install [`jedis`]({{< relref "/develop/clients/jedis" >}}) first,
+if you have not already done so.
+
+If you are using Maven, add
+the following dependency to your `pom.xml` file:
+
+```xml
+<dependency>
+    <groupId>redis.clients.authentication</groupId>
+    <artifactId>redis-authx-entraid</artifactId>
+    <version>0.1.1-beta1</version>
+</dependency>
+```
+
+If you are using Gradle, add the following dependency to your
+`build.gradle` file:
+
+```bash
+implementation 'redis.clients.authentication:redis-authx-entraid:0.1.1-beta1'
+```
+
+## Create a `TokenAuthConfig` instance
+
+The `TokenAuthConfig` class contains the authentication details that you
+must supply when you connect to Redis. Chain the methods of the
+`EntraIDTokenAuthConfigBuilder` class together (starting with the `builder()`
+method) to include the details you need, as shown in the following example:
+
+```java
+TokenAuthConfig authConfig = EntraIDTokenAuthConfigBuilder.builder()
+        .secret("<secret>")
+        .authority("<authority>")
+        // Other options...
+        .build();
+```
+
+Some of the details you can supply are common to different use cases:
+
+-   `secret()`: A string containing the [authentication secret](https://learn.microsoft.com/en-us/purview/sit-defn-azure-ad-client-secret).
+-   `authority()`: A string containing the [authority](https://learn.microsoft.com/en-us/entra/identity-platform/msal-client-application-configuration#authority)
+    URL.
+-   `scopes()`: A set of strings defining the [scopes](https://learn.microsoft.com/en-us/entra/identity-platform/scopes-oidc)
+    you want to apply. Configure your client application to acquire a Microsoft Entra token for scope, `https://redis.azure.com/.default` or `acca5fbb-b7e4-4009-81f1-37e38fd66d78/.default` (as detailed at [Microsoft Entra ID for authentication](https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/managed-redis/managed-redis-entra-for-authentication#microsoft-entra-client-workflow)) 
+    with the
+    [Microsoft Authentication Library (MSAL)](https://learn.microsoft.com/en-us/entra/identity-platform/msal-overview)
+
+(See [Advanced configuration options](#advanced-configuration-options) below
+to learn more about the options for controlling token request retry and timeout
+behavior.)
+
+You can also add configuration to authenticate with a [service principal](#serv-principal)
+or a [managed identity](#mgd-identity) as described in the sections below.
+
+### Configuration for a service principal {#serv-principal}
+
+Add `clientId()` to the `EntraIDTokenAuthConfigBuilder` chain to specify
+authentication via a service principal, passing the ID token string as
+a parameter. (See the
+[Microsoft EntraID docs](https://learn.microsoft.com/en-us/entra/identity-platform/app-objects-and-service-principals)
+for more information about service principals.)
+
+```java
+TokenAuthConfig authConfig = EntraIDTokenAuthConfigBuilder.builder()
+        .clientId("<CLIENT-ID>")
+         // ...
+        .build();
+```
+
+### Configuration for a managed identity {#mgd-identity}
+
+You can also authenticate to AMR using a managed identity (see the
+[Microsoft documentation](https://learn.microsoft.com/en-us/entra/identity/managed-identities-azure-resources/overview) to learn more about managed identities).
+
+For a system assigned managed identity, simply add the `systemAssignedManagedIdentity()`
+method to the `EntraIDTokenAuthConfigBuilder` chain:
+
+```java
+TokenAuthConfig authConfig = EntraIDTokenAuthConfigBuilder.builder()
+        .systemAssignedManagedIdentity()
+         // ...
+        .build();
+```
+
+For a user assigned managed identity, add `userAssignedManagedIdentity()`. This
+requires a member of the `UserManagedIdentityType` enum (to select a
+`CLIENT_ID`, `OBJECT_ID`, or `RESOURCE_ID`) as well as the `id` string itself:
+
+```java
+TokenAuthConfig authConfig = EntraIDTokenAuthConfigBuilder.builder()
+        .userAssignedManagedIdentity(
+            UserManagedIdentityType.CLIENT_ID,
+            "<ID>"
+        )
+         // ...
+        .build();
+
+```
+
+## Connect using `DefaultJedisClientConfig`
+
+When you have created your `TokenAuthConfig` instance, you are ready to
+connect to AMR.
+The example below shows how to include the `TokenAuthConfig` details in a
+`JedisClientConfig` instance and use it with the `UnifiedJedis` connection.
+The connection uses
+[Transport Layer Security (TLS)](https://en.wikipedia.org/wiki/Transport_Layer_Security),
+which is recommended and enabled by default for managed identities. See
+[Connect to your production Redis with TLS]({{< relref "/develop/clients/jedis/connect#connect-to-your-production-redis-with-tls" >}}) for more information about
+TLS connections, including the implementation of the `createSslSocketFactory()`
+method used in the example.
+
+```java
+TokenAuthConfig authConfig = EntraIDTokenAuthConfigBuilder.builder()
+        // Chain of options...
+        .build();
+
+SSLSocketFactory sslFactory = createSslSocketFactory(
+        "./truststore.jks",
+        "secret!", // Use the password you specified for `keytool`
+        "./redis-user-keystore.p12",
+        "secret!" // Use the password you specified for `openssl`
+);
+
+JedisClientConfig config = DefaultJedisClientConfig.builder()
+        // Include the `TokenAuthConfig` details.
+        .authXManager(new AuthXManager(authConfig))
+        .ssl(true).sslSocketFactory(sslFactory)
+        .build();
+
+UnifiedJedis jedis = new UnifiedJedis(
+    new HostAndPort("<host>", <port>),
+    config
+);
+
+// Test the connection.
+System.out.println(String.format("Database size is %d", jedis.dbSize()));
+```
+
+## Advanced configuration options
+
+The `TokenAuthConfig` class has several other options that you can
+set with the `EntraIDTokenAuthConfigBuilder.builder()`. These give you
+more precise control over the way the token is renewed:
+
+```java
+TokenAuthConfig authConfig = EntraIDTokenAuthConfigBuilder.builder()
+        .expirationRefreshRatio(0.75)
+        .lowerRefreshBoundMillis(100)
+        .tokenRequestExecTimeoutInMs(100)
+        .maxAttemptsToRetry(10)
+        .delayInMsToRetry()
+         // ...
+        .build();
+```
+
+These options are explained below:
+
+-  `expirationRefreshRatio`: a `float` value representing the fraction
+   of a token's lifetime that should elapse before attempting to
+   refresh it. For example, a value of 0.75 means that you want to
+   refresh the token after 75% of its lifetime has passed.
+-  `lowerRefreshBoundMillis`: the minimum amount of the token's lifetime
+   (in milliseconds) remaining before attempting to refresh, regardless
+   of the `expirationRefreshRatio` value. Set this to zero if you want
+   the refresh time to depend only on `expirationRefreshRatio`.
+-  `tokenRequestExecTimeoutInMs`: the maximum time (in milliseconds) to
+   wait for a token request to receive a response. A timeout occurs if this limit is exceeded.
+-  `maxAttemptsToRetry`: the maximum number of times to retry a token
+   request before aborting.
+-  `delayInMsToRetry`: the time (in milliseconds) to wait before
+    retrying a token request after a failed attempt. This provides a mechanism to request throttling to prevent an excessive number of token requests.