From 3524b002f4fb8b4bd1b58c5abd264f47eb619856 Mon Sep 17 00:00:00 2001 From: Mike Nguyen Date: Wed, 10 Sep 2025 18:14:09 +0100 Subject: [PATCH 1/5] docs: update max-body-size documentation closes #4670 Signed-off-by: Mike Nguyen --- .../configuration/increase-request-size.md | 26 ++++++++++++------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/daprdocs/content/en/operations/configuration/increase-request-size.md b/daprdocs/content/en/operations/configuration/increase-request-size.md index 04f6500866c..2202f61d436 100644 --- a/daprdocs/content/en/operations/configuration/increase-request-size.md +++ b/daprdocs/content/en/operations/configuration/increase-request-size.md @@ -1,27 +1,31 @@ --- type: docs -title: "How-To: Handle large http body requests" -linkTitle: "HTTP request body size" +title: "How-To: Handle larger body requests" +linkTitle: "Request body size" weight: 6000 description: "Configure http requests that are bigger than 4 MB" --- -By default, Dapr has a limit for the request body size, set to 4MB. You can change this by defining: -- The `dapr.io/http-max-request-size` annotation, or -- The `--dapr-http-max-request-size` flag. +{{% alert title="Note" color="primary" %}} +The existing flag/annotation `dapr-http-max-request-size` has been deprecated and replaced with the below. It will be removed in the next release. + +Certification lifecycle only applies to built-in components and does not apply to [pluggable components]({{}}). +{{% /alert %}} + +By default, Dapr has a limit for the request body size, set to 4MB. You can change this for both HTTP and gRPC requests by defining: +- The `dapr.io/max-body-size` annotation, or +- The `--max-body-size` flag. {{< tabpane text=true >}} {{% tab "Self-hosted" %}} -When running in self-hosted mode, use the `--dapr-http-max-request-size` flag to configure Dapr to use non-default request body size: +When running in self-hosted mode, use the `--max-body-size` flag to configure Dapr to use non-default request body size: ```bash -dapr run --dapr-http-max-request-size 16 node app.js +dapr run --max-body-size 16 node app.js ``` -This tells Dapr to set maximum request body size to `16` MB. - {{% /tab %}} @@ -50,7 +54,7 @@ spec: dapr.io/enabled: "true" dapr.io/app-id: "myapp" dapr.io/app-port: "8000" - dapr.io/http-max-request-size: "16" + dapr.io/max-body-size: "16" #... ``` @@ -58,6 +62,8 @@ spec: {{< /tabpane >}} +This tells Dapr to set the maximum request body size to `16` MB for both HTTP and gRPC requests. + ## Related links [Dapr Kubernetes pod annotations spec]({{% ref arguments-annotations-overview.md %}}) From ded6f556bc6ae731b62dc1f8711b7765fd77b284 Mon Sep 17 00:00:00 2001 From: Mike Nguyen Date: Thu, 11 Sep 2025 09:51:53 +0100 Subject: [PATCH 2/5] docs: update max-body-size documentation and deprecation notices closes #4670 Signed-off-by: Mike Nguyen --- .../configuration/increase-request-size.md | 2 +- .../breaking-changes-and-deprecations.md | 23 ++++++++++--------- 2 files changed, 13 insertions(+), 12 deletions(-) diff --git a/daprdocs/content/en/operations/configuration/increase-request-size.md b/daprdocs/content/en/operations/configuration/increase-request-size.md index 2202f61d436..ff96c4548ce 100644 --- a/daprdocs/content/en/operations/configuration/increase-request-size.md +++ b/daprdocs/content/en/operations/configuration/increase-request-size.md @@ -7,7 +7,7 @@ description: "Configure http requests that are bigger than 4 MB" --- {{% alert title="Note" color="primary" %}} -The existing flag/annotation `dapr-http-max-request-size` has been deprecated and replaced with the below. It will be removed in the next release. +The existing flag/annotation`dapr-http-max-request-size` has been deprecated, please update to `max-body-size`. Certification lifecycle only applies to built-in components and does not apply to [pluggable components]({{}}). {{% /alert %}} diff --git a/daprdocs/content/en/operations/support/breaking-changes-and-deprecations.md b/daprdocs/content/en/operations/support/breaking-changes-and-deprecations.md index a0895537cc3..838dacd7d4e 100644 --- a/daprdocs/content/en/operations/support/breaking-changes-and-deprecations.md +++ b/daprdocs/content/en/operations/support/breaking-changes-and-deprecations.md @@ -58,17 +58,18 @@ After announcing a future breaking change, the change will happen in 2 releases ## Announced deprecations -| Feature | Deprecation announcement | Removal | -|-----------------------|-----------------------|------------------------- | -| GET /v1.0/shutdown API (Users should use [POST API]({{% ref kubernetes-job.md %}}) instead) | 1.2.0 | 1.4.0 | -| Java domain builder classes deprecated (Users should use [setters](https://github.com/dapr/java-sdk/issues/587) instead) | Java SDK 1.3.0 | Java SDK 1.5.0 | -| Service invocation will no longer provide a default content type header of `application/json` when no content-type is specified. You must explicitly [set a content-type header]({{% ref "service_invocation_api.md#request-contents" %}}) for service invocation if your invoked apps rely on this header. | 1.7.0 | 1.9.0 | -| gRPC service invocation using `invoke` method is deprecated. Use proxy mode service invocation instead. See [How-To: Invoke services using gRPC ]({{% ref howto-invoke-services-grpc.md %}}) to use the proxy mode.| 1.9.0 | 1.10.0 | -| The CLI flag `--app-ssl` (in both the Dapr CLI and daprd) has been deprecated in favor of using `--app-protocol` with values `https` or `grpcs`. [daprd:6158](https://github.com/dapr/dapr/issues/6158) [cli:1267](https://github.com/dapr/cli/issues/1267)| 1.11.0 | 1.13.0 | -| Hazelcast PubSub Component | 1.9.0 | 1.11.0 | -| Twitter Binding Component | 1.10.0 | 1.11.0 | -| NATS Streaming PubSub Component | 1.11.0 | 1.13.0 | -| Workflows API Alpha1 `/v1.0-alpha1/workflows` being deprecated in favor of Workflow Client | 1.15.0 | 1.17.0 | +| Feature | Deprecation announcement | Removal | +|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|----------------| +| GET /v1.0/shutdown API (Users should use [POST API]({{% ref kubernetes-job.md %}}) instead) | 1.2.0 | 1.4.0 | +| Java domain builder classes deprecated (Users should use [setters](https://github.com/dapr/java-sdk/issues/587) instead) | Java SDK 1.3.0 | Java SDK 1.5.0 | +| Service invocation will no longer provide a default content type header of `application/json` when no content-type is specified. You must explicitly [set a content-type header]({{% ref "service_invocation_api.md#request-contents" %}}) for service invocation if your invoked apps rely on this header. | 1.7.0 | 1.9.0 | +| gRPC service invocation using `invoke` method is deprecated. Use proxy mode service invocation instead. See [How-To: Invoke services using gRPC ]({{% ref howto-invoke-services-grpc.md %}}) to use the proxy mode. | 1.9.0 | 1.10.0 | +| The CLI flag `--app-ssl` (in both the Dapr CLI and daprd) has been deprecated in favor of using `--app-protocol` with values `https` or `grpcs`. [daprd:6158](https://github.com/dapr/dapr/issues/6158) [cli:1267](https://github.com/dapr/cli/issues/1267) | 1.11.0 | 1.13.0 | +| Hazelcast PubSub Component | 1.9.0 | 1.11.0 | +| Twitter Binding Component | 1.10.0 | 1.11.0 | +| NATS Streaming PubSub Component | 1.11.0 | 1.13.0 | +| Workflows API Alpha1 `/v1.0-alpha1/workflows` being deprecated in favor of Workflow Client | 1.15.0 | 1.17.0 | +| Migration of `http-max-request-size` flags/annotations to `max-body-size` | 1.14.0 | 1.17.0 | ## Related links From 944effcf5d92e8290e1ed006481ab80005c1cb6f Mon Sep 17 00:00:00 2001 From: Mike Nguyen Date: Thu, 11 Sep 2025 10:08:50 +0100 Subject: [PATCH 3/5] docs: clarify deprecation notice closes #4670 Signed-off-by: Mike Nguyen --- .../en/operations/support/breaking-changes-and-deprecations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/daprdocs/content/en/operations/support/breaking-changes-and-deprecations.md b/daprdocs/content/en/operations/support/breaking-changes-and-deprecations.md index 838dacd7d4e..3c2214cb711 100644 --- a/daprdocs/content/en/operations/support/breaking-changes-and-deprecations.md +++ b/daprdocs/content/en/operations/support/breaking-changes-and-deprecations.md @@ -69,7 +69,7 @@ After announcing a future breaking change, the change will happen in 2 releases | Twitter Binding Component | 1.10.0 | 1.11.0 | | NATS Streaming PubSub Component | 1.11.0 | 1.13.0 | | Workflows API Alpha1 `/v1.0-alpha1/workflows` being deprecated in favor of Workflow Client | 1.15.0 | 1.17.0 | -| Migration of `http-max-request-size` flags/annotations to `max-body-size` | 1.14.0 | 1.17.0 | +| Migration of `http-max-request-size` flags/annotations to `max-body-size`. See [How-To: Handle larger body requests]({{% ref increase-request-size.md %}}) | 1.14.0 | 1.17.0 | ## Related links From 9ecbb9ae6b3450173fd36dfd249bb6905a9ba333 Mon Sep 17 00:00:00 2001 From: Mark Fussell Date: Thu, 11 Sep 2025 09:21:27 -0700 Subject: [PATCH 4/5] Update daprdocs/content/en/operations/configuration/increase-request-size.md Signed-off-by: Mark Fussell --- .../en/operations/configuration/increase-request-size.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/daprdocs/content/en/operations/configuration/increase-request-size.md b/daprdocs/content/en/operations/configuration/increase-request-size.md index ff96c4548ce..cf8fc59c0a9 100644 --- a/daprdocs/content/en/operations/configuration/increase-request-size.md +++ b/daprdocs/content/en/operations/configuration/increase-request-size.md @@ -7,7 +7,7 @@ description: "Configure http requests that are bigger than 4 MB" --- {{% alert title="Note" color="primary" %}} -The existing flag/annotation`dapr-http-max-request-size` has been deprecated, please update to `max-body-size`. +The existing flag/annotation`dapr-http-max-request-size` has been deprecated and updated to `max-body-size`. Certification lifecycle only applies to built-in components and does not apply to [pluggable components]({{}}). {{% /alert %}} From 345e71bd0824ae262f41acc0e297a9ec1440f511 Mon Sep 17 00:00:00 2001 From: Mike Nguyen Date: Fri, 12 Sep 2025 09:19:19 +0100 Subject: [PATCH 5/5] tidy Signed-off-by: Mike Nguyen --- .../en/operations/configuration/increase-request-size.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/daprdocs/content/en/operations/configuration/increase-request-size.md b/daprdocs/content/en/operations/configuration/increase-request-size.md index cf8fc59c0a9..2246d93bfdd 100644 --- a/daprdocs/content/en/operations/configuration/increase-request-size.md +++ b/daprdocs/content/en/operations/configuration/increase-request-size.md @@ -8,8 +8,6 @@ description: "Configure http requests that are bigger than 4 MB" {{% alert title="Note" color="primary" %}} The existing flag/annotation`dapr-http-max-request-size` has been deprecated and updated to `max-body-size`. - -Certification lifecycle only applies to built-in components and does not apply to [pluggable components]({{}}). {{% /alert %}} By default, Dapr has a limit for the request body size, set to 4MB. You can change this for both HTTP and gRPC requests by defining: