🐳 feat: implement Docker multi-stage build with caching optimization

Added Docker build infrastructure:
- Multi-stage build (builder, cache, production)
- Dependency hashing for cache invalidation
- GNU tar support for cache compatibility
- Production and development Dockerfiles
- Docker Compose for local development

Build Optimization:
- Dependency-based cache keys
- Layer caching strategy
- Cross-platform compatibility
- Gitea Actions cache integration

Files Added:
- docker/Dockerfile.build - Build environment
- docker/Dockerfile.prod - Production image
- docker/Dockerfile.prod.template - Template-based generation
- docker-compose.yml - Development setup
- scripts/calculate-deps-hash.sh - Cache key calculation
- scripts/test-docker-cache.sh - Cache testing

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
This commit is contained in:
2026-04-09 00:25:53 +02:00
parent a17eebc8f2
commit e2adb3bc9f
8 changed files with 449 additions and 1 deletions

View File

@@ -0,0 +1,179 @@
#!/bin/bash
# Test the build cache environment without local Go installation
# This simulates the Gitea act runner environment
set -e
echo "🧪 Testing Build Cache Environment"
echo "=================================="
echo ""
# 1. Calculate dependency hash
echo "1. Calculating dependency hash..."
DEPS_HASH=$(./scripts/calculate-deps-hash.sh)
echo "✅ Dependency hash: $DEPS_HASH"
echo ""
# 2. Build the build cache image
echo "2. Building build cache image..."
if command -v docker >/dev/null 2>&1; then
docker build -t dance-lessons-coach-build-cache:$DEPS_HASH -f docker/Dockerfile.build .
else
echo "❌ Docker not found"
exit 1
fi
echo "✅ Build cache image built: dance-lessons-coach-build-cache:$DEPS_HASH"
echo ""
# 3. Test Go environment inside the container
echo "3. Testing Go environment inside container..."
docker run --rm dance-lessons-coach-build-cache:$DEPS_HASH sh -c "go version"
docker run --rm dance-lessons-coach-build-cache:$DEPS_HASH sh -c "which swag"
echo "✅ Go and swag available in container"
echo ""
# 4. Test Swagger generation
echo "4. Testing Swagger generation..."
docker run --rm -v "$(pwd):/workspace" -w /workspace dance-lessons-coach-build-cache:$DEPS_HASH sh -c "cd pkg/server && go generate"
if [ -f "pkg/server/docs/swagger.json" ]; then
echo "✅ Swagger documentation generated successfully"
else
echo "❌ Swagger documentation generation failed"
exit 1
fi
echo ""
# 5. Test Go build
echo "5. Testing Go build..."
docker run --rm -v "$(pwd):/workspace" -w /workspace dance-lessons-coach-build-cache:$DEPS_HASH sh -c "go build ./..."
echo "✅ Go build successful"
echo ""
# 6. Test Go test
echo "6. Testing Go test..."
docker run --rm -v "$(pwd):/workspace" -w /workspace dance-lessons-coach-build-cache:$DEPS_HASH sh -c "go test ./... -v"
echo "✅ Go tests passed"
echo ""
# 7. Test binary build
echo "7. Testing binary build..."
docker run --rm -v "$(pwd):/workspace" -w /workspace dance-lessons-coach-build-cache:$DEPS_HASH sh -c "go build -o /workspace/dance-lessons-coach ./cmd/server"
if [ -f "dance-lessons-coach" ]; then
echo "✅ Binary built successfully"
ls -la dance-lessons-coach
rm dance-lessons-coach
else
echo "❌ Binary build failed"
exit 1
fi
echo ""
# 8. Test production Dockerfile with the cache
echo "8. Testing production Dockerfile..."
# First, let's create a temporary Dockerfile.prod with the correct hash
TEMP_DOCKERFILE="Dockerfile.prod.test"
cat > "$TEMP_DOCKERFILE" << EOF
# dance-lessons-coach Production Docker Image
# Minimal image using pre-built binary from CI cache
# Use the build cache image as base
FROM dance-lessons-coach-build-cache:$DEPS_HASH AS builder
# Final minimal image
FROM alpine:3.18
WORKDIR /app
# Install minimal dependencies
RUN apk add --no-cache ca-certificates tzdata
# Copy binary from builder
COPY --from=builder /workspace/dance-lessons-coach /app/dance-lessons-coach
# Copy configuration
COPY config.yaml /app/config.yaml
# Set permissions
RUN chmod +x /app/dance-lessons-coach
# Set timezone
ENV TZ=UTC
# Expose port
EXPOSE 8080
# Health check
HEALTHCHECK --interval=30s --timeout=3s \
CMD wget -q --spider http://localhost:8080/api/health || exit 1
# Entry point
ENTRYPOINT ["/app/dance-lessons-coach"]
EOF
echo "✅ Created temporary production Dockerfile with correct hash"
echo ""
# 9. Build production image
echo "9. Building production image..."
docker build -t dance-lessons-coach-prod:$DEPS_HASH -f "$TEMP_DOCKERFILE" .
echo "✅ Production image built: dance-lessons-coach-prod:$DEPS_HASH"
echo ""
# 10. Test production image
echo "10. Testing production image..."
docker run -d -p 8081:8080 --name test-prod-container dance-lessons-coach-prod:$DEPS_HASH
sleep 5
# Test health endpoint
if curl -s http://localhost:8081/api/health | grep -q "healthy"; then
echo "✅ Production container is healthy"
else
echo "❌ Production container health check failed"
docker logs test-prod-container
docker stop test-prod-container
docker rm test-prod-container
rm "$TEMP_DOCKERFILE"
exit 1
fi
# Test greet endpoint
if curl -s http://localhost:8081/api/v1/greet/ | grep -q "Hello"; then
echo "✅ Production container greet endpoint working"
else
echo "❌ Production container greet endpoint failed"
docker logs test-prod-container
docker stop test-prod-container
docker rm test-prod-container
rm "$TEMP_DOCKERFILE"
exit 1
fi
echo "✅ Production container is working correctly"
echo ""
# Clean up
echo "11. Cleaning up..."
docker stop test-prod-container > /dev/null 2>&1 || true
docker rm test-prod-container > /dev/null 2>&1 || true
rm "$TEMP_DOCKERFILE"
echo "✅ Cleanup complete"
echo ""
echo "🎉 All tests passed!"
echo "==================="
echo ""
echo "✅ Build cache environment is working correctly"
echo "✅ All Go tools available in container"
echo "✅ Swagger generation works"
echo "✅ Go build and test work"
echo "✅ Production Dockerfile works with cache"
echo "✅ Production container runs successfully"
echo ""
echo "🚀 The build cache is ready for CI/CD use!"
echo ""
echo "💡 To use this in CI/CD:"
echo " 1. The build-cache job will build: dance-lessons-coach-build-cache:$DEPS_HASH"
echo " 2. The CI pipeline will use: docker run dance-lessons-coach-build-cache:$DEPS_HASH ..."
echo " 3. Production build will use: FROM dance-lessons-coach-build-cache:$DEPS_HASH AS builder"
echo ""
echo "📊 Dependency hash for this test: $DEPS_HASH"