You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Reflect dapr/dapr#9577 and dapr/dapr#9811: HotReload is on by default
in v1.18. Remove the preview rows and update prose to default-on with
an opt-out note.
Signed-off-by: Javier Aliaga <javier@diagrid.io>
Copy file name to clipboardExpand all lines: daprdocs/content/en/concepts/components-concept.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -54,7 +54,7 @@ For more information read [Pluggable components overview]({{% ref "pluggable-com
54
54
55
55
## Hot Reloading
56
56
57
-
With the [`HotReload` feature enabled]({{% ref "support-preview-features" %}}), components are able to be "hot reloaded" at runtime.
57
+
Since Dapr v1.18, components are "hot reloaded" at runtime by default. To opt out, disable the `HotReload` feature in the [Dapr application configuration]({{% ref "preview-features.md" %}}).
58
58
This means that you can update component configuration without restarting the Dapr runtime.
59
59
Component reloading occurs when a component resource is created, updated, or deleted, either in the Kubernetes API or in self-hosted mode when a file is changed in the `resources` directory.
60
60
When a component is updated, the component is first closed, and then reinitialized using the new configuration.
Copy file name to clipboardExpand all lines: daprdocs/content/en/developing-applications/building-blocks/pubsub/howto-publish-subscribe.md
+8-3Lines changed: 8 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -188,9 +188,14 @@ The example above shows an event subscription to topic `orders`, for the pubsub
188
188
Place `subscription.yaml` in the same directory as your `pubsub.yaml` component. When Dapr starts up, it loads subscriptions along with the components.
189
189
190
190
{{% alert title="Note" color="primary" %}}
191
-
This feature is currently in preview.
192
-
Dapr can be made to "hot reload" declarative subscriptions, whereby updates are picked up automatically without needing a restart.
193
-
This is enabled by via the [`HotReload` feature gate]({{% ref "support-preview-features" %}}).
191
+
Since Dapr v1.18, declarative subscriptions are "hot reloaded" by default, whereby updates are picked up automatically without needing a restart. To opt out, disable the `HotReload` feature in the Dapr application configuration:
192
+
193
+
```yaml
194
+
spec:
195
+
features:
196
+
- name: HotReload
197
+
enabled: false
198
+
```
194
199
To prevent reprocessing or loss of unprocessed messages, in-flight messages between Dapr and your application are unaffected during hot reload events.
Copy file name to clipboardExpand all lines: daprdocs/content/en/developing-applications/building-blocks/pubsub/pubsub-overview.md
+2-3Lines changed: 2 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -87,9 +87,8 @@ For more information, read [about the subscriptions in Subscription Types]({{% r
87
87
88
88
### Reloading topic subscriptions
89
89
90
-
To reload topic subscriptions that are defined programmatically or declaratively, the Dapr sidecar needs to be restarted.
91
-
The Dapr sidecar can be made to dynamically reload changed declarative topic subscriptions without restarting by enabling the [`HotReload` feature gate]({{% ref "support-preview-features" %}}).
92
-
Hot reloading of topic subscriptions is currently a preview feature.
90
+
Programmatic topic subscriptions require the Dapr sidecar to be restarted in order to be reloaded.
91
+
Since Dapr v1.18, the Dapr sidecar dynamically reloads changed declarative topic subscriptions without restarting. This is enabled by default; to opt out, disable the `HotReload` feature in the [Dapr application configuration]({{% ref "preview-features.md" %}}).
93
92
In-flight messages are unaffected when reloading a subscription.
Copy file name to clipboardExpand all lines: daprdocs/content/en/developing-applications/building-blocks/pubsub/subscription-methods.md
+8-3Lines changed: 8 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,9 +21,14 @@ The examples below demonstrate pub/sub messaging between a `checkout` app and an
21
21
### Declarative subscriptions
22
22
23
23
{{% alert title="Note" color="primary" %}}
24
-
This feature is currently in preview.
25
-
Dapr can be made to "hot reload" declarative subscriptions, whereby updates are picked up automatically without needing a restart.
26
-
This is enabled by via the [`HotReload` feature gate]({{% ref "support-preview-features" %}}).
24
+
Since Dapr v1.18, declarative subscriptions are "hot reloaded" by default, whereby updates are picked up automatically without needing a restart. To opt out, disable the `HotReload` feature in the Dapr application configuration:
25
+
26
+
```yaml
27
+
spec:
28
+
features:
29
+
- name: HotReload
30
+
enabled: false
31
+
```
27
32
To prevent reprocessing or loss of unprocessed messages, in-flight messages between Dapr and your application are unaffected during hot reload events.
Copy file name to clipboardExpand all lines: daprdocs/content/en/operations/components/component-updates.md
+8-12Lines changed: 8 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,29 +6,25 @@ weight: 300
6
6
description: "Updating deployed components, configurations, resiliency, and HTTPEndpoints used by applications"
7
7
---
8
8
9
-
When making an update to an existing deployed component used by an application, Dapr does not update the component automatically unless the [`HotReload`](#hot-reloading-preview-feature) feature gate is enabled.
10
-
The Dapr sidecar needs to be restarted in order to pick up the latest version of the component.
11
-
How this is done depends on the hosting environment.
9
+
Since Dapr v1.18, updates to deployed resources (Components, Subscriptions, Configurations, Resiliency, and HTTPEndpoints) are picked up automatically by the sidecar via [hot reloading](#hot-reloading). Hot reloading is enabled by default; to opt out, disable the `HotReload` feature in the [Dapr application configuration]({{% ref "preview-features.md" %}}).
10
+
When hot reloading is disabled, the Dapr sidecar needs to be restarted in order to pick up the latest version of the resource. How this is done depends on the hosting environment.
12
11
13
12
### Kubernetes
14
13
15
-
When running in Kubernetes, the process of updating a component involves two steps:
14
+
When hot reloading is disabled and running in Kubernetes, the process of updating a component involves two steps:
16
15
17
16
1. Apply the new component YAML to the desired namespace
18
-
1.Unless the [`HotReload` feature gate is enabled](#hot-reloading-preview-feature), perform a [rollout restart operation](https://kubernetes.io/docs/reference/kubectl/cheatsheet/#updating-resources) on your deployments to pick up the latest component
17
+
1.Perform a [rollout restart operation](https://kubernetes.io/docs/reference/kubectl/cheatsheet/#updating-resources) on your deployments to pick up the latest component
19
18
20
19
### Self Hosted
21
20
22
-
Unless the [`HotReload` feature gate is enabled](#hot-reloading-preview-feature), the process of updating a component involves a single step of stopping and restarting the `daprd` process to pick up the latest component.
21
+
When hot reloading is disabled, the process of updating a component involves a single step of stopping and restarting the `daprd` process to pick up the latest component.
23
22
24
23
> **Note:** On POSIX-compatible systems (Linux, macOS), you can also send a `SIGHUP` signal to the `daprd` process to reload the runtime in-process without fully restarting it. See [Reloading configuration with SIGHUP]({{% ref "configuration-overview.md#reloading-configuration-with-sighup" %}}) for more information.
25
24
26
-
## Hot Reloading (Preview Feature)
25
+
## Hot Reloading
27
26
28
-
> This feature is currently in [preview]({{% ref "preview-features.md" %}}).
29
-
> Hot reloading is enabled via the [`HotReload` feature gate]({{% ref "support-preview-features.md" %}}).
30
-
31
-
Dapr can be made to "hot reload" resources whereby updates are picked up automatically without the need to manually restart the Dapr sidecar process or Kubernetes pod.
27
+
Dapr "hot reloads" resources whereby updates are picked up automatically without the need to manually restart the Dapr sidecar process or Kubernetes pod.
32
28
33
29
### Components and Subscriptions
34
30
@@ -53,7 +49,7 @@ Any create, update, or deletion of these component types is ignored by the sidec
53
49
54
50
### Configurations, Resiliency, and HTTPEndpoints
55
51
56
-
With the `HotReload` feature gate enabled, the Dapr sidecar also supports reloading[Configuration]({{% ref "configuration-overview.md" %}}), [Resiliency]({{% ref "resiliency-overview.md" %}}), and [HTTPEndpoint]({{% ref "service-invocation-overview.md" %}}) resources.
52
+
The Dapr sidecar also reloads[Configuration]({{% ref "configuration-overview.md" %}}), [Resiliency]({{% ref "resiliency-overview.md" %}}), and [HTTPEndpoint]({{% ref "service-invocation-overview.md" %}}) resources.
57
53
58
54
Unlike Components and Subscriptions which are reloaded in-place, changes to these resource types trigger an automatic **graceful restart** of the Dapr sidecar process (via SIGHUP). This ensures that the new configuration is applied cleanly. Unchanged resources are detected and silently ignored, so a restart only occurs when an actual change is detected.
Copy file name to clipboardExpand all lines: daprdocs/content/en/operations/configuration/configuration-overview.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -447,7 +447,7 @@ spec:
447
447
448
448
## Hot Reloading
449
449
450
-
When the [`HotReload` feature gate]({{% ref "support-preview-features" %}}) is enabled, changes to Configuration resources are automatically detected and trigger a graceful restart of the Dapr sidecar (via SIGHUP) to apply the new configuration. Unchanged Configuration resources are silently ignored. SIGHUP is not supported on Windows.
450
+
Since Dapr v1.18, changes to Configuration resources are automatically detected and trigger a graceful restart of the Dapr sidecar (via SIGHUP) to apply the new configuration. Unchanged Configuration resources are silently ignored. SIGHUP is not supported on Windows. To opt out, disable the `HotReload` feature in the [Dapr application configuration]({{% ref "preview-features.md" %}}).
451
451
452
452
See [Updating resources]({{% ref "component-updates.md" %}}) for more information.
Copy file name to clipboardExpand all lines: daprdocs/content/en/operations/resiliency/resiliency-overview.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -175,7 +175,7 @@ spec:
175
175
176
176
## Hot Reloading
177
177
178
-
When the [`HotReload` feature gate]({{% ref "support-preview-features" %}}) is enabled, changes to Resiliency resources are automatically detected and trigger a graceful restart of the Dapr sidecar (via SIGHUP) to apply the updated resiliency policies. Unchanged Resiliency resources are silently ignored. SIGHUP is not supported on Windows.
178
+
Since Dapr v1.18, changes to Resiliency resources are automatically detected and trigger a graceful restart of the Dapr sidecar (via SIGHUP) to apply the updated resiliency policies. Unchanged Resiliency resources are silently ignored. SIGHUP is not supported on Windows. To opt out, disable the `HotReload` feature in the [Dapr application configuration]({{% ref "preview-features.md" %}}).
179
179
180
180
See [Updating resources]({{% ref "component-updates.md" %}}) for more information.
Copy file name to clipboardExpand all lines: daprdocs/content/en/operations/support/support-preview-features.md
-3Lines changed: 0 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,8 +19,5 @@ For CLI there is no explicit opt-in, just the version that this was first made a
19
19
|**Multi-App Run for Kubernetes**| Configure multiple Dapr applications from a single configuration file and run from a single command on Kubernetes |`dapr run -k -f`|[Multi-App Run]({{% ref multi-app-dapr-run.md %}}) | v1.12 |
20
20
|**Cryptography**| Encrypt or decrypt data without having to manage secrets keys | N/A |[Cryptography concept]({{% ref "components-concept#cryptography" %}})| v1.11 |
21
21
|**Actor State TTL**| Allow actors to save records to state stores with Time To Live (TTL) set to automatically clean up old data. In its current implementation, actor state with TTL may not be reflected correctly by clients, read [Actor State Transactions]({{% ref actors_api.md %}}) for more information. |`ActorStateTTL`|[Actor State Transactions]({{% ref actors_api.md %}}) | v1.11 |
22
-
|**Component Hot Reloading**| Allows for Dapr-loaded components to be "hot reloaded". A component spec is reloaded when it is created/updated/deleted in Kubernetes or on file when running in self-hosted mode. Ignores changes to actor state stores and workflow backends. |`HotReload`|[Hot Reloading]({{% ref components-concept.md %}}) | v1.13 |
23
-
|**Subscription Hot Reloading**| Allows for declarative subscriptions to be "hot reloaded". A subscription is reloaded either when it is created/updated/deleted in Kubernetes, or on file in self-hosted mode. In-flight messages are unaffected when reloading. |`HotReload`|[Hot Reloading]({{% ref "subscription-methods.md#declarative-subscriptions" %}}) | v1.14 |
24
-
|**Configuration, Resiliency, and HTTPEndpoint Hot Reloading**| Changes to Configuration, Resiliency, and HTTPEndpoint resources are automatically detected and trigger a graceful restart of the Dapr sidecar via SIGHUP. Not supported on Windows. |`HotReload`|[Hot Reloading]({{% ref "component-updates.md" %}}) | v1.18 |
25
22
|**Workflows Clustered Deployment**| Enable Workflows to function when workflow clients communicate to multiple daprds of the same appID who are behind a loadbalancer. Only relevant when using [Dapr shared]({{% ref "kubernetes-dapr-shared" %}}) |`WorkflowsClusteredDeployment`|[Dapr Shared]({{% ref "kubernetes-dapr-shared" %}}) | v1.16 |
26
23
|**Workflows Durable Activity Results**| If set, ensures that activity results are durably sent to the owning workflow in multi-application scenarios, even when the owning workflow application is unavailable. Unless running multiple Dapr versions, this feature gate should be enabled. Disabled by default for backwards compatibility. |`WorkflowsRemoteActivityReminder`|[Multi-application Workflows]({{% ref "workflow-multi-app.md#durable-activity-results" %}}) | v1.17 |
0 commit comments