Errors & Redeployment
Build failures are a normal part of scenario development. Rogue Architect’s checkpoint system lets you recover from errors without rebuilding from scratch.
When a Build Errors
Section titled “When a Build Errors”When a plugin fails, the behavior depends on your Continue on Error setting:
- Continue on Error OFF — The build stops immediately at the failed plugin. The status badge turns red.
- Continue on Error ON — The build continues executing remaining plugins. Failed plugins show as errored, but the build keeps going. This is useful for identifying all issues in a single build run.
In both cases, errored plugins appear with a red indicator in the Machine Build Progress panel, and error events appear in the Build Logs.
Understanding the Error
Section titled “Understanding the Error”To diagnose a failure:
- Check the event log — The Build Logs panel shows which plugin failed and on which machine
- Open the machine — Click the machine on the canvas to see per-plugin status
- Read the Ansible output — Click the log button on the errored plugin to see the full Ansible log with error details
- Use verbose logs — If the error isn’t clear, consider redeploying with Verbose Logging enabled for more detail
Redeploying from a Checkpoint
Section titled “Redeploying from a Checkpoint”The Redeploy feature lets you revert your VMs to the last successful checkpoint and try again:
- Click Redeploy in the bottom progress bar
- The system runs pre-checks and analyzes your deployment
- A Checkpoint Info card shows:
- The checkpoint name and when it was taken
- How many minutes of build time will be replayed
- Whether a full rebuild is needed or a partial recovery is possible
- Configure build options (Continue on Error, Verbose Logging, Snapshot Interval)
- Click Redeploy to start
The system reverts all VMs to the checkpoint snapshot and resumes building from that point. Any plugins that ran after the checkpoint will re-execute.
Canvas Divergence Warning
Section titled “Canvas Divergence Warning”If you modify your canvas after a build (adding plugins, changing params, etc.), a pulsing amber warning icon appears in the bottom progress bar:
Canvas changed since last build. Click Redeploy to deploy from your last clean point.
This tells you that your canvas no longer matches the built infrastructure. Use Redeploy to apply your changes.
Removing a Build
Section titled “Removing a Build”If you want to start completely fresh, click Remove Build in the bottom progress bar. This:
- Tears down all deployed infrastructure
- Returns the canvas to design mode
- Lets you make changes and start a new build from scratch