For the complete documentation index, see llms.txt. This page is also available as Markdown.

Hangfire (hangfire)

The Hangfire project's capability scope, deployment products, integration entrance and usage boundaries.

Connect persistent background jobs with framework scheduling contracts, suitable for delayed execution and periodic tasks. Job storage, execution process, and management interface respectively assume different responsibilities.

Item
value

source code directory

externals/hangfire

main bag

Zongsoft.Externals.Hangfire

Deployment and Usage Portal

Append the main package to the existing host's Deployment checklist, and retain the plugin list, assembly and ancillary running resources in the package:

Application.deploy (append fragment)
[plugins zongsoft externals hangfire]
nuget:Zongsoft.Externals.Hangfire

The business handler is mounted to /Workbench/Scheduler/Handlers. The delay or periodic scheduler is provided by the container, and the daemon plugin variant is responsible for the background server.

Optional products include Zongsoft.Externals.Hangfire.Storages.Redis and Zongsoft.Externals.Hangfire.Web. Redis job storage uses Hangfire connection; Web Dashboard is not responsible for performing tasks on behalf of the background server.

Integration Steps

  1. Prepare the job store and verify the daemon variants required to deploy the site.

  2. Register a stable handler name, schedule a short job according to the topic example, and observe the actual execution.

  3. Re-validation cycle time zone, repeated execution, failure retry and shutdown recovery.

For specific configuration, calling examples and related basic concepts, see Task Scheduling and Resilient Execution.

Project Boundaries

💡 Scheduling returns task identifiers, not business results. Persistent task parameters should use serializable business data; when changing handler names or parameter structures, old tasks in storage need to be taken into account.

Further Reading

Browse extensions by project · Task Scheduling and Resilient Execution · source code and project description

Last updated