Skip to content

Commit 5c25364

Browse files
authored
Merge pull request #4128 from hhunter-ms/upmerge_05-03
Upmerge 1.13 --> 1.14
2 parents 516e503 + 6ea4f7d commit 5c25364

File tree

23 files changed

+129
-45
lines changed

23 files changed

+129
-45
lines changed

.github/holopin.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
organization: dapr
2-
defaultSticker: clmjkxscc122740fl0mkmb7egi
2+
defaultSticker: clrqf84g1199090gldi6kf00gc
33
stickers:
44
-
5-
id: clmjkxscc122740fl0mkmb7egi
6-
alias: ghc2023
5+
id: clrqf84g1199090gldi6kf00gc
6+
alias: docs-badge

daprdocs/config.toml

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -105,37 +105,45 @@ id = "G-60C6Q1ETC1"
105105
lang = "en"
106106

107107
[[module.mounts]]
108-
source = "../translations/docs-zh/content/zh-hans"
108+
source = "../translations/docs-zh/translated_content/zh_CN/docs"
109109
target = "content"
110110
lang = "zh-hans"
111111
[[module.mounts]]
112-
source = "../translations/docs-zh/content/contributing"
113-
target = "content/contributing/docs-contrib/docs-templates"
112+
source = "../translations/docs-zh/translated_content/zh_CN/contributing"
113+
target = "content/contributing/sdk-contrib/"
114114
lang = "zh-hans"
115115
[[module.mounts]]
116-
source = "../translations/docs-zh/content/sdks_python"
116+
source = "../translations/docs-zh/translated_content/zh_CN/sdks_python"
117117
target = "content/developing-applications/sdks/python"
118118
lang = "zh-hans"
119119
[[module.mounts]]
120-
source = "../translations/docs-zh/content/sdks_php"
120+
source = "../translations/docs-zh/translated_content/zh_CN/sdks_php"
121121
target = "content/developing-applications/sdks/php"
122122
lang = "zh-hans"
123123
[[module.mounts]]
124-
source = "../translations/docs-zh/content/sdks_dotnet"
124+
source = "../translations/docs-zh/translated_content/zh_CN/sdks_dotnet"
125125
target = "content/developing-applications/sdks/dotnet"
126126
lang = "zh-hans"
127127
[[module.mounts]]
128-
source = "../translations/docs-zh/content/sdks_java"
128+
source = "../translations/docs-zh/translated_content/zh_CN/sdks_java"
129129
target = "content/developing-applications/sdks/java"
130130
lang = "zh-hans"
131131
[[module.mounts]]
132-
source = "../translations/docs-zh/content/sdks_go"
132+
source = "../translations/docs-zh/translated_content/zh_CN/sdks_go"
133133
target = "content/developing-applications/sdks/go"
134134
lang = "zh-hans"
135135
[[module.mounts]]
136-
source = "../translations/docs-zh/content/sdks_js"
136+
source = "../translations/docs-zh/translated_content/zh_CN/sdks_js"
137137
target = "content/developing-applications/sdks/js"
138138
lang = "zh-hans"
139+
[[module.mounts]]
140+
source = "../translations/docs-zh/translated_content/zh_CN/pluggable-components/dotnet"
141+
target = "content/developing-applications/develop-components/pluggable-components/pluggable-components-sdks/pluggable-components-dotnet"
142+
lang = "zh-hans"
143+
[[module.mounts]]
144+
source = "../translations/docs-zh/translated_content/zh_CN/pluggable-components/go"
145+
target = "content/developing-applications/develop-components/pluggable-components/pluggable-components-sdks/pluggable-components-go"
146+
lang = "zh-hans"
139147

140148
# Markdown Engine - Allow inline html
141149
[markup]

daprdocs/content/en/contributing/contributing-overview.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,25 @@ description: >
88
---
99

