Workers
Manage Vortos long-running worker processes with package-discovered supervisor definitions.
Workers
Vortos packages can contribute worker process definitions. The Docker package exposes vortos:worker:* commands that list, install, and remove those definitions from docker/worker/supervisord.conf as managed supervisor blocks.
This gives projects an explicit, repeatable deployment step without forcing optional packages into every application.
Optional packages stay optional
Messaging is part of the framework baseline. SES, Object Store, and future packages such as payments only contribute workers when installed and registered.
Core Commands
php bin/console vortos:worker:list
php bin/console vortos:worker:install
php bin/console vortos:worker:install --worker=aws-ses-outbox-relay
php bin/console vortos:worker:remove aws-ses-outbox-relayRegistered Workers
Current package workers:
| Worker | Command | Package |
|---|---|---|
messaging-outbox-relay | php /var/www/html/bin/console vortos:outbox:relay | Messaging |
aws-ses-outbox-relay | php /var/www/html/bin/console vortos:ses:outbox:relay | AWS SES |
object-store-outbox-relay | php /var/www/html/bin/console vortos:object-store:relay | Object Store |
Documentation Map
Supervisor
How managed supervisor blocks are generated, updated, removed, and deployed.
Registered Workers
Worker definitions contributed by installed Vortos packages.
Operations
Deployment, reloads, monitoring, and scaling runbooks.
Troubleshooting
Diagnose missing workers, stale supervisor config, and process failures.
Why This Exists
Before package-level workers, every package had to document a supervisor snippet and every application had to manually merge it. That is error-prone at scale.
The worker registry centralizes:
- Discovering workers from installed packages.
- Rendering supervisor program blocks.
- Preserving unrelated supervisor config.
- Updating only Vortos-managed blocks.
- Supporting dry-run review before writing.
Install Everything Registered
php bin/console vortos:worker:installInstall one or more workers:
php bin/console vortos:worker:install --worker=aws-ses-outbox-relay --worker=object-store-outbox-relayPreview:
php bin/console vortos:worker:install --dry-run