Skip to content

file-replicator

EdgeCommons sink component (Rust) that watches local directories and replicates files to one or more destinations — another local directory, S3, and — behind optional build features — SFTP/FTPS, HTTP(S), Azure Blob and GCS — either as files arrive (default) or on a cron schedule/window. It handles source lifecycle on completion (delete / archive / quarantine), retries with resumable partial uploads, throttles bandwidth, can be activated/deactivated per instance from the control plane, and publishes granular status events on a unified namespace for realtime UIs. Runs standalone (HOST), on Greengrass (IPC), and on Kubernetes (ConfigMap) via the edgecommons library.

These docs are validated against src/. The deep design rationale lives in DESIGN.md in the repo root.

If you want to… Read
Learn by doing (first replication) Tutorial
Accomplish a specific task How-to guides
Copy a complete, annotated config Sample configurations
Understand the design & concepts Explanation
Look up every config field Reference › Configuration
Integrate with control/events Reference › Messaging interface
Interpret emitted metrics Reference › Metrics
Compare destination backends + every field Reference › Destinations
Parse get-status + event context payloads Reference › Data types