feat: add healthcheck.sh for Docker Compose deployments

README.md

@@ -149,6 +149,16 @@ Now, launch your web browser and enjoy Huly! To stop all services, run `docker c
 > [!IMPORTANT]
 > Provided configrations include deployments of CockroachDB and Redpanda which might not be production-ready. Please inspect them carefully before using in production. For more information on the recommended deployment configurations, please refer to the [CockroachDB](https://www.cockroachlabs.com/docs/stable/recommended-production-settings) and [Redpanda](https://docs.redpanda.com/24.3/deploy/) documentation.
 
+## Health check
+
+Run `./healthcheck.sh` to see whether every service is up (and healthy, where a service
+defines a Docker healthcheck) plus front reachability. It exits non-zero if anything is
+down, so it doubles as a cron or monitoring probe:
+
+```bash
+./healthcheck.sh
+```
+
 ## Troubleshooting
 
 ### Huly opens, but user sign-up fails

healthcheck.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+#
+# healthcheck.sh - quick health check of a Docker Compose deployment.
+#
+# Reports every service's container status (and Docker health, where a service defines
+# a healthcheck), and optionally whether the front is reachable. Exits 0 if all services
+# are running and none are unhealthy, non-zero otherwise - so it is usable in cron/CI or
+# a monitoring probe. Read-only; does not touch the stack.
+#
+# Usage: ./healthcheck.sh [--help]
+
+set -uo pipefail
+
+cd "$(dirname "$0")" || exit 1
+
+case "${1:-}" in
+    --help)
+        echo "Usage: $0"
+        echo "Checks that all Compose services are running (and healthy where a healthcheck"
+        echo "is defined), plus front reachability if the port is known. Exit 0 = all good."
+        exit 0
+        ;;
+esac
+
+if docker compose version >/dev/null 2>&1; then
+    COMPOSE="docker compose"
+elif command -v docker-compose >/dev/null 2>&1; then
+    COMPOSE="docker-compose"
+else
+    echo "Error: docker compose is not available." >&2
+    exit 1
+fi
+
+# Portable array fill (avoid mapfile; not present in bash 3.x).
+SERVICES=()
+while IFS= read -r line; do
+    [ -n "$line" ] && SERVICES+=("$line")
+done < <($COMPOSE config --services 2>/dev/null | sort)
+if [ "${#SERVICES[@]}" -eq 0 ]; then
+    echo "No services found. Run this from the directory with compose.yml." >&2
+    exit 1
+fi
+
+bad=0
+printf '%-16s %-22s %s\n' "SERVICE" "STATE" "HEALTH"
+for svc in "${SERVICES[@]}"; do
+    cid=$($COMPOSE ps -aq "$svc" 2>/dev/null | head -1)
+    if [ -z "$cid" ]; then
+        printf '%-16s %-22s %s\n' "$svc" "no-container" "-"
+        bad=1
+        continue
+    fi
+    state=$(docker inspect "$cid" --format '{{.State.Status}}' 2>/dev/null)
+    health=$(docker inspect "$cid" --format '{{if .State.Health}}{{.State.Health.Status}}{{else}}-{{end}}' 2>/dev/null)
+    exitcode=$(docker inspect "$cid" --format '{{.State.ExitCode}}' 2>/dev/null)
+    restart=$(docker inspect "$cid" --format '{{.HostConfig.RestartPolicy.Name}}' 2>/dev/null)
+    label="$state"
+    if [ "$state" = "running" ]; then
+        [ "$health" = "unhealthy" ] && bad=1
+    elif [ "$state" = "exited" ] && [ "${exitcode:-1}" = "0" ] && { [ "$restart" = "no" ] || [ -z "$restart" ]; }; then
+        # A one-shot/init container that ran and exited cleanly (e.g. huly-tools,
+        # which has restart: "no"). Expected, not a failure.
+        label="exited (one-shot ok)"
+    else
+        bad=1
+    fi
+    printf '%-16s %-22s %s\n' "$svc" "$label" "${health:--}"
+done
+
+# Optional: front reachability, if we can determine the local HTTP port from config.
+PORT=$(grep -hE '^HTTP_PORT=' .env huly.conf huly_v7.conf 2>/dev/null | tail -1 | cut -d= -f2 | tr -d '"' | tr -d '[:space:]')
+if [ -n "${PORT:-}" ]; then
+    code=$(curl -s -o /dev/null -w '%{http_code}' --max-time 8 "http://localhost:${PORT}" 2>/dev/null || true)
+    case "$code" in
+        200|301|302) echo "front: http://localhost:${PORT} -> HTTP $code (reachable)" ;;
+        *)           echo "front: http://localhost:${PORT} -> ${code:-no response}"; bad=1 ;;
+    esac
+fi
+
+if [ "$bad" -eq 0 ]; then
+    echo -e "\033[1;32mOK: all services running.\033[0m"
+    exit 0
+else
+    echo -e "\033[31mPROBLEM: one or more services are not running/healthy.\033[0m Check 'docker compose ps' and logs."
+    exit 1
+fi