diff --git a/daprdocs/config.toml b/daprdocs/config.toml index e738b6b15..b89160e36 100644 --- a/daprdocs/config.toml +++ b/daprdocs/config.toml @@ -27,7 +27,7 @@ disableKinds = ["taxonomy", "term"] # Google Analytics [services.googleAnalytics] -id = "UA-149338238-3" +id = "G-60C6Q1ETC1" # Mounts [module] diff --git a/daprdocs/content/en/concepts/resiliency-concept.md b/daprdocs/content/en/concepts/resiliency-concept.md new file mode 100644 index 000000000..7b8cbe675 --- /dev/null +++ b/daprdocs/content/en/concepts/resiliency-concept.md @@ -0,0 +1,39 @@ +--- +type: docs +title: "Resiliency" +linkTitle: "Resiliency" +weight: 400 +description: "Configure policies and monitor app and sidecar health" +--- + +Distributed applications are commonly comprised of many microservices, with dozens - sometimes hundreds - of instances scaling across underlying infrastructure. As these distributed solutions grow in size and complexity, the potential for system failures inevitably increases. Service instances can fail or become unresponsive due to any number of issues, including hardware failures, unexpected throughput, or application lifecycle events, such as scaling out and application restarts. Designing and implementing a self-healing solution with the ability to detect, mitigate, and respond to failure is critical. + +## Resiliency Policies +Diagram showing the resiliency applied to Dapr APIs + +Dapr provides a capability for defining and applying fault tolerance resiliency policies to your application. You can define policies for following resiliency patterns: + +- Timeouts +- Retries/back-offs +- Circuit breakers + +These policies can be applied to any Dapr API calls when calling components with a [resiliency spec]({{< ref resiliency-overview >}}). + +## App Health Checks +Diagram showing the app health feature. Running Dapr with app health enabled causes Dapr to periodically probe the app for its health + +Applications can become unresponsive for a variety of reasons. For example, they are too busy to accept new work, could have crashed, or be in a deadlock state. Sometimes the condition can be transitory or persistent. + +Dapr provides a capability for monitoring app health through probes that check the health of your application and react to status changes. When an unhealthy app is detected, Dapr stops accepting new work on behalf of the application. + +Read more on how to apply [app health checks]({{< ref app-health >}}) to your application. + +## Sidecar Health Checks +Diagram showing the app health feature. Running Dapr with app health enabled causes Dapr to periodically probe the app for its health + +Dapr provides a way to determine its health using an [HTTP `/healthz` endpoint]({{< ref health_api.md >}}). With this endpoint, the *daprd* process, or sidecar, can be: + +- Probed for its health +- Determined for readiness and liveness + +Read more on about how to apply [dapr health checks]({{< ref sidecar-health >}}) to your application. diff --git a/daprdocs/content/en/developing-applications/building-blocks/observability/sidecar-health.md b/daprdocs/content/en/developing-applications/building-blocks/observability/sidecar-health.md index 7d8027dc8..9385473dd 100644 --- a/daprdocs/content/en/developing-applications/building-blocks/observability/sidecar-health.md +++ b/daprdocs/content/en/developing-applications/building-blocks/observability/sidecar-health.md @@ -6,7 +6,7 @@ weight: 200 description: Dapr sidecar health checks --- -Dapr provides a way to [determine its health using an [HTTP `/healthz` endpoint]({{< ref health_api.md >}}). With this endpoint, the *daprd* process, or sidecar, can be: +Dapr provides a way to determine its health using an [HTTP `/healthz` endpoint]({{< ref health_api.md >}}). With this endpoint, the *daprd* process, or sidecar, can be: - Probed for its health - Determined for readiness and liveness diff --git a/daprdocs/content/en/developing-applications/integrations/Azure/authenticating-azure.md b/daprdocs/content/en/developing-applications/integrations/Azure/authenticating-azure.md index fb08ee089..93e0e374c 100644 --- a/daprdocs/content/en/developing-applications/integrations/Azure/authenticating-azure.md +++ b/daprdocs/content/en/developing-applications/integrations/Azure/authenticating-azure.md @@ -84,7 +84,7 @@ To start, create a new Azure AD application, which will also be used as Service Prerequisites: -- [Azure Subscription](https://azure.microsoft.com/free/) +- Azure Subscription - [Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli) - [jq](https://stedolan.github.io/jq/download/) - OpenSSL (included by default on all Linux and macOS systems, as well as on WSL) diff --git a/daprdocs/content/en/developing-applications/integrations/Azure/azure-kubernetes-service-extension.md b/daprdocs/content/en/developing-applications/integrations/Azure/azure-kubernetes-service-extension.md index 1eefc1181..04055ffdd 100644 --- a/daprdocs/content/en/developing-applications/integrations/Azure/azure-kubernetes-service-extension.md +++ b/daprdocs/content/en/developing-applications/integrations/Azure/azure-kubernetes-service-extension.md @@ -7,7 +7,7 @@ weight: 4000 --- # Prerequisites -- [Azure subscription](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) +- Azure subscription - [Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli-windows?tabs=azure-cli) and the ***aks-preview*** extension. - [Azure Kubernetes Service (AKS) cluster](https://docs.microsoft.com/azure/aks/tutorial-kubernetes-deploy-cluster?tabs=azure-cli) diff --git a/daprdocs/content/en/getting-started/tutorials/configure-state-pubsub.md b/daprdocs/content/en/getting-started/tutorials/configure-state-pubsub.md index df08db4ca..7e394d708 100644 --- a/daprdocs/content/en/getting-started/tutorials/configure-state-pubsub.md +++ b/daprdocs/content/en/getting-started/tutorials/configure-state-pubsub.md @@ -64,9 +64,7 @@ For Kubernetes: {{% /codetab %}} {{% codetab %}} - -Verify you have an [Azure subscription](https://azure.microsoft.com/free/). - +Verify you have an Azure subscription. 1. Open and log into the [Azure portal](https://ms.portal.azure.com/#create/Microsoft.Cache) to start the Azure Redis Cache creation flow. 1. Fill out the necessary information. diff --git a/daprdocs/content/en/operations/resiliency/resiliency-overview.md b/daprdocs/content/en/operations/resiliency/resiliency-overview.md index bbca61db5..fea52eca2 100644 --- a/daprdocs/content/en/operations/resiliency/resiliency-overview.md +++ b/daprdocs/content/en/operations/resiliency/resiliency-overview.md @@ -9,8 +9,6 @@ description: "Configure Dapr retries, timeouts, and circuit breakers" Resiliency is currently a preview feature. Before you can utilize a resiliency spec, you must first [enable the resiliency preview feature]({{< ref support-preview-features >}}). {{% /alert %}} -Distributed applications are commonly comprised of many microservices, with dozens, even hundreds, of instances for any given application. With so many microservices, the likelihood of a system failure increases. For example, an instance can fail or be unresponsive due to hardware, an overwhelming number of requests, application restarts/scale outs, or several other reasons. These events can cause a network call between services to fail. Designing and implementing your application with fault tolerance, the ability to detect, mitigate, and respond to failures, allows your application to recover to a functioning state and become self healing. - Dapr provides a capability for defining and applying fault tolerance resiliency policies via a [resiliency spec]({{< ref "resiliency-overview.md#complete-example-policy" >}}). Resiliency specs are saved in the same location as components specs and are applied when the Dapr sidecar starts. The sidecar determines how to apply resiliency policies to your Dapr API calls. In self-hosted mode, the resiliency spec must be named `resiliency.yaml`. In Kubernetes Dapr finds the named resiliency specs used by your application. Within the resiliency spec, you can define policies for popular resiliency patterns, such as: - [Timeouts]({{< ref "policies.md#timeouts" >}}) diff --git a/daprdocs/content/en/operations/support/support-release-policy.md b/daprdocs/content/en/operations/support/support-release-policy.md index 0a3fb4917..2da2fdd50 100644 --- a/daprdocs/content/en/operations/support/support-release-policy.md +++ b/daprdocs/content/en/operations/support/support-release-policy.md @@ -34,6 +34,7 @@ The table below shows the versions of Dapr releases that have been tested togeth | Release date | Runtime | CLI | SDKs | Dashboard | Status | |--------------------|:--------:|:--------|---------|---------|---------| +| November 4th 2022 | 1.9.3
| 1.9.1 | Java 1.7.0
Go 1.6.0
PHP 1.1.0
Python 1.8.3
.NET 1.9.0
JS 2.4.2 | 0.11.0 | Supported (current) | | November 1st 2022 | 1.9.2
| 1.9.1 | Java 1.7.0
Go 1.6.0
PHP 1.1.0
Python 1.8.1
.NET 1.9.0
JS 2.4.2 | 0.11.0 | Supported (current) | | October 26th 2022 | 1.9.1
| 1.9.1 | Java 1.7.0
Go 1.6.0
PHP 1.1.0
Python 1.8.1
.NET 1.9.0
JS 2.4.2 | 0.11.0 | Supported | | October 13th 2022 | 1.9.0
| 1.9.1 | Java 1.7.0
Go 1.6.0
PHP 1.1.0
Python 1.8.3
.NET 1.9.0
JS 2.4.2 | 0.11.0 | Supported | @@ -74,21 +75,18 @@ General guidance on upgrading can be found for [self hosted mode]({{< ref self-h | Current Runtime version | Must upgrade through | Target Runtime version | |--------------------------|-----------------------|------------------------- | -| 1.4.0 to 1.4.2 | N/A | 1.4.4 | -| | 1.4.4 | 1.5.2 | -| | 1.5.2 | 1.6.0 | -| | 1.6.0 | 1.6.2 | -| | 1.6.0 | 1.7.4 | -| | 1.6.0 | 1.7.5 | | 1.5.0 to 1.5.2 | N/A | 1.6.0 | | | 1.6.0 | 1.6.2 | -| | 1.6.0 | 1.7.4 | -| | 1.6.0 | 1.7.5 | -| 1.6.0 | N/A | 1.6.2 | -| 1.6.0 | N/A | 1.7.5 | -| 1.7.0 to 1.7.5 | N/A | 1.8.0 | -| 1.8.0 | N/A | 1.8.6 | -| 1.9.0 | N/A | 1.9.2 | +| | 1.6.2 | 1.7.5 | +| | 1.7.5 | 1.8.6 | +| | 1.8.6 | 1.9.3 | +| 1.6.0 to 1.6.2 | N/A | 1.7.5 | +| | 1.7.5 | 1.8.6 | +| | 1.8.6 | 1.9.3 | +| 1.7.0 to 1.7.5 | N/A | 1.8.6 | +| | 1.8.6 | 1.9.3 | +| 1.8.0 to 1.8.6 | N/A | 1.9.3 | +| 1.9.0 | N/A | 1.9.3 | ## Breaking changes and deprecations diff --git a/daprdocs/content/en/reference/components-reference/supported-bindings/eventgrid.md b/daprdocs/content/en/reference/components-reference/supported-bindings/eventgrid.md index d422a19c7..a7f9a3c99 100644 --- a/daprdocs/content/en/reference/components-reference/supported-bindings/eventgrid.md +++ b/daprdocs/content/en/reference/components-reference/supported-bindings/eventgrid.md @@ -44,7 +44,7 @@ spec: - name: accessKey value: "[AccessKey]" - name: topicEndpoint - value: "[TopicEndpoint] + value: "[TopicEndpoint]" ``` {{% alert title="Warning" color="warning" %}} @@ -102,7 +102,7 @@ _Make sure to also to add quotes around the `[HandshakePort]` in your Event Grid ```bash # Using random port 9000 as an example -ngrok http -host-header=localhost 9000 +ngrok http --host-header=localhost 9000 ``` - Configure the ngrok's HTTPS endpoint and custom port to input binding metadata diff --git a/daprdocs/content/en/reference/components-reference/supported-secret-stores/aws-secret-manager.md b/daprdocs/content/en/reference/components-reference/supported-secret-stores/aws-secret-manager.md index 4c21f190f..e57aece7b 100644 --- a/daprdocs/content/en/reference/components-reference/supported-secret-stores/aws-secret-manager.md +++ b/daprdocs/content/en/reference/components-reference/supported-secret-stores/aws-secret-manager.md @@ -2,7 +2,7 @@ type: docs title: "AWS Secrets Manager" linkTitle: "AWS Secrets Manager" -description: Detailed information on the decret store component +description: Detailed information on the secret store component aliases: - "/operations/components/setup-secret-store/supported-secret-stores/aws-secret-manager/" --- diff --git a/daprdocs/content/en/reference/components-reference/supported-secret-stores/azure-keyvault.md b/daprdocs/content/en/reference/components-reference/supported-secret-stores/azure-keyvault.md index 9c1f63bd7..ce2e801f4 100644 --- a/daprdocs/content/en/reference/components-reference/supported-secret-stores/azure-keyvault.md +++ b/daprdocs/content/en/reference/components-reference/supported-secret-stores/azure-keyvault.md @@ -53,7 +53,7 @@ Additionally, you must provide the authentication fields as explained in the [Au ### Prerequisites -- [Azure Subscription](https://azure.microsoft.com/free/) +- Azure Subscription - [Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli) - [jq](https://stedolan.github.io/jq/download/) - The scripts below are optimized for a bash or zsh shell diff --git a/daprdocs/layouts/shortcodes/dapr-latest-version.html b/daprdocs/layouts/shortcodes/dapr-latest-version.html index db415d450..05f5194a4 100644 --- a/daprdocs/layouts/shortcodes/dapr-latest-version.html +++ b/daprdocs/layouts/shortcodes/dapr-latest-version.html @@ -1 +1 @@ -{{- if .Get "short" }}1.9{{ else if .Get "long" }}1.9.0{{ else if .Get "cli" }}1.9.0{{ else }}1.9.0{{ end -}} +{{- if .Get "short" }}1.9{{ else if .Get "long" }}1.9.3{{ else if .Get "cli" }}1.9.0{{ else }}1.9.3{{ end -}} diff --git a/daprdocs/static/images/resiliency_diagram.png b/daprdocs/static/images/resiliency_diagram.png new file mode 100644 index 000000000..8c7168f0e Binary files /dev/null and b/daprdocs/static/images/resiliency_diagram.png differ diff --git a/daprdocs/static/images/sidecar-health.png b/daprdocs/static/images/sidecar-health.png new file mode 100644 index 000000000..a8aa6819a Binary files /dev/null and b/daprdocs/static/images/sidecar-health.png differ