DeployerPHP (Observer Tier)
Use this skill to inspect state only. Do not modify infrastructure.
Execution Protocol
- Run commands in non-interactive form with explicit options.
- Read inventory before interpreting server state.
- Use only read-only commands in this tier.
- If mutation is required, stop and ask the user to run an admin-tier workflow.
Required Context
Set concrete values before running commands:
PROJECT_ROOT="/path/to/project"
ENV_FILE="$PROJECT_ROOT/.env"
INVENTORY_FILE="$PROJECT_ROOT/.deployer/inventory.yml"
SERVER="production"
SITE="example.com"
References
- Inventory schema:
.deployer/inventory.yml - Command catalog:
deployer list --raw - Command reference:
deployer help server:info - Command reference:
deployer help server:logs
Non-Interactive Command Reference
| Command | Reference | Complete non-interactive example |
|---|---|---|
server:info |
deployer help server:info |
deployer server:info --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
server:logs (system/services) |
deployer help server:logs |
deployer server:logs --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --service="system,nginx,php8.3-fpm" --lines=200 |
server:logs (site scope) |
deployer help server:logs |
deployer server:logs --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --site="$SITE" --lines=200 |
server:logs (aggregate) |
deployer help server:logs |
deployer server:logs --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --service="all-sites,all-crons,all-supervisors" --lines=200 |
Log Source Reference
Use these values with --service on server:logs:
systemnginxphp8.3-fpm(or installed PHP-FPM service name)mariadb,postgresqlredis,memcachedsupervisorcron<domain>cron:<domain>/<script>supervisor:<domain>/<program>all-sitesall-cronsall-supervisors
Forbidden Commands In Observer Tier
server:run- All provisioning, deployment, lifecycle, and delete commands
server:sshandsite:ssh
Standard Observation Workflow
- Read
.deployer/inventory.yml. - Run
server:infofor target server. - Run
server:logswith focused--serviceor--sitefilters. - Return findings and recommended next command for a human/admin-tier agent.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.