notes

6.8 KB

1. #!/usr/bin/env bash
2. # deploy.sh — notes.worldapi.org: Loreana (this folder) → Byrodin. Run ON LOREANA.
3. #
4. # ./deploy.sh gates → rsync → restart the container → public URL 200
5. # ./deploy.sh --dry-run gates → rsync -n (shows what WOULD be sent), no restart, no URL check
6. # ./deploy.sh --skip-tests skips the gates (LOUD warning) — only when you know why
7. # ./deploy.sh --target DIR|HOST:DIR another destination (default below); a local DIR is
8. # how the script is tested without touching Byrodin
9. # ./deploy.sh --url URL the URL that must answer 200 after the restart
10. # (env: DEPLOY_TARGET, DEPLOY_URL, DEPLOY_SSH override the same defaults)
11. #
12. # THE FIRST DEPLOY is done by the architect on Byrodin (folder, data, nginx vhost, cert,
13. # DNS). This script only updates the CODE: storage/, .sessions/, .env, .scratch/, server.*,
14. # testapp/ and logs are never sent, so live data on Byrodin is never touched.
15. # No --delete: a file removed here stays on Byrodin (harmless — nothing imports it).
16. set -euo pipefail
18. # ---- the app ------------------------------------------------------------------------------
19. APP=notes.worldapi.org
20. CONTAINER=notes.worldapi.org
21. [email protected]:/CONTAINERS/projects/notes.worldapi.org
22. DEFAULT_URL=https://notes.worldapi.org/
23. GATES=(
24. "node tests/browser.mjs"
25. )
26. # NEVER SENT (rsync patterns; a leading / anchors at the app folder)
27. EXCLUDES=(
28. /.git/ /.gitignore
29. /storage/ /.sessions/ /.env /.env.* /.scratch/ /server.* /testapp/
30. '*.log' '*.pid' node_modules/
31. )
32. # ---------------------------------------------------------------------------------------------
34. DRY=0
35. SKIP=0
36. TARGET=${DEPLOY_TARGET:-$DEFAULT_TARGET}
37. URL=${DEPLOY_URL:-$DEFAULT_URL}
38. # Loreana's ssh config may not apply to Byrodin: -F /dev/null (ident STATUS)
39. SSH=${DEPLOY_SSH:-ssh -F /dev/null -o BatchMode=yes -o ConnectTimeout=15}
41. usage() { sed -n '2,13p' "$0" | sed 's/^# \{0,1\}//'; }
42. while [ $# -gt 0 ]; do
43. case "$1" in
44. --dry-run) DRY=1 ;;
45. --skip-tests) SKIP=1 ;;
46. --target) TARGET=${2:?--target needs a value}; shift ;;
47. --target=*) TARGET=${1#--target=} ;;
48. --url) URL=${2:?--url needs a value}; shift ;;
49. --url=*) URL=${1#--url=} ;;
50. -h|--help) usage; exit 0 ;;
51. *) echo "deploy: unknown argument: $1" >&2; usage >&2; exit 2 ;;
52. esac
53. shift
54. done
56. HERE=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
57. cd "$HERE"
59. step() { printf '\n==> %s\n' "$*"; }
60. run() { printf ' $ %s\n' "$*" >&2; "$@"; }
61. die() { printf '\ndeploy: REFUSED — %s\n' "$*" >&2; exit 1; }
63. # a target `host:dir` is remote, a plain path is local
64. if [[ "$TARGET" == *:* ]]; then
65. REMOTE_HOST=${TARGET%%:*}
66. REMOTE_DIR=${TARGET#*:}
67. else
68. REMOTE_HOST=
69. REMOTE_DIR=$TARGET
70. fi
72. step "[0/4] $APP → $TARGET (dry run: $DRY, skip tests: $SKIP)"
73. echo " from $HERE"
74. echo " url $URL"
75. [ -x bin/hybriel ] || die "bin/hybriel is missing here"
76. [ -f docker-compose.yml ] || die "docker-compose.yml is missing here"
77. [ -f project.hl ] || die "project.hl is missing here"
78. command -v rsync >/dev/null || die "rsync is not installed"
80. # ---- 1. the gates ---------------------------------------------------------------------------
81. if [ "$SKIP" = 1 ]; then
82. step "[1/4] GATES SKIPPED"
83. printf ' !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n'
84. printf ' !! --skip-tests: NOTHING WAS TESTED. You deploy untested code. !!\n'
85. printf ' !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n'
86. else
87. step "[1/4] gates (${#GATES[@]})"
88. # headless Chromes that exist BEFORE the gates are not ours (other sessions' test runs, e.g. Anton's)
89. chromes() { ps -eo pid=,ppid=,args= | awk '/[h]l-browser-tier/ && /remote-debugging-port/ && !/--type=/ {print $1, $2}'; }
90. before=" $(chromes | awk '{print $1}' | tr '\n' ' ') "
91. for g in "${GATES[@]}"; do
92. printf ' $ %s\n' "$g"
93. out=$(mktemp)
94. if ! $g > "$out" 2>&1; then
95. grep -E '^FAIL|passed,' "$out" | sed 's/^/ /' || true
96. echo " (full output: $out)"
97. die "gate failed: $g"
98. fi
99. grep -E 'passed,' "$out" | tail -1 | sed 's/^/ /'
100. rm -f "$out"
101. done
102. # a Chrome our gates LEFT: new since the gates began AND no longer owned by a running node test
103. # (a Chrome whose parent is a live node process belongs to another session's test run right now)
104. leaked=""
105. while read -r pid ppid; do
106. [ -z "$pid" ] && continue
107. case "$before" in *" $pid "*) continue ;; esac
108. ps -o args= -p "$ppid" 2>/dev/null | grep -q '^node\|/node ' && continue
109. leaked="$leaked $pid"
110. done < <(chromes)
111. if [ -n "$leaked" ]; then
112. die "a gate left a headless Chrome (pids:$leaked; ps -eo pid,args | grep hl-browser-tier)"
113. fi
114. fi
116. # ---- 2. rsync the code ----------------------------------------------------------------------
117. RSYNC=(rsync -az --no-owner --no-group --itemize-changes)
118. for e in "${EXCLUDES[@]}"; do RSYNC+=("--exclude=$e"); done
119. if [ -n "$REMOTE_HOST" ]; then
120. RSYNC+=(-e "$SSH")
121. else
122. mkdir -p "$REMOTE_DIR"
123. fi
124. # the preview is ALWAYS made first (rsync -n): nothing that must stay on Byrodin may be in it
125. step "[2/4] rsync preview (what would be sent)"
126. preview=$(mktemp)
127. run "${RSYNC[@]}" -n ./ "$TARGET/" > "$preview"
128. sed 's/^/ /' "$preview"
129. echo " ($(grep -c . "$preview" || true) lines)"
130. if awk '{print $2}' "$preview" | grep -E '^(storage/|\.sessions/|\.env|\.scratch/|server\.|testapp/)|\.log$|\.pid$' ; then
131. die "the preview holds a path that must never be sent (see above)"
132. fi
133. rm -f "$preview"
134. if [ "$DRY" = 1 ]; then
135. step "[2/4] DRY RUN: nothing sent"
136. else
137. step "[2/4] rsync"
138. run "${RSYNC[@]}" ./ "$TARGET/" | sed 's/^/ /'
139. fi
141. # ---- 3. restart the container ---------------------------------------------------------------
142. RESTART="cd '$REMOTE_DIR' && docker compose up -d --build && docker compose restart && docker compose ps"
143. if [ "$DRY" = 1 ]; then
144. step "[3/4] DRY RUN: would restart $CONTAINER"
145. if [ -n "$REMOTE_HOST" ]; then echo " would run: $SSH $REMOTE_HOST \"$RESTART\""; else echo " would run: bash -c \"$RESTART\""; fi
146. else
147. step "[3/4] restart $CONTAINER"
148. if [ -n "$REMOTE_HOST" ]; then
149. run $SSH "$REMOTE_HOST" "$RESTART"
150. else
151. run bash -c "$RESTART"
152. fi
153. fi
155. # ---- 4. the URL answers 200 -----------------------------------------------------------------
156. if [ "$DRY" = 1 ]; then
157. step "[4/4] DRY RUN: would check $URL answers 200"
158. step "dry run done — nothing was sent, nothing restarted"
159. exit 0
160. fi
161. step "[4/4] $URL must answer 200"
162. code=000
163. for i in $(seq 1 20); do
164. code=$(curl -s -o /dev/null -w '%{http_code}' --max-time 10 "$URL" || true)
165. echo " try $i: $code"
166. [ "$code" = 200 ] && break
167. sleep 1
168. done
169. if [ "$code" != 200 ]; then
170. if [ -n "$REMOTE_HOST" ]; then die "$URL answered $code, not 200 — look: $SSH $REMOTE_HOST docker logs --tail 50 $CONTAINER"; fi
171. die "$URL answered $code, not 200 — look: docker logs --tail 50 $CONTAINER"
172. fi
173. step "deployed $APP → $TARGET, $URL answers 200"