feat(deploy): implement atomic Box web console deploy script and test suite
This commit is contained in:
operator
Executable
+117
@@ -0,0 +1,117 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# deploy-box-web.sh — Atomically package and deploy Box Web Console assets to the Google Cloud VM
|
||||||
|
#
|
||||||
|
# Assets: web/box/www/{index.html, box.js, box.css}
|
||||||
|
# Destination: /srv/box/www/ on 34.139.37.135 (box.muse-dev.online)
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
|
||||||
|
SRC_DIR="$REPO_ROOT/web/box/www"
|
||||||
|
|
||||||
|
# Default configuration
|
||||||
|
DEST_HOST="${BOX_WEB_HOST:-34.139.37.135}"
|
||||||
|
DEST_USER="${BOX_WEB_USER:-super}"
|
||||||
|
DEST_DIR="${BOX_WEB_DEST:-/srv/box/www}"
|
||||||
|
DRY_RUN=0
|
||||||
|
BUNDLE_ONLY=0
|
||||||
|
|
||||||
|
# Parse arguments
|
||||||
|
while [[ $# -gt 0 ]]; do
|
||||||
|
case "$1" in
|
||||||
|
--dry-run)
|
||||||
|
DRY_RUN=1
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
--bundle-only)
|
||||||
|
BUNDLE_ONLY=1
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
--host)
|
||||||
|
DEST_HOST="$2"
|
||||||
|
shift 2
|
||||||
|
;;
|
||||||
|
--user)
|
||||||
|
DEST_USER="$2"
|
||||||
|
shift 2
|
||||||
|
;;
|
||||||
|
--dest)
|
||||||
|
DEST_DIR="$2"
|
||||||
|
shift 2
|
||||||
|
;;
|
||||||
|
-h|--help)
|
||||||
|
echo "Usage: $0 [options]"
|
||||||
|
echo ""
|
||||||
|
echo "Options:"
|
||||||
|
echo " --dry-run Preview assets, hashes, and destination without deploying"
|
||||||
|
echo " --bundle-only Package the atomic tarball into /tmp and exit"
|
||||||
|
echo " --host <host> Target host (default: 34.139.37.135)"
|
||||||
|
echo " --user <user> SSH user on target (default: super)"
|
||||||
|
echo " --dest <dir> Remote directory path (default: /srv/box/www)"
|
||||||
|
exit 0
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
echo "Unknown option: $1" >&2
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
# Pre-flight asset verification
|
||||||
|
if [[ ! -d "$SRC_DIR" ]]; then
|
||||||
|
echo "Error: Source directory missing at $SRC_DIR" >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
REQUIRED_FILES=("index.html" "box.js" "box.css")
|
||||||
|
for f in "${REQUIRED_FILES[@]}"; do
|
||||||
|
if [[ ! -f "$SRC_DIR/$f" ]]; then
|
||||||
|
echo "Error: Missing required asset: $SRC_DIR/$f" >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
echo "=== Box Web Console Deployment Plan ==="
|
||||||
|
echo "Source: $SRC_DIR"
|
||||||
|
echo "Target: $DEST_USER@$DEST_HOST:$DEST_DIR"
|
||||||
|
echo "Mode: $([ "$DRY_RUN" -eq 1 ] && echo "DRY-RUN (no changes)" || echo "LIVE")"
|
||||||
|
echo ""
|
||||||
|
echo "Asset Manifest & SHA256 Checksums:"
|
||||||
|
for f in "${REQUIRED_FILES[@]}"; do
|
||||||
|
csum=$(sha256sum "$SRC_DIR/$f" | cut -d' ' -f1)
|
||||||
|
size=$(wc -c < "$SRC_DIR/$f" | tr -d ' ')
|
||||||
|
printf " • %-12s %6s bytes sha256:%s\n" "$f" "$size" "$csum"
|
||||||
|
done
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Dry-run exit
|
||||||
|
if [[ "$DRY_RUN" -eq 1 ]]; then
|
||||||
|
echo "[dry-run] Validation complete. No files transferred."
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Create atomic bundle in temp directory
|
||||||
|
BUNDLE_PATH="/tmp/box-web-bundle-$(date +%s).tar.gz"
|
||||||
|
echo "Creating atomic archive: $BUNDLE_PATH..."
|
||||||
|
tar -czf "$BUNDLE_PATH" -C "$SRC_DIR" index.html box.js box.css
|
||||||
|
echo "Archive created ($(wc -c < "$BUNDLE_PATH" | tr -d ' ') bytes)."
|
||||||
|
|
||||||
|
if [[ "$BUNDLE_ONLY" -eq 1 ]]; then
|
||||||
|
echo "Bundle generated at $BUNDLE_PATH. Skipping network deployment."
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Deploy to remote target
|
||||||
|
echo "Deploying to $DEST_USER@$DEST_HOST:$DEST_DIR..."
|
||||||
|
REMOTE_TMP="/tmp/box-web-bundle-$$.tar.gz"
|
||||||
|
|
||||||
|
scp -o ConnectTimeout=10 -o BatchMode=yes "$BUNDLE_PATH" "$DEST_USER@$DEST_HOST:$REMOTE_TMP"
|
||||||
|
ssh -o ConnectTimeout=10 -o BatchMode=yes "$DEST_USER@$DEST_HOST" "
|
||||||
|
mkdir -p '$DEST_DIR' &&
|
||||||
|
tar -xzf '$REMOTE_TMP' -C '$DEST_DIR' &&
|
||||||
|
rm -f '$REMOTE_TMP'
|
||||||
|
"
|
||||||
|
rm -f "$BUNDLE_PATH"
|
||||||
|
|
||||||
|
echo "✓ Deployment succeeded! Assets live at https://box.muse-dev.online/"
|
||||||
@@ -0,0 +1,61 @@
|
|||||||
|
"""Tests for bin/deploy-box-web.sh."""
|
||||||
|
import os
|
||||||
|
import subprocess
|
||||||
|
import tarfile
|
||||||
|
import unittest
|
||||||
|
|
||||||
|
REPO_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
||||||
|
SCRIPT_PATH = os.path.join(REPO_ROOT, "bin", "deploy-box-web.sh")
|
||||||
|
|
||||||
|
class TestDeployBoxWeb(unittest.TestCase):
|
||||||
|
def test_script_exists_and_executable(self):
|
||||||
|
self.assertTrue(os.path.exists(SCRIPT_PATH), f"Missing script: {SCRIPT_PATH}")
|
||||||
|
self.assertTrue(os.access(SCRIPT_PATH, os.X_OK), "Script not executable")
|
||||||
|
|
||||||
|
def test_bash_syntax(self):
|
||||||
|
proc = subprocess.run(["bash", "-n", SCRIPT_PATH], capture_output=True, text=True)
|
||||||
|
self.assertEqual(proc.returncode, 0, f"Syntax error in script: {proc.stderr}")
|
||||||
|
|
||||||
|
def test_dry_run_output(self):
|
||||||
|
proc = subprocess.run([SCRIPT_PATH, "--dry-run"], capture_output=True, text=True)
|
||||||
|
self.assertEqual(proc.returncode, 0, f"Dry-run failed: {proc.stderr}")
|
||||||
|
self.assertIn("Box Web Console Deployment Plan", proc.stdout)
|
||||||
|
self.assertIn("34.139.37.135", proc.stdout)
|
||||||
|
self.assertIn("/srv/box/www", proc.stdout)
|
||||||
|
self.assertIn("index.html", proc.stdout)
|
||||||
|
self.assertIn("box.js", proc.stdout)
|
||||||
|
self.assertIn("box.css", proc.stdout)
|
||||||
|
self.assertIn("DRY-RUN (no changes)", proc.stdout)
|
||||||
|
self.assertIn("sha256:", proc.stdout)
|
||||||
|
|
||||||
|
def test_custom_parameters(self):
|
||||||
|
cmd = [
|
||||||
|
SCRIPT_PATH,
|
||||||
|
"--host", "custom.domain.net",
|
||||||
|
"--user", "deployer",
|
||||||
|
"--dest", "/opt/box/web",
|
||||||
|
"--dry-run"
|
||||||
|
]
|
||||||
|
proc = subprocess.run(cmd, capture_output=True, text=True)
|
||||||
|
self.assertEqual(proc.returncode, 0)
|
||||||
|
self.assertIn("deployer@custom.domain.net:/opt/box/web", proc.stdout)
|
||||||
|
|
||||||
|
def test_bundle_only(self):
|
||||||
|
proc = subprocess.run([SCRIPT_PATH, "--bundle-only"], capture_output=True, text=True)
|
||||||
|
self.assertEqual(proc.returncode, 0, f"Bundle creation failed: {proc.stderr}")
|
||||||
|
self.assertIn("Archive created", proc.stdout)
|
||||||
|
# Extract bundle path from output
|
||||||
|
for line in proc.stdout.splitlines():
|
||||||
|
if "Bundle generated at" in line:
|
||||||
|
bundle_path = line.split("Bundle generated at")[1].strip().split()[0].rstrip(".")
|
||||||
|
self.assertTrue(os.path.exists(bundle_path))
|
||||||
|
with tarfile.open(bundle_path, "r:gz") as tar:
|
||||||
|
names = tar.getnames()
|
||||||
|
self.assertIn("index.html", names)
|
||||||
|
self.assertIn("box.js", names)
|
||||||
|
self.assertIn("box.css", names)
|
||||||
|
os.remove(bundle_path)
|
||||||
|
break
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
unittest.main()
|
||||||
Reference in New Issue
Block a user