NAME
run-integration.pl - blank-environment Docker integration runner for a host-built tarball
SYNOPSIS
perl /opt/integration/run-integration.plDESCRIPTION
This script expects a host-built Developer-Dashboard tarball to be mounted into the container. It installs that tarball with cpanm, extracts it to a temporary source tree for update-script execution, and then exercises the installed dashboard CLI and web runtime against a fake project.
FUNCTIONS
main, _run_shell, _wait_for_http, _run_browser_dom, _browser_command, _browser_binary, _single_subdir, _decode_json_tail, _reset_dir, _write_text, _read_text, _trim, _shell_quote, _assert, _assert_match
Run and validate the host-built-tarball integration workflow.
PURPOSE
Integration helper script in the Developer Dashboard codebase. This file drives the blank-environment tarball install and smoke verification flow inside the disposable integration container. Open this file when you need the implementation, regression coverage, or runtime entrypoint for that responsibility rather than guessing which part of the tree owns it.
WHY IT EXISTS
It exists to make a repeatable host-or-container integration workflow explicit instead of burying release verification steps in ad-hoc shell history.
WHEN TO USE
Use this file when you are rerunning the documented integration workflow for its environment or debugging a release/install problem in that path.
HOW TO USE
Run the script as part of the documented integration plan for its environment. Treat failures here as release blockers, because these scripts represent the supported rerun path.
WHAT USES IT
It is used by maintainers running the documented install/runtime verification workflow for that environment, and by tests that validate the checked-in integration assets.
EXAMPLES
perl integration/blank-env/run-integration.plRun the script from the documented integration environment so it can find the expected tarball, browser, or container prerequisites.