feat(docker): improve testing workflow with environment variables

- feat(docker-compose): use LIFEFORGE_TAG env var for flexible image selection
- feat(script): default to 'main' tag instead of hardcoded pr-93-review
- feat(script): add helpful commands and version switching examples
- ci(docker): add concurrency control to prevent simultaneous builds
- docs(compose): add comprehensive usage examples in comments

Now you can easily test different versions:
  LIFEFORGE_TAG=main docker-compose -f docker-compose.images.yaml up
  LIFEFORGE_TAG=pr-93-review docker-compose -f docker-compose.images.yaml up
  ./scripts/test-docker-images.sh main

Author: voioo

.github/workflows/docker.yml

@@ -8,6 +8,11 @@ on:
     branches: [main]
   workflow_dispatch:
 
+# Prevent multiple simultaneous builds for the same ref
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 env:
   REGISTRY: ghcr.io
   IMAGE_PREFIX: ${{ github.repository_owner }}/lifeforge

docker-compose.images.yaml

@@ -1,9 +1,21 @@
 # Docker Compose for testing pre-built images from GitHub Container Registry
-# Usage: docker-compose -f docker-compose.images.yaml up
+# 
+# Usage:
+#   # Use main branch images (default)
+#   docker-compose -f docker-compose.images.yaml up
+#
+#   # Use specific tag/branch
+#   LIFEFORGE_TAG=pr-93-review docker-compose -f docker-compose.images.yaml up
+#
+#   # Use latest
+#   LIFEFORGE_TAG=latest docker-compose -f docker-compose.images.yaml up
+#
+#   # Use specific version
+#   LIFEFORGE_TAG=v1.0.0 docker-compose -f docker-compose.images.yaml up
 
 services:
   db:
-    image: ghcr.io/voioo/lifeforge-db:pr-93-review
+    image: ghcr.io/voioo/lifeforge-db:${LIFEFORGE_TAG:-main}
     container_name: lifeforge-db
     restart: unless-stopped
     env_file:
@@ -24,7 +36,7 @@ services:
       start_period: 10s
 
   db-init:
-    image: ghcr.io/voioo/lifeforge-server:pr-93-review
+    image: ghcr.io/voioo/lifeforge-server:${LIFEFORGE_TAG:-main}
     container_name: lifeforge-db-init
     env_file:
       - ./env/.env.docker
@@ -43,7 +55,7 @@ services:
     entrypoint: ["/bin/sh", "-c", "echo 'DB init would run here'"]
 
   server:
-    image: ghcr.io/voioo/lifeforge-server:pr-93-review
+    image: ghcr.io/voioo/lifeforge-server:${LIFEFORGE_TAG:-main}
     container_name: lifeforge-server
     restart: unless-stopped
     env_file:
@@ -62,7 +74,7 @@ services:
         condition: service_completed_successfully
 
   client:
-    image: ghcr.io/voioo/lifeforge-client:pr-93-review
+    image: ghcr.io/voioo/lifeforge-client:${LIFEFORGE_TAG:-main}
     container_name: lifeforge-client
     restart: unless-stopped
     ports:

scripts/test-docker-images.sh

@@ -2,16 +2,17 @@
 
 # Test script for pulling and running pre-built Docker images from GitHub Container Registry
 # Usage: ./scripts/test-docker-images.sh [tag]
-# Default tag: pr-93-review
+# Default tag: main
 
 set -e
 
-TAG=${1:-pr-93-review}
+TAG=${1:-main}
 REPO_OWNER="voioo"
 
 echo "🐳 Testing LifeForge Docker Images"
 echo "==================================="
 echo "Tag: $TAG"
+echo "Registry: ghcr.io/${REPO_OWNER}"
 echo ""
 
 # Check if docker is installed
@@ -56,9 +57,11 @@ if [ ! -f "./env/.env.docker" ]; then
     fi
 fi
 
-# Start services
+# Stop any existing containers
 docker-compose -f docker-compose.images.yaml down 2>/dev/null || true
-docker-compose -f docker-compose.images.yaml up -d
+
+# Start services with the specified tag
+LIFEFORGE_TAG=${TAG} docker-compose -f docker-compose.images.yaml up -d
 
 echo ""
 echo "⏳ Waiting for services to start..."
@@ -80,9 +83,14 @@ echo ""
 echo "📝 Useful Commands:"
 echo "  - View logs: docker-compose -f docker-compose.images.yaml logs -f"
 echo "  - Stop: docker-compose -f docker-compose.images.yaml down"
-echo "  - Restart: docker-compose -f docker-compose.images.yaml restart"
+echo "  - Restart: LIFEFORGE_TAG=${TAG} docker-compose -f docker-compose.images.yaml restart"
 echo ""
 
 echo "✅ Setup complete! LifeForge should be available at http://localhost"
 echo ""
 echo "⚠️  Note: First startup may take a few minutes as the database initializes."
+echo ""
+echo "🔄 To test a different version:"
+echo "   ./scripts/test-docker-images.sh pr-93-review"
+echo "   ./scripts/test-docker-images.sh v1.0.0"
+echo "   ./scripts/test-docker-images.sh latest"