Found in the VM test: a site's PM2 daemon started from the agent's install job belonged to the agent's service, so stopping or updating the agent took down every site it had installed. Before any PM2 command as a site user, the scripts now make sure that user's daemon runs under pm2-<user> (moving one that runs elsewhere, keeping its process list). The agent's stats no longer start an empty daemon by asking one that isn't running. Uninstall stops the unit before removing it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
206 lines
7.8 KiB
Bash
206 lines
7.8 KiB
Bash
# shellcheck shell=bash
|
|
# crosscode restart / export / uninstall / purge (docs/AGENT-1.0-PLAN.md §4 and §9).
|
|
|
|
CROSSCODE_REMOVED="${CROSSCODE_REMOVED:-$CROSSCODE_SITES/.removed}"
|
|
|
|
manage_usage() {
|
|
cat <<'EOF'
|
|
crosscode restart <church> [events] reload the products' PM2 processes
|
|
crosscode export <church> --out <file.zip> the church's data (crosscode.church-export/1) and uploads
|
|
crosscode uninstall <church> --confirm <church>
|
|
final backup and uploads kept in
|
|
/var/www/sites/.removed/<church>-<date>/ (30 days),
|
|
then PM2, tunnels, database and folders removed
|
|
crosscode purge <church> --confirm <church> delete what uninstall kept
|
|
|
|
All take --json (a report at the end; the log goes to stderr).
|
|
EOF
|
|
}
|
|
|
|
# The church's products that this script can handle, in deploy order.
|
|
manage_products() {
|
|
local p
|
|
# shellcheck disable=SC2046 # PRODUCTS is a space-separated list
|
|
for p in $(in_product_order $(cenv PRODUCTS)); do
|
|
is_supported_product "$p" && echo "$p"
|
|
done
|
|
return 0
|
|
}
|
|
|
|
cmd_restart() {
|
|
local church="" p
|
|
local -a named=()
|
|
while [ $# -gt 0 ]; do
|
|
case "$1" in
|
|
-h|--help) manage_usage; return 0 ;;
|
|
-*) die "Unknown option $1 (crosscode help restart)." ;;
|
|
*) if [ -z "$church" ]; then church="$1"; else is_known_product "$1" || die "Unknown product \"$1\"."; named+=("$1"); fi; shift ;;
|
|
esac
|
|
done
|
|
[ -n "$church" ] || die "Name the church."
|
|
require_root
|
|
load_church "$church"
|
|
[ "${#named[@]}" -gt 0 ] || mapfile -t named < <(manage_products)
|
|
for p in "${named[@]}"; do
|
|
church_has_product "$p" || die "$church has no $p."
|
|
# shellcheck source=/dev/null
|
|
source "$CROSSCODE_HOME/products/$p.sh"
|
|
step "$p: reloading PM2"
|
|
"${p}_reload" "$(pvar "$p" DIR)" "$(pvar "$p" USER)"
|
|
step "$p: waiting for it to answer"
|
|
wait_for_version "$("${p}_health_url")" "$("${p}_expected_version" "$(pvar "$p" DIR)")" 60
|
|
done
|
|
}
|
|
|
|
cmd_export() {
|
|
local church="" out="" p tmp dir user bytes
|
|
while [ $# -gt 0 ]; do
|
|
case "$1" in
|
|
--out) [ $# -ge 2 ] || die "--out needs a file."; out="$2"; shift 2 ;;
|
|
-h|--help) manage_usage; return 0 ;;
|
|
-*) die "Unknown option $1 (crosscode help export)." ;;
|
|
*) [ -z "$church" ] || die "One church at a time."; church="$1"; shift ;;
|
|
esac
|
|
done
|
|
[ -n "$church" ] || die "Name the church."
|
|
[[ "$out" == /*.zip ]] || die "--out: an absolute path ending in .zip."
|
|
[ ! -e "$out" ] || die "$out exists already."
|
|
require_root
|
|
load_church "$church"
|
|
command -v zip >/dev/null || die "zip isn't installed (apt-get install zip)."
|
|
tmp="$(mktemp -d)"
|
|
chmod 755 "$tmp"
|
|
local rc
|
|
set +e
|
|
(
|
|
set -e
|
|
for p in $(manage_products); do
|
|
# shellcheck source=/dev/null
|
|
source "$CROSSCODE_HOME/products/$p.sh"
|
|
dir="$(pvar "$p" DIR)"; user="$(pvar "$p" USER)"
|
|
step "$p: exporting the data"
|
|
mkdir -p "$tmp/$p"
|
|
chown "$user:$user" "$tmp/$p"
|
|
"${p}_export" "$dir" "$user" "$tmp/$p"
|
|
step "$p: adding the uploads"
|
|
"${p}_copy_uploads" "$dir" "$tmp/$p/uploads"
|
|
done
|
|
step "Zipping"
|
|
# One product: its folder is the ZIP's top level (export.json, uploads/, README.txt).
|
|
if [ "$(manage_products | wc -l)" = 1 ]; then
|
|
(cd "$tmp/$(manage_products)" && zip -qr "$out" .)
|
|
else
|
|
(cd "$tmp" && zip -qr "$out" .)
|
|
fi
|
|
chmod 600 "$out"
|
|
)
|
|
rc=$?
|
|
set -e
|
|
rm -rf "$tmp"
|
|
[ "$rc" = 0 ] || { rm -f "$out"; die "Export of $church failed."; }
|
|
bytes="$(stat -c %s "$out")"
|
|
report_result file "$out"
|
|
report_result_json bytes "$bytes"
|
|
step "Exported $church to $out ($bytes bytes)"
|
|
}
|
|
|
|
cmd_uninstall() {
|
|
local church="" confirm="" p dir user db kept old name
|
|
while [ $# -gt 0 ]; do
|
|
case "$1" in
|
|
--confirm) [ $# -ge 2 ] || die "--confirm needs the church's name."; confirm="$2"; shift 2 ;;
|
|
-h|--help) manage_usage; return 0 ;;
|
|
-*) die "Unknown option $1 (crosscode help uninstall)." ;;
|
|
*) [ -z "$church" ] || die "One church at a time."; church="$1"; shift ;;
|
|
esac
|
|
done
|
|
[ -n "$church" ] || die "Name the church."
|
|
[ "$confirm" = "$church" ] || die "Uninstalling removes $church's sites and databases: add --confirm $church."
|
|
require_root
|
|
load_church "$church"
|
|
kept="$CROSSCODE_REMOVED/$church-$(date +%Y%m%d-%H%M%S)"
|
|
mkdir -p "$kept"
|
|
chmod 700 "$CROSSCODE_REMOVED" "$kept"
|
|
report_result kept "$kept"
|
|
|
|
# 1. Keep a final backup, the uploads and the .env files (the backup needs JWT_SECRET to read
|
|
# stored secrets) for 30 days. Nothing is removed until this has worked for every product.
|
|
for p in $(manage_products); do
|
|
# shellcheck source=/dev/null
|
|
source "$CROSSCODE_HOME/products/$p.sh"
|
|
dir="$(pvar "$p" DIR)"; user="$(pvar "$p" USER)"
|
|
step "$p: final backup"
|
|
"${p}_backup" "$dir" "$user"
|
|
step "$p: keeping the backup, uploads and settings in $kept/$p"
|
|
"${p}_keep" "$dir" "$kept/$p"
|
|
done
|
|
|
|
# 2. Remove, last product first.
|
|
local -a order
|
|
mapfile -t order < <(manage_products | tac)
|
|
for p in "${order[@]}"; do
|
|
# shellcheck source=/dev/null
|
|
source "$CROSSCODE_HOME/products/$p.sh"
|
|
dir="$(pvar "$p" DIR)"; user="$(pvar "$p" USER)"; db="$(pvar "$p" DB)"
|
|
step "$p: stopping and removing the PM2 processes"
|
|
# shellcheck disable=SC2046 # the PM2 names are a space-separated list
|
|
run_as "$user" / pm2 delete $("${p}_pm2_names") >/dev/null 2>&1 || true
|
|
run_as "$user" / pm2 save --force >/dev/null 2>&1 || true
|
|
if [ -f "$FRPC_INI" ] && frpc_has_block "$church" "$p"; then
|
|
step "$p: removing the frpc tunnels"
|
|
frpc_remove "$church" "$p"
|
|
frpc_reload
|
|
fi
|
|
name="$church-$p"
|
|
if [ -f "/etc/nginx/sites-available/$name" ]; then
|
|
step "$p: removing the nginx site"
|
|
rm -f "/etc/nginx/sites-enabled/$name" "/etc/nginx/sites-available/$name"
|
|
if nginx -t >/dev/null 2>&1; then systemctl reload nginx; else warn "nginx didn't reload: check nginx -t."; fi
|
|
fi
|
|
if [ -n "$db" ]; then
|
|
step "$p: dropping the database $db"
|
|
db_drop "$db"
|
|
fi
|
|
old="$(pvar "$p" OLD_DIR)"
|
|
if [ -n "$old" ] && [ -d "$old" ]; then rm -rf -- "$old"; info "Removed the old folder $old."; fi
|
|
done
|
|
|
|
step "Removing $(church_dir "$church")"
|
|
user="$(pvar events USER)"
|
|
rm -rf -- "$(church_dir "$church")"
|
|
# The app user goes too when crosscode made it for this church (cc-<church>).
|
|
if [ "$user" = "cc-$church" ] && id "$user" >/dev/null 2>&1; then
|
|
systemctl stop "pm2-$user" >/dev/null 2>&1 || true
|
|
pm2 unstartup systemd -u "$user" >/dev/null 2>&1 || true
|
|
pkill -u "$user" 2>/dev/null || true
|
|
userdel -r "$user" >/dev/null 2>&1 || warn "The user $user couldn't be removed (userdel -r $user)."
|
|
fi
|
|
step "Uninstalled $church. Kept until purged (30 days): $kept"
|
|
}
|
|
|
|
cmd_purge() {
|
|
local church="" confirm="" d n=0
|
|
while [ $# -gt 0 ]; do
|
|
case "$1" in
|
|
--confirm) [ $# -ge 2 ] || die "--confirm needs the church's name."; confirm="$2"; shift 2 ;;
|
|
-h|--help) manage_usage; return 0 ;;
|
|
-*) die "Unknown option $1 (crosscode help purge)." ;;
|
|
*) [ -z "$church" ] || die "One church at a time."; church="$1"; shift ;;
|
|
esac
|
|
done
|
|
[ -n "$church" ] || die "Name the church."
|
|
valid_slug "$church" || die "\"$church\" isn't a church name."
|
|
[ "$confirm" = "$church" ] || die "Purging deletes $church's last backup for good: add --confirm $church."
|
|
require_root
|
|
[ ! -f "$(church_env_path "$church")" ] || die "$church is still installed here; purge only deletes what uninstall kept."
|
|
for d in "$CROSSCODE_REMOVED/$church"-*; do
|
|
[ -d "$d" ] || continue
|
|
[[ "$(basename "$d")" =~ ^${church}-[0-9]{8}-[0-9]{6}$ ]] || continue
|
|
step "Deleting $d"
|
|
rm -rf -- "$d"
|
|
n=$((n + 1))
|
|
done
|
|
report_result_json deleted "$n"
|
|
[ "$n" -gt 0 ] || info "Nothing kept for $church."
|
|
}
|