1. Worker Operations
  2. Worker operations
Website
  • Worker operations
  • Kubernetes requirements
  • CPU and memory for workers and Jobs
  • Install a worker
  • Configure a worker
  • Scratch storage
  • Networking and egress
  • Worker security model
  • Worker health
  • Upgrade a worker
  • Troubleshooting

Worker operations

Prepare, install, secure, monitor, upgrade, and remove a RestoreTrust project worker in your Kubernetes cluster.

Loading documentation…

Kubernetes requirementsNext >

Powered by heyo

On this page

Operating modelRecommended operating sequence

A RestoreTrust project worker runs restore checks inside your Kubernetes cluster. It belongs to one RestoreTrust project, and schedules in that project select the worker that should run them.

The worker consists of:

  • one long-running agent Pod that connects outbound to RestoreTrust;
  • short-lived Kubernetes Jobs that download, restore, and validate backups;
  • one temporary scratch volume for each restore Job.

Backup downloads and restores run in your cluster. Source credential values and temporary restored databases stay there; the worker sends execution status, logs, probe results, and selected-file metadata to RestoreTrust. RestoreTrust sends the execution plan, and the worker creates and supervises the corresponding Kubernetes Job.

Operating model

AreaWhat you operate
KubernetesA supported cluster, two dedicated namespaces, RBAC, Pod Security admission, and NetworkPolicy enforcement
IdentityOne generated identity Secret and exactly one agent Pod for each worker
StorageA dynamic StorageClass and enough capacity for every concurrent restore
NetworkOutbound connectivity for the agent, image pulls, DNS, and the configured backup sources
LifecycleInstallation, health checks, generated Deployment upgrades, and cluster cleanup during uninstall

Restore Jobs run in a namespace separate from the agent and its identity Secret. They use a ServiceAccount without a Kubernetes API token or RBAC permissions. A namespace-wide egress floor allows DNS only; the worker adds a source-specific egress policy for each execution.

Do not scale the agent Deployment

A worker identity may be used by exactly one agent Pod. Keep replicas: 1, use the generated Recreate strategy, and increase Max parallel jobs for more capacity. To add another agent Pod, create another project worker with its own identity and namespace pair.

Recommended operating sequence

  1. Check the Kubernetes requirements.
  2. Install a worker from the manifests generated in the RestoreTrust console.
  3. Add local source and decryption Secrets to the job namespace.
  4. Configure scratch storage and network egress.
  5. Monitor the worker's health and capacity.
  6. Apply generated worker upgrades with a one-Pod Recreate rollout.
Project boundary

A schedule can select only a worker from the same project. Create source credentials and backup-encryption Secrets in that worker's job namespace; never place them in the agent namespace.

Related topics

  • Understand project workers
  • Check Kubernetes requirements
  • Install a worker
  • Troubleshoot a worker