Merge branch 'v1.17' into add-akeyless-doc

Author: kgal-akl

.github/workflows/website-v1-17.yml

@@ -47,9 +47,9 @@ jobs:
           HUGO_ENV: production
           HUGO_VERSION: "0.147.9"
         with:
-          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_V1_16 }}
-          repo_token: ${{ secrets.GITHUB_TOKEN }} # Used for Github integrations (i.e. PR comments)
+          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_V1_17 }}
           skip_deploy_on_missing_secrets: true
+          repo_token: ${{ secrets.GITHUB_TOKEN }} # Used for Github integrations (i.e. PR comments)
           action: "upload"
           ###### Repository/Build Configurations - These values can be configured to match your app requirements. ######
           # For more information regarding Static Web App workflow configurations, please visit: https://aka.ms/swaworkflowconfig
@@ -66,6 +66,7 @@ jobs:
         id: closepullrequest
         uses: Azure/static-web-apps-deploy@v1
         with:
-          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_V1_16 }}
+          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_V1_17 }}
           skip_deploy_on_missing_secrets: true
+          app_location: "/daprdocs/public" # App source code path
           action: "close"

daprdocs/content/en/developing-applications/building-blocks/pubsub/pubsub-cloudevents.md

@@ -239,6 +239,48 @@ Invoke-RestMethod -Method Post -ContentType 'application/cloudevents+json' -Body
 
 {{< /tabpane >}}
 
+### Publish binary CloudEvents
+
+In binary mode, the transport payload only contains the event body, while
+CloudEvent attributes are supplied via transport metadata that begins with the
+`ce_` prefix (HTTP headers, Kafka headers, NATS headers, and so on). This is
+useful when you already produce binary mode events or you want to send arbitrary
+binary data without wrapping it in an additional JSON envelope.
+
+To publish a binary CloudEvent to Dapr (via HTTP/gRPC publish APIs or directly
+into a broker that Dapr reads from):
+
+1. Set the transport’s native content-type metadata (for example the HTTP
+   `Content-Type` header or a Kafka `content-type` message header) to the MIME
+   type that represents binary data, which is `application/octet-stream`.
+
+2. Add the required CloudEvent attributes (`ce_specversion`, `ce_type`,
+   `ce_source`, `ce_id`) as transport metadata. Optional attributes such as
+   `ce_subject`, `ce_time`, or `ce_traceparent` are also honored.
+
+3. Send the payload bytes in the message body.
+
+{{< tabpane text=true >}}
+
+{{% tab "HTTP API (Bash)" %}}
+
+Publish a Binary CloudEvent to orders topic:
+
+```bash
+curl -X POST http://localhost:3500/v1.0/publish/order-pub-sub/orders \
+  -H "Content-Type: application/octet-stream" \
+  -H "ce_specversion: 1.0" \
+  -H "ce_type: com.example.order.created" \
+  -H "ce_source: urn:example:/checkout" \
+  -H "ce_id: 2a8bbf52-1222-4c2c-85f0-8a8875c7bc10" \
+  -H "ce_subject: orders/100" \
+  --data-binary $'\x01\x02\x03\x04'
+```
+
+{{% /tab %}}
+
+{{< /tabpane >}}
+
 ## Event deduplication
 
 When using cloud events created by Dapr, the envelope contains an `id` field which can be used by the app to perform message deduplication. Dapr does not handle deduplication automatically. Dapr supports using message brokers that natively enable message deduplication.

daprdocs/content/en/reference/api/pubsub_api.md

@@ -300,6 +300,28 @@ HTTP Status | Description
 404 | error is logged and all messages are dropped
 other | warning is logged and all messages to be retried
 
+#### CloudEvents binary mode
+
+Supports publishing CloudEvents that use the binary mode defined by
+the CloudEvents HTTP binding. In this mode, the HTTP body only contains the
+payload bytes, and CloudEvent attributes are passed as headers with the `ce_`
+prefix. Provide the required headers (`ce_specversion`, `ce_type`, `ce_source`,
+`ce_id`) along with any optional ones (for example `ce_subject` or `ce_time`).
+Dapr copies the HTTP `Content-Type` header into the CloudEvent's
+`datacontenttype` attribute and forwards the resulting event to subscribers.
+
+Example sending four raw bytes:
+
+```bash
+curl -X POST http://localhost:3500/v1.0/publish/pubsubName/deathStarStatus \
+  -H "Content-Type: application/octet-stream" \
+  -H "ce_specversion: 1.0" \
+  -H "ce_type: com.example.deathstar.status.changed" \
+  -H "ce_source: urn:example:/deathstar" \
+  -H "ce_id: 3a58b9b8-24d2-4f62-84f4-6177c2fe0633" \
+  --data-binary $'\x01\x02\x03\x04'
+```
+
 ## Message envelope
 
 Dapr pub/sub adheres to [version 1.0 of CloudEvents](https://github.com/cloudevents/spec/blob/v1.0/spec.md).