Skip to content

Review: WebHarbor reset and smoke verification script (#47, original by @Lxr-max) #108

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jackjin1997 wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Review: WebHarbor reset and smoke verification script (#47, original by @Lxr-max) #108

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
777fcdf
Add WebHarbor reset and smoke verification script
Jun 4, 2026
aeb5c04
fix(check_reset_smoke): tie DB parity to the source it actually read
Sep 12, 2026
fda2266
fix(check_reset_smoke): require the DB source to be asked for
Sep 13, 2026
f3a799d
docs(check_reset_smoke): correct the --db-root help text
Sep 13, 2026
e339a13
Merge upstream main (25 sites after FedEx) into the reset/smoke revie…
jackjin1997 Sep 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,35 @@ Any other improvement — bug fixes, UI polish, data enrichment, task suggestion
| 📊 Contribution Track Sheet | [Google Sheet](https://docs.google.com/spreadsheets/d/1vZsrQjy9nJKze58fx4kbQtFi85NjVXIWCFyu3ShD7gk/edit?gid=0#gid=0) |
| 📝 Contribution Request Form | [Google Form](https://forms.gle/ngcD1rzAfUEphNmRA) |

## Reset And Smoke Checks

Use the repository reset/smoke checker to verify control-plane resets, homepage
reachability, and runtime/seed DB parity:

```bash
python scripts/check_reset_smoke.py --site amazon
python scripts/check_reset_smoke.py --control-url http://localhost:8101
python scripts/check_reset_smoke.py --json
python scripts/check_reset_smoke.py --strict
```

Reset and homepage checks go over HTTP, so they work from anywhere that can reach the
control plane. The DB parity check has to read the files the control plane actually
resets — `/opt/WebSyn/<site>/instance` **inside the deployment**, which is not this
checkout when the environment runs in Docker. Point the checker at that source:

```bash
# environment in a container (the usual case)
python scripts/check_reset_smoke.py --docker-container <container-name>

# sites deployed on this host
python scripts/check_reset_smoke.py --db-root /opt/WebSyn
```

Without one of those flags the DB check reports `SKIP` with source `none` rather than
comparing this checkout's files, and every result names the source it hashed
(`md5_source`), so a `PASS` always says which DBs it read.

## Citation

WebHarbor is initiated by UNC-Chapel Hill and Microsoft, with contributions from the broader community. If you have any questions, please contact us via `webharborcomm at gmail dot com` or `zhaoyang at cs dot unc dot edu`.
Expand Down
Loading