Skip to main content

Distributed Scanning

Scale scanning across multiple worker nodes with centralized job orchestration.

Architecture​

[API/UI] → [Job Queue] → [Worker Pool] → [Shared Workspace]
                              ↓
                          Worker 1
                          Worker 2
                          Worker 3

Job Queue​

Supported backends:

  • Redis
  • PostgreSQL
  • Kafka

Configuration:

enterprise:
  distributed:
    enabled: true
    queue_backend: redis
    redis:
      host: redis.company.com
      port: 6379
      db: 0

Worker Configuration​

server:
  worker:
    mode: distributed
    queue_url: redis://redis.company.com:6379
    concurrency: 10
    heartbeat: 30s

Start worker:

pentora worker start --queue redis://redis:6379

Job Submission​

# Submit distributed job
pentora scan --targets 10.0.0.0/8 --distributed --workers 10

Worker Pools​

Organize workers by capability:

  • fast-pool: Quick scans
  • deep-pool: Comprehensive scans
  • compliance-pool: CIS/PCI checks
worker:
  pool: fast-pool
  tags: [fast, standard]

See Server Mode Deployment for setup.