chore: import upstream snapshot with attribution

2026-07-13 12:31:33 +08:00
commit 9e8f1bbeed
1156 changed files with 235330 additions and 0 deletions
@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+# Validate resolved Docker Compose stack for syntax errors
+# Usage: validate-compose-stack.sh --compose-flags "-f file1.yml -f file2.yml" [--env-file /path/to/.env]
+#
+# Returns:
+#   0 - Valid compose stack
+#   1 - Invalid compose stack (syntax errors, missing files, etc.)
+
+set -euo pipefail
+
+COMPOSE_FLAGS=""
+ENV_FILE=""
+QUIET=false
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --compose-flags)
+            COMPOSE_FLAGS="${2:-}"
+            shift 2
+            ;;
+        --env-file)
+            ENV_FILE="${2:-}"
+            shift 2
+            ;;
+        --quiet)
+            QUIET=true
+            shift
+            ;;
+        *)
+            echo "Unknown argument: $1" >&2
+            exit 1
+            ;;
+    esac
+done
+
+if [[ -z "$COMPOSE_FLAGS" ]]; then
+    echo "ERROR: --compose-flags required" >&2
+    exit 1
+fi
+
+# Build env-file flag if provided (allows compose to resolve required variable references)
+ENV_FILE_FLAG=""
+if [[ -n "$ENV_FILE" && -f "$ENV_FILE" ]]; then
+    ENV_FILE_FLAG="--env-file $ENV_FILE"
+fi
+
+# Check if docker/docker compose is available
+if command -v docker &>/dev/null && docker compose version &>/dev/null; then
+    DOCKER_COMPOSE_CMD="docker compose"
+elif command -v docker-compose &>/dev/null; then
+    DOCKER_COMPOSE_CMD="docker-compose"
+else
+    echo "ERROR: docker compose not found" >&2
+    exit 1
+fi
+
+# Validate compose stack syntax
+if ! $QUIET; then
+    echo "Validating compose stack: $COMPOSE_FLAGS"
+fi
+
+# Use docker compose config to validate syntax and merge
+# This catches:
+# - YAML syntax errors
+# - Missing files
+# - Invalid service definitions
+# - Circular dependencies
+# - Invalid environment variable references
+validation_output=$(mktemp)
+if $DOCKER_COMPOSE_CMD $ENV_FILE_FLAG $COMPOSE_FLAGS config > "$validation_output" 2>&1; then
+    if ! $QUIET; then
+        echo "Compose stack validation passed"
+        # Show summary of services
+        service_count=$(grep -c "^  [a-z]" "$validation_output" || echo "0")
+        echo "  Services defined: $service_count"
+    fi
+    rm -f "$validation_output"
+    exit 0
+else
+    echo "Compose stack validation FAILED" >&2
+    echo "" >&2
+    echo "Errors:" >&2
+    cat "$validation_output" >&2
+    echo "" >&2
+    echo "Compose flags: $COMPOSE_FLAGS" >&2
+    rm -f "$validation_output"
+    exit 1
+fi