1010
Thank you for your interest in Dapr!
11-
This document provides the guidelines for how to contribute to the [Dapr project](https://github.com/dapr) through issues and pull-requests. Contributions can also come in additional ways such as engaging with the community in community calls, commenting on issues or pull requests and more.
11+
This document provides the guidelines for how to contribute to the [Dapr project](https://github.com/dapr) through issues and pull requests. Contributions can also come in additional ways such as engaging with the community in community calls, commenting on issues or pull requests, and more.
1212

1313
See the [Dapr community repository](https://github.com/dapr/community) for more information on community engagement and community membership.
1414

15-
> If you are looking to contribute to the Dapr docs, please also see the specific guidelines for [docs contributions]({{< ref contributing-docs >}}).
15+
## Dapr Repository Index
16+
17+
Below is a list of repositories under the Dapr organization where you can contribute:
18+
19+
1. **Docs**: This [repository](https://github.com/dapr/docs) contains the documentation for Dapr. You can contribute by updating existing documentation, fixing errors, or adding new content to improve user experience and clarity. Please see the specific guidelines for [docs contributions]({{< ref contributing-docs >}}).
20+
21+
2. **Quickstarts**: The Quickstarts [repository](https://github.com/dapr/quickstarts) provides simple, step-by-step guides to help users get started with Dapr quickly. Contributions in this repository involve creating new quickstarts, improving existing ones, or ensuring they stay up-to-date with the latest features.
22+
23+
3. **Runtime**: The Dapr runtime [repository](https://github.com/dapr/dapr) houses the core runtime components. Here, you can contribute by fixing bugs, optimizing performance, implementing new features, or enhancing existing ones.
24+
25+
4. **Components-contrib**: This [repository](https://github.com/dapr/components-contrib) hosts a collection of community-contributed components for Dapr. You can contribute by adding new components, improving existing ones, or reviewing and testing contributions from the community.
26+
27+
5. **SDKs**: Dapr SDKs provide libraries for various programming languages to interact with Dapr. You can contribute by improving SDK functionalities, fixing bugs, or adding support for new features. Please see the [contribution guidelines]({{< ref sdk-contrib >}}) for specific SDKs.
28+
29+
6. **CLI**: Dapr cli sets up Dapr on a local dev machine or a Kubernetes cluster for launching and managing Dapr instances. Contributions to the CLI repository include adding new features, fixing bugs, improving usability, and ensuring compatibility with the latest Dapr releases. Please see the [Development Guide](https://github.com/dapr/cli/blob/master/docs/development/development.md) for help in getting started with developing the Dapr cli.
1630

1731
## Issues
1832

daprdocs/content/en/contributing/presentations.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,13 @@ We welcome community members giving presentations on Dapr and spreading the word
1010

1111
{{< button text="Download the Dapr Presentation Deck" link="/presentations/dapr-slidedeck.pptx.zip" >}}
1212

13+
{{% alert color="primary" %}}
14+
If you're using the PowerPoint template with MacOS, please install the Space Grotesk font to ensure the text is rendered properly:
15+
```sh
16+
brew install --cask homebrew/cask-fonts/font-space-grotesk
17+
```
18+
{{% /alert %}}
19+
1320
## Giving a Dapr presentation
1421

1522
- Begin by downloading the [Dapr Presentation Deck](/presentations/dapr-slidedeck.pptx.zip). This contains slides and diagrams needed to give a Dapr presentation.

daprdocs/content/en/developing-applications/building-blocks/secrets/secrets-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ Applications can also use the secrets API to access secrets from a Kubernetes se
4141
- The Helm defaults, or
4242
- `dapr init -k`
4343

44-
If you are using another secret store, you can disable (not configure) the Dapr Kubernetes secret store by setting `disable-builtin-k8s-secret-store` to `true` through the Helm settings. The default is `false`.
44+
If you are using another secret store, you can disable (not configure) the Dapr Kubernetes secret store by adding the annotation `dapr.io/disable-builtin-k8s-secret-store: "true"` to the deployment.yaml file. The default is `false`.
4545

4646
In the example below, the application retrieves the same secret "mysecret" from a Kubernetes secret store.
4747

@@ -86,4 +86,4 @@ Want to skip the quickstarts? Not a problem. You can try out the secret manageme
8686
## Next steps
8787

8888
- Learn [how to use secret scoping]({{< ref secrets-scopes.md >}}).
89-
- Read the [secrets API reference doc]({{< ref secrets_api.md >}}).
89+
- Read the [secrets API reference doc]({{< ref secrets_api.md >}}).

daprdocs/content/en/developing-applications/building-blocks/secrets/secrets-scopes.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ title: "How To: Use secret scoping"
44
linkTitle: "How To: Use secret scoping"
55
weight: 3000
66
description: "Use scoping to limit the secrets that can be read by your application from secret stores"
7-
type: docs
87
---
98

109
Once you [configure a secret store for your application]({{< ref setup-secret-store >}}), *any* secret defined within that store is accessible by default from the Dapr application.
@@ -107,4 +106,4 @@ Scenarios | defaultAccess | allowedSecrets | deniedSecrets | permission
107106
## Related links
108107

109108
- List of [secret stores]({{< ref supported-secret-stores.md >}})
110-
- Overview of [secret stores]({{< ref setup-secret-store.md >}})
109+
- Overview of [secret stores]({{< ref setup-secret-store.md >}})

daprdocs/content/en/developing-applications/building-blocks/workflow/workflow-patterns.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -248,11 +248,11 @@ func TaskChainWorkflow(ctx *workflow.WorkflowContext) (any, error) {
248248
return nil, err
249249
}
250250
var result2 int
251-
if err := ctx.CallActivity(Step1, workflow.ActivityInput(input)).Await(&result2); err != nil {
251+
if err := ctx.CallActivity(Step2, workflow.ActivityInput(input)).Await(&result2); err != nil {
252252
return nil, err
253253
}
254254
var result3 int
255-
if err := ctx.CallActivity(Step1, workflow.ActivityInput(input)).Await(&result3); err != nil {
255+
if err := ctx.CallActivity(Step3, workflow.ActivityInput(input)).Await(&result3); err != nil {
256256
return nil, err
257257
}
258258
return []int{result1, result2, result3}, nil
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
type: docs
3+
title: "Integrations with Diagrid"
4+
linkTitle: "Diagrid"
5+
weight: 1000
6+
description: "Dapr integrations with Diagrid"
7+
---
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
type: docs
3+
title: "Conductor: Enterprise Dapr for Kubernetes"
4+
linkTitle: "Diagrid Conductor"
5+
description: "Automate operations, enforce security best practices, improve uptime, and elevate insights across your Dapr clusters"
6+
weight: 2000
7+
---
8+
9+
<br /><img src="/images/diagrid-conductor.png" alt="Diagrid Conductor diagram" width="800">
10+
11+
[Diagrid Conductor](https://www.diagrid.io/conductor) quickly and securely connects to all your Kubernetes clusters running Dapr and Daprized applications, delivering operational excellence, security & reliability and insights & collaboration.
12+
13+
**Automated Dapr management**
14+
15+
One-click installation, upgrade and patching of Dapr with selective application update and automated rollback means you’re always up to date.
16+
17+
**Advisor: Discover and automate best practices**
18+
19+
Be informed and apply production best practices, with continuous checking to prevent misconfigurations, increasing security, reliability and performance.
20+
21+
**Resource usage reporting and tracking**
22+
23+
By studying past resource behavior, recommend application resource optimization usage leading to significant cost savings on CPU and memory.
24+
25+
**Application visualizer**
26+
27+
The application graph facilitates collaboration between dev and ops by providing a dynamic overview of your services and infrastructure components.
28+
29+
Try out [Conductor Free](https://www.diagrid.io/pricing), ideal for individual developers building and testing Dapr applications on Kubernetes.
30+
31+
{{< button text="Learn more about Diagrid Conductor" link="https://www.diagrid.io/conductor" >}}

daprdocs/content/en/developing-applications/integrations/gRPC-integration.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ title: "How to: Use the gRPC interface in your Dapr application"
44
linkTitle: "How to: gRPC interface"
55
weight: 6000
66
description: "Use the Dapr gRPC API in your application"
7-
type: docs
87
---
98

109
Dapr implements both an HTTP and a gRPC API for local calls. [gRPC](https://grpc.io/) is useful for low-latency, high performance scenarios and has language integration using the proto clients.

daprdocs/content/en/developing-applications/sdks/_index.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,12 @@ Select your [preferred language below]({{< ref "#sdk-languages" >}}) to learn mo
2424
|----------|:------|:----------:|:-----------:|:---------:|:---------:|
2525
| [.NET]({{< ref dotnet >}}) | Stable || [ASP.NET Core](https://github.com/dapr/dotnet-sdk/tree/master/examples/AspNetCore) |||
2626
| [Python]({{< ref python >}}) | Stable || [gRPC]({{< ref python-grpc.md >}}) <br />[FastAPI]({{< ref python-fastapi.md >}})<br />[Flask]({{< ref python-flask.md >}})|||
27-
| [Java]({{< ref java >}}) | Stable || Spring Boot || |
28-
| [Go]({{< ref go >}}) | Stable |||| |
27+
| [Java]({{< ref java >}}) | Stable || Spring Boot <br /> Quarkus|| |
28+
| [Go]({{< ref go >}}) | Stable |||| |
2929
| [PHP]({{< ref php >}}) | Stable |||| |
30-
| [Javascript]({{< ref js >}}) | Stable|| || |
30+
| [Javascript]({{< ref js >}}) | Stable|| || |
3131
| [C++](https://github.com/dapr/cpp-sdk) | In development || | |
32-
| [Rust](https://github.com/dapr/rust-sdk) | In development || | | |
32+
| [Rust](https://github.com/dapr/rust-sdk) | In development || | | |
3333

3434
## Further reading
3535

daprdocs/content/en/operations/hosting/kubernetes/kubernetes-job.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ title: "Running Dapr with a Kubernetes Job"
44
linkTitle: "Kubernetes Jobs"
55
weight: 70000
66
description: "Use Dapr API in a Kubernetes Job context"
7-
type: docs
87
---
98

109
The Dapr sidecar is designed to be a long running process. In the context of a [Kubernetes Job](https://kubernetes.io/docs/concepts/workloads/controllers/job/) this behavior can block your job completion.
@@ -67,4 +66,4 @@ func main() {
6766
## Related links
6867

6968
- [Deploy Dapr on Kubernetes]({{< ref kubernetes-deploy.md >}})
70-
- [Upgrade Dapr on Kubernetes]({{< ref kubernetes-upgrade.md >}})
69+
- [Upgrade Dapr on Kubernetes]({{< ref kubernetes-upgrade.md >}})

daprdocs/content/en/operations/hosting/kubernetes/kubernetes-production.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,14 @@ description: "Best practices for deploying Dapr to a Kubernetes cluster in a pro
1010

1111
Dapr support for Kubernetes is aligned with [Kubernetes Version Skew Policy](https://kubernetes.io/releases/version-skew-policy/).
1212

13-
Use the following resource settings as a starting point. Requirements vary depending on cluster size, number of pods, and other factors. Perform individual testing to find the right values for your environment.
13+
Use the following resource settings as a starting point. Requirements vary depending on cluster size, number of pods, and other factors. Perform individual testing to find the right values for your environment. In production, it's recommended to not add memory limits to the Dapr control plane components to avoid `OOMKilled` pod statuses.
1414

1515
| Deployment | CPU | Memory
1616
|-------------|-----|-------
17-
| **Operator** | Limit: 1, Request: 100m | Limit: 200Mi, Request: 100Mi
18-
| **Sidecar Injector** | Limit: 1, Request: 100m | Limit: 200Mi, Request: 30Mi
19-
| **Sentry** | Limit: 1, Request: 100m | Limit: 200Mi, Request: 30Mi
20-
| **Placement** | Limit: 1, Request: 250m | Limit: 150Mi, Request: 75Mi
21-
| **Dashboard** | Limit: 200m, Request: 50m | Limit: 200Mi, Request: 20Mi
17+
| **Operator** | Limit: 1, Request: 100m | Request: 100Mi
18+
| **Sidecar Injector** | Limit: 1, Request: 100m | Request: 30Mi
19+
| **Sentry** | Limit: 1, Request: 100m | Request: 30Mi
20+
| **Placement** | Limit: 1, Request: 250m | Request: 75Mi
2221

2322
{{% alert title="Note" color="primary" %}}
2423
For more information, refer to the Kubernetes documentation on [CPU and Memory resource units and their meaning](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-units-in-kubernetes).

daprdocs/content/en/operations/observability/tracing/otel-collector/open-telemetry-collector-jaeger.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ title: "Using OpenTelemetry Collector to collect traces to send to Jaeger"
44
linkTitle: "Using the OpenTelemetry for Jaeger"
55
weight: 1200
66
description: "How to push trace events to Jaeger distributed tracing platform, using the OpenTelemetry Collector."
7-
type: docs
87
---
98

109
While Dapr supports writing traces using OpenTelemetry (OTLP) and Zipkin protocols, Zipkin support for Jaeger has been deprecated in favor of OTLP. Although Jaeger supports OTLP directly, the recommended approach for production is to use the OpenTelemetry Collector to collect traces from Dapr and send them to Jaeger, allowing your application to quickly offload data and take advantage of features like retries, batching, and encryption. For more information, read the Open Telemetry Collector [documentation](https://opentelemetry.io/docs/collector/#when-to-use-a-collector).

daprdocs/content/en/operations/observability/tracing/zipkin.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ title: "How-To: Set up Zipkin for distributed tracing"
44
linkTitle: "Zipkin"
55
weight: 4000
66
description: "Set up Zipkin for distributed tracing"
7-
type: docs
87
---
98

109
## Configure self hosted mode

daprdocs/content/en/operations/resiliency/health-checks/sidecar-health.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,21 @@ Dapr has its HTTP health endpoint `/v1.0/healthz` on port 3500. This can be used
126126
failureThreshold: 3
127127
```
128128

129+
## Delay graceful shutdown
130+
131+
Dapr accepts a [`dapr.io/block-shutdown-duration` annotation or `--dapr-block-shutdown-duration` CLI flag]({{< ref arguments-annotations-overview.md >}}), which delays the full shutdown procedure for the specified duration, or until the app reports as unhealthy, whichever is sooner.
132+
133+
During this period, all subscriptions and input bindings are closed. This is useful for applications that need to use the Dapr APIs as part of their own shutdown procedure.
134+
135+
Applicable annotations or CLI flags include:
136+
137+
- `--dapr-graceful-shutdown-seconds`/`dapr.io/graceful-shutdown-seconds`
138+
- `--dapr-block-shutdown-duration`/`dapr.io/block-shutdown-duration`
139+
- `--dapr-graceful-shutdown-seconds`/`dapr.io/graceful-shutdown-seconds`
140+
- `--dapr-block-shutdown-duration`/`dapr.io/block-shutdown-duration`
141+
142+
Learn more about these and how to use them in the [Annotations and arguments guide.]({{< ref arguments-annotations-overview.md >}})
143+
129144
## Related links
130145

131146
- [Endpoint health API]({{< ref health_api.md >}})

daprdocs/content/en/operations/support/support-release-policy.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,8 @@ The table below shows the versions of Dapr releases that have been tested togeth
4545

4646
| Release date | Runtime | CLI | SDKs | Dashboard | Status | Release notes |
4747
|--------------------|:--------:|:--------|---------|---------|---------|------------|
48+
| April 3rd 2024 | 1.13.2</br> | 1.13.0 | Java 1.11.0 </br>Go 1.10.0 </br>PHP 1.2.0 </br>Python 1.13.0 </br>.NET 1.13.0 </br>JS 3.3.0 | 0.14.0 | Supported (current) | [v1.13.2 release notes](https://github.com/dapr/dapr/releases/tag/v1.13.2) |
49+
| March 26th 2024 | 1.13.1</br> | 1.13.0 | Java 1.11.0 </br>Go 1.10.0 </br>PHP 1.2.0 </br>Python 1.13.0 </br>.NET 1.13.0 </br>JS 3.3.0 | 0.14.0 | Supported (current) | [v1.13.1 release notes](https://github.com/dapr/dapr/releases/tag/v1.13.1) |
4850
| March 6th 2024 | 1.13.0</br> | 1.13.0 | Java 1.11.0 </br>Go 1.10.0 </br>PHP 1.2.0 </br>Python 1.13.0 </br>.NET 1.13.0 </br>JS 3.3.0 | 0.14.0 | Supported (current) | [v1.13.0 release notes](https://github.com/dapr/dapr/releases/tag/v1.13.0) |
4951
| January 17th 2024 | 1.12.4</br> | 1.12.0 | Java 1.10.0 </br>Go 1.9.1 </br>PHP 1.2.0 </br>Python 1.12.0 </br>.NET 1.12.0 </br>JS 3.2.0 | 0.14.0 | Supported (current) | [v1.12.4 release notes](https://github.com/dapr/dapr/releases/tag/v1.12.4) |
5052
| January 2nd 2024 | 1.12.3</br> | 1.12.0 | Java 1.10.0 </br>Go 1.9.1 </br>PHP 1.2.0 </br>Python 1.12.0 </br>.NET 1.12.0 </br>JS 3.2.0 | 0.14.0 | Supported (current) | [v1.12.3 release notes](https://github.com/dapr/dapr/releases/tag/v1.12.3) |
@@ -133,7 +135,7 @@ General guidance on upgrading can be found for [self hosted mode]({{< ref self-h
133135
| 1.10.0 | N/A | 1.10.8 |
134136
| 1.11.0 | N/A | 1.11.4 |
135137
| 1.12.0 | N/A | 1.12.4 |
136-
| 1.13.0 | N/A | 1.13.0 |
138+
| 1.13.0 | N/A | 1.13.2 |
137139

138140
## Upgrade on Hosting platforms
139141

0 commit comments

Comments
 (0)