Skip to main content

Data locality, sovereignty, bandwidth, and egress patterns

Data locality is a design decision about where inputs are accessed and work runs. Data sovereignty is broader: it concerns legal, contractual, operational, and technical controls around data. Bacalhau can help express compute placement through node labels and job constraints, but it cannot certify compliance or infer the location of a remote source.

Choose the pattern that matches the boundary

PatternUse it whenWhat to verify
Site-local processingA site hosts the data and computeNode labels, local access path, output location, and offline behavior
Region-scoped processingData and workers must stay within an approved regionStorage endpoint, DNS and network routes, credentials, and failover region
Object-store-adjacent processingLarge objects are reachable from selected workersActual byte transfer, IAM scope, result publisher, and cost model
Centralized processingA controlled central copy is acceptableIngest policy, egress cost, retention, and recovery objectives

Make placement explicit

Start a compute node with operator-maintained labels, then require them in the job:

bacalhau serve --compute -c Labels="residency=ca,site=toronto"

bacalhau docker run \
--constraints "residency=ca" \
--constraints "site=toronto" \
--input https://example.org/public-records.csv:/input/records.csv \
--output locality-results:/outputs \
--publisher local \
alpine:3.21 sh -c 'sha256sum /input/records.csv > /outputs/checksum.txt'

The command is intentionally simple: it proves that a constrained job can execute and publish an output. It does not prove that an HTTPS endpoint, container registry, log system, or operator workstation stayed in the same jurisdiction.

Controls that belong together

GoalBacalhau configurationComplementary control
Direct work to suitable nodesLabels and constraintsChange control for labels and capacity
Describe a data pathInput sources and tasksStorage IAM, network policy, and credential rotation
Retain artifacts safelyResult paths and a publisherEncryption, retention, and downstream authorization
Bound a workload lifecycleJob type and timeoutsMonitoring, incident response, and business continuity

Limitations and audit evidence

For each production job, retain the submitted specification, selected node, input and output endpoints, identities used, timing, and transfer measurements. Review these against your jurisdictional and contractual requirements. Bacalhau's architecture explains the scheduling components, while your organization remains responsible for the surrounding enforcement and evidence.