docs: Graduate Component HotReloading to GA#5162
Open
javier-aliaga wants to merge 5 commits into
Open
Conversation
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>
javier-aliaga
force-pushed
the
docs/hotreload-ga
branch
from
e144be0 to
d23df25
Compare
msfussell
reviewed
May 23, 2026
Member
msfussell
left a comment
msfussell
left a comment
There was a problem hiding this comment.
@javier-aliaga. Reviewed. Additional changes needed
- You need to update the https://docs.dapr.io/operations/configuration/configuration-overview/ application configuration section to add the hot reload feature into the list and then reference it here.
- You also need to update https://docs.dapr.io/reference/resource-specs/configuration-schema/
- Same as the pub/sub you should add a note about HTTPEndpoint hot reloading into this topic https://docs.dapr.io/developing-applications/building-blocks/service-invocation/howto-invoke-non-dapr-endpoints/
| ## Hot Reloading | ||
|
|
||
| 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. | ||
| 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" %}}). |
Member
There was a problem hiding this comment.
Suggested change
| 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" %}}). | |
| 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" %}}). |
| ## Hot Reloading | ||
|
|
||
| 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. | ||
| 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" %}}). |
Member
There was a problem hiding this comment.
We cannot have a feature that does not work on Windows. This has to be fixed.
Also Are you saying the just Configuration resources uses SIGHUP, or that any hot reloading does not work on Windows.
Member
There was a problem hiding this comment.
If this works on Windows and Linux, no need to talk about the implementation in the docs. Just say
"Changes to Configuration resources are automatically detected and trigger a graceful restart of the Dapr sidecar to apply the new configuration. To opt out, disable the HotReload feature in the [Dapr application configuration]({{% ref "configuration-overview.md" %}})"
You need to update the https://docs.dapr.io/operations/configuration/configuration-overview/ application configuration section to add the hot reload feature into the list and then reference it here.
| ## Hot Reloading | ||
|
|
||
| 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. | ||
| 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" %}}). |
Member
There was a problem hiding this comment.
Suggested change
| 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" %}}). | |
| Changes to Resiliency resources are automatically detected and trigger a graceful restart of the Dapr sidecar to apply the updated resiliency policies. Unchanged Resiliency resources are silently ignored.. To opt out, disable the `HotReload` feature in the [Dapr Resiliency]({{% ref "configuration-overview.md" %}}). |
Member
There was a problem hiding this comment.
Same here. This has to be fixed for Windows. Cannot release otherwise.
| ## Hot Reloading | ||
|
|
||
| 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. | ||
| 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" %}}). |
Member
There was a problem hiding this comment.
Suggested change
| 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" %}}). | |
| Changes to Resiliency resources are automatically detected and trigger a graceful restart of the Dapr sidecar to apply the updated resiliency policies. To opt out, disable the `HotReload` feature in the [Dapr application configuration]({{% ref "configuration-overview.md" %}}). |
Member
There was a problem hiding this comment.
You need to update the https://docs.dapr.io/operations/configuration/configuration-overview/ application configuration section to add the hot reload feature into the list and then reference it here.
msfussell
changed the title
msfussell
reviewed
May 25, 2026
| ### Configurations, Resiliency, and HTTPEndpoints | ||
|
|
||
| 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. | ||
| The Dapr sidecar also reloads [Configuration]({{% ref "configuration-overview.md" %}}), [Resiliency]({{% ref "resiliency-overview.md" %}}), and [HTTPEndpoint]({{% ref "service-invocation-overview.md" %}}) resources. |
Member
There was a problem hiding this comment.
Suggested change
| The Dapr sidecar also reloads [Configuration]({{% ref "configuration-overview.md" %}}), [Resiliency]({{% ref "resiliency-overview.md" %}}), and [HTTPEndpoint]({{% ref "service-invocation-overview.md" %}}) resources. | |
| The Dapr sidecar also reloads [Configuration]({{% ref "configuration-overview.md" %}}), [Resiliency]({{% ref "resiliency-overview.md" %}}), WorkflowAccessPolicy({{% ref "workflow-access-policy.md" %}}) and [HTTPEndpoint]({{% ref "service-invocation-overview.md" %}}) resources. |
Contributor
Author
There was a problem hiding this comment.
@msfussell I cannot find the workflow-access-policy.md file, they are still pending to be merged https://github.com/dapr/docs/pull/5114/changes , I will add the reference but it will not work until the other one is merged
kit uses a named pipe on Windows, so the SIGHUP-not-supported caveats were misleading. Drop them. Signed-off-by: Javier Aliaga <javier@diagrid.io>
Co-authored-by: Mark Fussell <markfussell@gmail.com> Signed-off-by: Javier Aliaga <javier@diagrid.io>
Signed-off-by: Javier Aliaga <javier@diagrid.io>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.
Thank you for helping make the Dapr documentation better!
Please follow this checklist before submitting:
In addition, please fill out the following to help reviewers understand this pull request:
Description
Issue reference