From 379fa6cc11afe6c91383175ba833e70d0fcb77d4 Mon Sep 17 00:00:00 2001 From: Fraser Date: Mon, 18 Aug 2025 20:18:01 -0400 Subject: [PATCH 1/7] =?UTF-8?q?Adding=20Kapa=20AI=E2=80=94the=20AI=20power?= =?UTF-8?q?ed=20chatbot=E2=80=94to=20the=20Dapr=20docs.=20(#4773)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: FraserMarlow --- daprdocs/layouts/_partials/hooks/head-end.html | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/daprdocs/layouts/_partials/hooks/head-end.html b/daprdocs/layouts/_partials/hooks/head-end.html index 26e604a4c..dd1ef9f1a 100644 --- a/daprdocs/layouts/_partials/hooks/head-end.html +++ b/daprdocs/layouts/_partials/hooks/head-end.html @@ -1,3 +1,12 @@ {{ with .Site.Params.search.algolia }} + + {{ end }} \ No newline at end of file From 3b1af27e57e209f92813655c374f7b4aabc15bfc Mon Sep 17 00:00:00 2001 From: Whit Waldo Date: Tue, 19 Aug 2025 19:34:35 -0500 Subject: [PATCH 2/7] Fixed bad metadata property in .NET docs (#4764) Signed-off-by: Whit Waldo Co-authored-by: Mark Fussell --- .../building-blocks/pubsub/pubsub-raw.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/daprdocs/content/en/developing-applications/building-blocks/pubsub/pubsub-raw.md b/daprdocs/content/en/developing-applications/building-blocks/pubsub/pubsub-raw.md index 2e093e742..aa2d54299 100644 --- a/daprdocs/content/en/developing-applications/building-blocks/pubsub/pubsub-raw.md +++ b/daprdocs/content/en/developing-applications/building-blocks/pubsub/pubsub-raw.md @@ -111,7 +111,7 @@ Dapr apps can subscribe to raw messages from pub/sub topics, even if they weren ### Programmatically subscribe to raw events -When subscribing programmatically, add the additional metadata entry for `rawPayload` to allow the subscriber to receive a message that is not wrapped by a CloudEvent. For .NET, this metadata entry is called `isRawPayload`. +When subscribing programmatically, add the additional metadata entry for `rawPayload` to allow the subscriber to receive a message that is not wrapped by a CloudEvent. For .NET, this metadata entry is called `rawPayload`. When using raw payloads the message is always base64 encoded with content type `application/octet-stream`. @@ -137,7 +137,7 @@ app.MapGet("/dapr/subscribe", () => route = "/messages", metadata = new Dictionary { - { "isRawPayload", "true" }, + { "rawPayload", "true" }, { "content-type", "application/json" } } } From a4229a71a2e1e358d26e2b36dadda8301bd222c1 Mon Sep 17 00:00:00 2001 From: Fabian Steinbach <63794579+fabistb@users.noreply.github.com> Date: Wed, 20 Aug 2025 05:59:36 +0200 Subject: [PATCH 3/7] enhance OpenAi conversation component documentation for Azure OpenAi (#4750) * enhance OpenAi conversation component documentation for Azure OpenAi Signed-off-by: fabistb * adjust openai conversation api docs Signed-off-by: fabistb * openAi apiVersion to newest preveiew and add link for api version lifecycle Signed-off-by: fabistb --------- Signed-off-by: fabistb Co-authored-by: Mark Fussell --- .../supported-conversation/openai.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/daprdocs/content/en/reference/components-reference/supported-conversation/openai.md b/daprdocs/content/en/reference/components-reference/supported-conversation/openai.md index d2a2745b2..987fa848e 100644 --- a/daprdocs/content/en/reference/components-reference/supported-conversation/openai.md +++ b/daprdocs/content/en/reference/components-reference/supported-conversation/openai.md @@ -25,6 +25,10 @@ spec: value: 'https://api.openai.com/v1' - name: cacheTTL value: 10m + # - name: apiType # Optional + # value: `azure` + # - name: apiVersion # Optional + # value: '2025-01-01-preview' ``` {{% alert title="Warning" color="warning" %}} @@ -37,9 +41,12 @@ The above example uses secrets as plain strings. It is recommended to use a secr |--------------------|:--------:|---------|---------| | `key` | Y | API key for OpenAI. | `mykey` | | `model` | N | The OpenAI LLM to use. Defaults to `gpt-4-turbo`. | `gpt-4-turbo` | -| `endpoint` | N | Custom API endpoint URL for OpenAI API-compatible services. If not specified, the default OpenAI API endpoint is used. | `https://api.openai.com/v1` | +| `endpoint` | N | Custom API endpoint URL for OpenAI API-compatible services. If not specified, the default OpenAI API endpoint is used. Required when `apiType` is set to `azure`. | `https://api.openai.com/v1`, `https://example.openai.azure.com/` | | `cacheTTL` | N | A time-to-live value for a prompt cache to expire. Uses Golang duration format. | `10m` | +| `apiType` | N | Specifies the API provider type. Required when using a provider that does not follow the default OpenAI API endpoint conventions. | `azure` | +| `apiVersion`| N | The API version to use. Required when the `apiType` is set to `azure`. | `2025-04-01-preview` | ## Related links -- [Conversation API overview]({{% ref conversation-overview.md %}}) \ No newline at end of file +- [Conversation API overview]({{% ref conversation-overview.md %}}) +- [Azure OpenAI in Azure AI Foundry Models API lifecycle](https://learn.microsoft.com/azure/ai-foundry/openai/api-version-lifecycle) \ No newline at end of file From 62f1c734d8b461329a5a36db8d0d555d56e3342d Mon Sep 17 00:00:00 2001 From: Whit Waldo Date: Tue, 19 Aug 2025 23:03:35 -0500 Subject: [PATCH 4/7] Fixed several typos locks.redis document, fixed table formatting (#4757) * Fixed several typos in the document, fixed table formatting Signed-off-by: Whit Waldo * Update daprdocs/content/en/reference/components-reference/supported-locks/redis-lock.md Signed-off-by: Mark Fussell --------- Signed-off-by: Whit Waldo Signed-off-by: Mark Fussell Co-authored-by: Mark Fussell --- .../supported-locks/redis-lock.md | 54 +++++++++---------- 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/daprdocs/content/en/reference/components-reference/supported-locks/redis-lock.md b/daprdocs/content/en/reference/components-reference/supported-locks/redis-lock.md index f54ae416b..bc8f88819 100644 --- a/daprdocs/content/en/reference/components-reference/supported-locks/redis-lock.md +++ b/daprdocs/content/en/reference/components-reference/supported-locks/redis-lock.md @@ -75,33 +75,33 @@ The above example uses secrets as plain strings. It is recommended to use a secr ## Spec metadata fields -| Field | Required | Details | Example | -|--------------------|:--------:|---------|---------| -| redisHost | Y | Connection-string for the redis host | `localhost:6379`, `redis-master.default.svc.cluster.local:6379` -| redisPassword | N | Password for Redis host. No Default. Can be `secretKeyRef` to use a secret reference | `""`, `"KeFg23!"` -| redisUsername | N | Username for Redis host. Defaults to empty. Make sure your redis server version is 6 or above, and have created acl rule correctly. | `""`, `"default"` -| useEntraID | N | Implements EntraID support for Azure Cache for Redis. Before enabling this:
  • The `redisHost` name must be specified in the form of `"server:port"`
  • TLS must be enabled
Learn more about this setting under [Create a Redis instance > Azure Cache for Redis]({{% ref "#setup-redis" %}}) | `"true"`, `"false"` | -| enableTLS | N | If the Redis instance supports TLS with public certificates, can be configured to be enabled or disabled. Defaults to `"false"` | `"true"`, `"false"` -| maxRetries | N | Maximum number of retries before giving up. Defaults to `3` | `5`, `10` -| maxRetryBackoff | N | Maximum backoff between each retry. Defaults to `2` seconds; `"-1"` disables backoff. | `3000000000` -| failover | N | Property to enable failover configuration. Needs sentinelMasterName to be set. The redisHost should be the sentinel host address. See [Redis Sentinel Documentation](https://redis.io/docs/manual/sentinel/). Defaults to `"false"` | `"true"`, `"false"` -| sentinelMasterName | N | The sentinel master name. See [Redis Sentinel Documentation](https://redis.io/docs/manual/sentinel/) | `"mymaster"` -| redeliverInterval | N | The interval between checking for pending messages to redelivery. Defaults to `"60s"`. `"0"` disables redelivery. | `"30s"` -| processingTimeout | N | The amount time a message must be pending before attempting to redeliver it. Defaults to `"15s"`. `"0"` disables redelivery. | `"30s"` -| redisType | N | The type of redis. There are two valid values, one is `"node"` for single node mode, the other is `"cluster"` for redis cluster mode. Defaults to `"node"`. | `"cluster"` -| redisDB | N | Database selected after connecting to redis. If `"redisType"` is `"cluster"` this option is ignored. Defaults to `"0"`. | `"0"` -| redisMaxRetries | N | Alias for `maxRetries`. If both values are set `maxRetries` is ignored. | `"5"` -| redisMinRetryInterval | N | Minimum backoff for redis commands between each retry. Default is `"8ms"`; `"-1"` disables backoff. | `"8ms"` -| redisMaxRetryInterval | N | Alias for `maxRetryBackoff`. If both values are set `maxRetryBackoff` is ignored. | `"5s"` -| dialTimeout | N | Dial timeout for establishing new connections. Defaults to `"5s"`. | `"5s"` -| readTimeout | N | Timeout for socket reads. If reached, redis commands will fail with a timeout instead of blocking. Defaults to `"3s"`, `"-1"` for no timeout. | `"3s"` -| writeTimeout | N | Timeout for socket writes. If reached, redis commands will fail with a timeout instead of blocking. Defaults is readTimeout. | `"3s"` -| poolSize | N | Maximum number of socket connections. Default is 10 connections per every CPU as reported by runtime.NumCPU. | `"20"` -| poolTimeout | N | Amount of time client waits for a connection if all connections are busy before returning an error. Default is readTimeout + 1 second. | `"5s"` -| maxConnAge | N | Connection age at which the client retires (closes) the connection. Default is to not close aged connections. | `"30m"` -| minIdleConns | N | Minimum number of idle connections to keep open in order to avoid the performance degradation associated with creating new connections. Defaults to `"0"`. | `"2"` -| idleCheckFrequency | N | Frequency of idle checks made by idle connections reaper. Default is `"1m"`. `"-1"` disables idle connections reaper. | `"-1"` -| idleTimeout | N | Amount of time after which the client closes idle connections. Should be less than server's timeout. Default is `"5m"`. `"-1"` disables idle timeout check. | `"10m"` +| Field | Required | Details | Example | +|-----------------------|:--------:|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------| +| redisHost | Y | Connection string for the redis host | `localhost:6379`, `redis-master.default.svc.cluster.local:6379` | +| redisPassword | N | Password for Redis host. No Default. Can be `secretKeyRef` to use a secret reference | `""`, `"KeFg23!"` | +| redisUsername | N | Username for Redis host. Defaults to empty. Make sure your redis server version is 6 or above, and have created acl rule correctly. | `""`, `"default"` | +| useEntraID | N | Implements EntraID support for Azure Cache for Redis. Before enabling this:
  • The `redisHost` name must be specified in the form of `"server:port"`
  • TLS must be enabled
Learn more about this setting under [Create a Redis instance > Azure Cache for Redis]({{% ref "#setup-redis" %}}) | `"true"`, `"false"` | +| enableTLS | N | If the Redis instance supports TLS with public certificates, can be configured to be enabled or disabled. Defaults to `"false"` | `"true"`, `"false"` | +| maxRetries | N | Maximum number of retries before giving up. Defaults to `3` | `5`, `10` | +| maxRetryBackoff | N | Maximum backoff between each retry. Defaults to `2` seconds; `"-1"` disables backoff. | `3000000000` | +| failover | N | Enable failover configuration. Needs sentinelMasterName to be set. The redisHost should be the sentinel host address. See [Redis Sentinel Documentation](https://redis.io/docs/manual/sentinel/). Defaults to `"false"` | `"true"`, `"false"` | +| sentinelMasterName | N | The sentinel master name. See [Redis Sentinel Documentation](https://redis.io/docs/manual/sentinel/) | `"mymaster"` | +| redeliverInterval | N | The interval between checking for pending messages for redelivery. Defaults to `"60s"`. `"0"` disables redelivery. | `"30s"` | +| processingTimeout | N | The amount of time a message must be pending before attempting to redeliver it. Defaults to `"15s"`. `"0"` disables redelivery. | `"30s"` | +| redisType | N | The type of redis. There are two valid values, one is `"node"` for single node mode, the other is `"cluster"` for redis cluster mode. Defaults to `"node"`. | `"cluster"` | +| redisDB | N | Database selected after connecting to redis. If `"redisType"` is `"cluster"` this option is ignored. Defaults to `"0"`. | `"0"` | +| redisMaxRetries | N | Alias for `maxRetries`. If both values are set `maxRetries` is ignored. | `"5"` | +| redisMinRetryInterval | N | Minimum backoff for redis commands between each retry. Default is `"8ms"`; `"-1"` disables backoff. | `"8ms"` | +| redisMaxRetryInterval | N | Alias for `maxRetryBackoff`. If both values are set `maxRetryBackoff` is ignored. | `"5s"` | +| dialTimeout | N | Dial timeout for establishing new connections. Defaults to `"5s"`. | `"5s"` | +| readTimeout | N | Timeout for socket reads. If reached, redis commands will fail with a timeout instead of blocking. Defaults to `"3s"`, `"-1"` for no timeout. | `"3s"` | +| writeTimeout | N | Timeout for socket writes. If reached, redis commands will fail with a timeout instead of blocking. Defaults is readTimeout. | `"3s"` | +| poolSize | N | Maximum number of socket connections. Default is 10 connections per every CPU as reported by runtime (NumCPU) | `"20" | +| poolTimeout | N | Amount of time client waits for a connection if all connections are busy before returning an error. Default is readTimeout + 1 second. | `"5s"` | +| maxConnAge | N | Connection age at which the client retires (closes) the connection. Default is to not close aged connections. | `"30m"` | +| minIdleConns | N | Minimum number of idle connections to keep open in order to avoid the performance degradation associated with creating new connections. Defaults to `"0"`. | `"2"` | +| idleCheckFrequency | N | Frequency of idle checks made by idle connections reaper. Default is `"1m"`. `"-1"` disables idle connections reaper. | `"-1"` | +| idleTimeout | N | Amount of time after which the client closes idle connections. Should be less than server's timeout. Default is `"5m"`. `"-1"` disables idle timeout check. | `"10m"` | ## Setup Redis From be3d3f695da9d901f023c4d0c776c105094dffad Mon Sep 17 00:00:00 2001 From: Sam Date: Tue, 19 Aug 2025 23:14:25 -0500 Subject: [PATCH 5/7] fix: aws sso docs (#4768) * fix(docs): update aws sso info Signed-off-by: Samantha Coyle * fix: rm aws helper tabs Signed-off-by: Samantha Coyle --------- Signed-off-by: Samantha Coyle Co-authored-by: Mark Fussell --- .../integrations/AWS/authenticating-aws.md | 30 ++----------------- 1 file changed, 2 insertions(+), 28 deletions(-) diff --git a/daprdocs/content/en/developing-applications/integrations/AWS/authenticating-aws.md b/daprdocs/content/en/developing-applications/integrations/AWS/authenticating-aws.md index 26f065ae3..e8a6d58a8 100644 --- a/daprdocs/content/en/developing-applications/integrations/AWS/authenticating-aws.md +++ b/daprdocs/content/en/developing-applications/integrations/AWS/authenticating-aws.md @@ -138,35 +138,9 @@ On Windows, the environment variable needs to be set before starting the `dapr` ### Authenticate to AWS if using AWS SSO based profiles -If you authenticate to AWS using [AWS SSO](https://aws.amazon.com/single-sign-on/), some AWS SDKs (including the Go SDK) don't yet support this natively. There are several utilities you can use to "bridge the gap" between AWS SSO-based credentials and "legacy" credentials, such as: -- [AwsHelper](https://pypi.org/project/awshelper/) -- [aws-sso-util](https://github.com/benkehoe/aws-sso-util) +If you authenticate to AWS using [AWS SSO](https://aws.amazon.com/single-sign-on/), the AWS SDK for Go (both v1 and v2) provides native support for AWS SSO credential providers. This means you can use AWS SSO profiles directly without additional utilities. -{{< tabpane text=true >}} - -{{% tab "Linux/MacOS" %}} - -If using AwsHelper, start Dapr like this: - -```bash -AWS_PROFILE=myprofile awshelper dapr run... -``` - -or - -```bash -AWS_PROFILE=myprofile awshelper daprd... -``` -{{% /tab %}} - - -{{% tab "Windows" %}} - -On Windows, the environment variable needs to be set before starting the `awshelper` command; doing it inline (like in Linux/MacOS) is not supported. - -{{% /tab %}} - -{{< /tabpane >}} +For more information about AWS SSO support in the AWS SDK for Go, see the [AWS blog post](https://aws.amazon.com/blogs/developer/aws-sso-support-in-the-aws-sdk-for-go/). ## Next steps From f4603c3aeaa4de2df66551ae22b17fbfcd60f830 Mon Sep 17 00:00:00 2001 From: Marc Duiker Date: Wed, 20 Aug 2025 16:35:05 +0200 Subject: [PATCH 6/7] Update kapa config (#4791) Signed-off-by: Marc Duiker --- daprdocs/layouts/_partials/hooks/head-end.html | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/daprdocs/layouts/_partials/hooks/head-end.html b/daprdocs/layouts/_partials/hooks/head-end.html index dd1ef9f1a..a86318b48 100644 --- a/daprdocs/layouts/_partials/hooks/head-end.html +++ b/daprdocs/layouts/_partials/hooks/head-end.html @@ -5,8 +5,21 @@ async src="https://widget.kapa.ai/kapa-widget.bundle.js" data-website-id="8e5bac24-7723-4b77-9b1b-99d6e058a864" - data-project-name="dapr-docs" - data-project-color="#0D2192" + data-project-name="Dapr Docs AI" + data-modal-title="Dapr Docs AI assistant" + data-project-color="#ff4e00" data-project-logo="https://cdn.prod.website-files.com/66965adecd57031ed9ad181e/689f979646c1922bbc244a8b_dapr-ai-icon-transparent.png" + data-modal-open-by-default="false" + data-modal-disclaimer="Answers are based on the Dapr docs, relevant websites, and GitHub repositories. Always double check the results and please provide feedback with a 👍 or 👎 so we continue to improve this service." + data-modal-example-questions="How do I get started with Dapr?, How do I use Kafka with Dapr Pub/Sub?, How do I run Dapr in production?, How do I build agentic AI with Dapr?" + data-modal-example-questions-title="Try asking:" + data-modal-ask-ai-input-placeholder="Ask me anything Dapr-related..." + data-answer-cta-button-enabled="true" + data-answer-cta-button-link="https://bit.ly/dapr-discord" + data-answer-cta-button-text="Join us on Discord" + data-modal-header-bg-color="#0D2192" + data-modal-title-color="#FFFFFF" + data-modal-image-height="32" + data-modal-image-width="32" > {{ end }} \ No newline at end of file From 0288a24a00317db41754dd2906e4657c05714d7b Mon Sep 17 00:00:00 2001 From: Marc Duiker Date: Wed, 20 Aug 2025 17:35:34 +0200 Subject: [PATCH 7/7] Update SDK docs (#4789) Signed-off-by: Marc Duiker --- sdkdocs/dotnet | 2 +- sdkdocs/go | 2 +- sdkdocs/java | 2 +- sdkdocs/js | 2 +- sdkdocs/python | 2 +- sdkdocs/rust | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/sdkdocs/dotnet b/sdkdocs/dotnet index d15a02340..5afb5a210 160000 --- a/sdkdocs/dotnet +++ b/sdkdocs/dotnet @@ -1 +1 @@ -Subproject commit d15a0234049c6ae0fd9d4e23af1fc0650c0c8a8a +Subproject commit 5afb5a210b2ec857f43afdfe5deba365a6eb4fb5 diff --git a/sdkdocs/go b/sdkdocs/go index f4ba09fae..682f93206 160000 --- a/sdkdocs/go +++ b/sdkdocs/go @@ -1 +1 @@ -Subproject commit f4ba09fae50c634cad11050ff05485cb9ef65bf7 +Subproject commit 682f93206d40ab83589fccb58afe8f409b7d38c1 diff --git a/sdkdocs/java b/sdkdocs/java index f73d57eb2..afa2feeac 160000 --- a/sdkdocs/java +++ b/sdkdocs/java @@ -1 +1 @@ -Subproject commit f73d57eb27028bf41e9ab1fde3b50586ab5de919 +Subproject commit afa2feeacef73e5598fab88c605d61f5998efa86 diff --git a/sdkdocs/js b/sdkdocs/js index 26b3527e6..26e8be893 160000 --- a/sdkdocs/js +++ b/sdkdocs/js @@ -1 +1 @@ -Subproject commit 26b3527e688751a2ffef812bec95790535218506 +Subproject commit 26e8be8931aed2404e0e382b6c61264d1b64f0de diff --git a/sdkdocs/python b/sdkdocs/python index b2f2988f3..5882d5296 160000 --- a/sdkdocs/python +++ b/sdkdocs/python @@ -1 +1 @@ -Subproject commit b2f2988f397a34159e67fb30c6a0e2f414a60350 +Subproject commit 5882d52961cee7cb50d07c9a47c902f317dff396 diff --git a/sdkdocs/rust b/sdkdocs/rust index 407447816..4475ed57c 160000 --- a/sdkdocs/rust +++ b/sdkdocs/rust @@ -1 +1 @@ -Subproject commit 407447816c2107860af98897802c4491306e95d0 +Subproject commit 4475ed57cfdcb912a828f43cace8c0bea3eb99e1