From 5672f8dbb904e86768f4293bee625b2cf91d5111 Mon Sep 17 00:00:00 2001 From: alex Date: Sat, 15 Apr 2023 09:59:57 +0200 Subject: [PATCH] docs: add a section on how to test changes on a live device --- README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/README.md b/README.md index dad23a3..9f17bc7 100644 --- a/README.md +++ b/README.md @@ -30,3 +30,25 @@ the `update.sh` script once a day. The script requires `REPODIR` and `LOGFILE` env variables set. TODO: add a list of supported platforms; the "native" is void linux. + +## testing a live change + +the procedure to run a modified sysupdate on the device while ssh'ed into +the instance. + +first, make sure periodic updates are disabled: + + chmod -x /etc/cron.hourly/sysupdate + +then set required env variables and run the apply script: + + cd /ssd/sysupdates + export SYSUPDATES_ROOTDIR=$PWD + ./apply.sh + +to reactivate periodic sysupdates, flip the `x` bit: + + chmod +x /etc/cron.hourly/sysupdate + +note that the periodic `sysupdate` script will revert the repo to the latest +commit of the branch specified in the script or `master` as the default.