Troubleshooting / v0.1.10
Find the blocked step.
Start with the command's actual help and the worker logs. Use the same state directory for commands that inspect a worker's runs.
CLI can't find a command
Install the release into the active Python environment and invoke it as a module. The published package does not install a rookrunner executable:
python -m execution_core --helpPut --state STATE before a subcommand.
Worker does not start
- Confirm a Linux host, Python 3.11 or newer, and an available Docker Engine.
- Check that
--repositorypoints to the dedicated clone and the worker account can access Docker. - Use a private state directory. The worker creates the local socket and state permissions with restricted modes.
- If the worker reports an incompatible option combination, inspect the named settings. For example, Docker socket access with secrets or an app key has a startup probe requirement.
Job is refused or skipped
Read the run reason before retrying. The planner refuses unsupported workflow features. Polling also refuses forks, untrusted changes, or workflow-file changes by default. Review the specific code and the trust model before using a per-poll override.
Job has no network access
Containers default to --network none. Enable --network bridge only if the workflow requires outbound network access or service containers.
Runner image error
Workflow execution expects a digest-pinned image. The worker's --runner-image applies when every selected job uses literal runs-on: ubuntu-latest and no image was supplied at submit time. Rookrunner does not build or fetch the image.
Status page is unavailable
Confirm the status page process uses the worker's state directory. It binds to 127.0.0.1:8765; open it on the same host. It is not a network-accessible dashboard.
Inspect the run
python -m execution_core --state STATE list
python -m execution_core --state STATE get RUN_ID
python -m execution_core --state STATE logs RUN_IDFor release-specific behavior, read the v0.1.10 design notes and use the installed version's --help.