Configuration
Requirements: Dapr 1.18+ with mTLS enabled. .NET 10.0 SDK.
The WorkManager and the WorkManager.Runtime read their settings from
environment variables and command-line arguments (command line wins). Both
share this host setup (HostSetup in Virtufin.WorkManager.Shared).
Both services
| Setting | Description | Default |
|---|---|---|
HttpPort / --http-port |
HTTP/1.1 port: /health, /healthz, /ready |
5001 |
GrpcPort / --grpc-port |
gRPC port (HTTP/2, plain text) | 5002 |
Logging:LogLevel:Default / --log-level / -l |
Minimum log level (Trace … None) |
Information |
VIRTUFIN_API_HOST / VIRTUFIN_API_GRPC_PORT |
The virtufin API (State, Pubsub, Trigger) | localhost / 5002 |
VIRTUFIN_API_KEY |
Key sent to the API (it rejects every non-health call once it has keys) | none |
VIRTUFIN_REGISTRY_USER / VIRTUFIN_REGISTRY_TOKEN |
The org registry credential (the virtufin named credential, Virtufin.* dependencies) |
none |
WorkManager
| Setting | Description | Default |
|---|---|---|
ALLOWED_CODE_SOURCE_HOSTS (or AllowedCodeSourceHosts) |
Comma-separated host allow-list for code source URLs; empty allows any host that doesn't resolve to a private address. See Security. | empty |
RUNTIME_WORKER_POKE_INTERVAL_SECONDS |
How often running workers' Runtime actors are poked (reactivating a deactivated one). Floored at 30. | 60 |
WorkManager.Runtime
| Setting | Description | Default |
|---|---|---|
DAPR_GRPC_PORT |
The pod's daprd gRPC port (set by the sidecar injector), for the worker secret store | 50001 |
LIBRARY_UPDATE_POLL_SECONDS |
How often DotNetDll and C# source workers' Virtufin.* NuGet dependencies, TypeScript workers' @virtufin/* npm packages and wheel workers' virtufin-* PyPI packages are re-checked; a newer release reloads the worker. 0 disables. |
300 |
DOTNET_DEFAULT_NUGET_SOURCE_URL |
The public NuGet source for third-party worker dependencies | nuget.org |
Worker secrets have their own settings; see Worker Secrets.
WORKER_SECRETS_TTL_SECONDS (default 60) also bounds how stale a worker's
IWorkerContext.GetSecretsAsync() can be, so it is how long a rotated Secret
takes to reach a reconnecting worker.
Examples
export HttpPort=3000
./Virtufin.WorkManager --grpc-port 3002 --log-level Debug