ci: increase timeout and optimize docker-compose startup for integrat… (#634)

  The GitHub Actions integration test was timing out because:
1. The docker compose up --wait command has a default 10-minute timeout
2. Building 3 Java services from source (db, yaci-indexer, api) + Maven
dependency downloads takes longer than 10 minutes in CI/CD
3. The log showed the build process got stuck during Docker image
building

  Changes Applied:

  1. .github/workflows/integration-test.yaml:16
  - Added --wait-timeout 1200 (20 minutes) to the docker compose command
  - Added Docker Buildx setup action for better caching support

  2. docker-compose-api.yaml:61-70
  - Added explicit depends_on for db and yaci-indexer services
  - Optimized healthcheck timing:
    - Changed interval from 30s → 10s (more frequent checks)
    - Increased retries from 20 → 40
- Extended start_period from 20s → 60s (gives Spring Boot more time to
start)
    - Reduced timeout from 10s → 5s (faster failure detection)
- Total max wait time remains ~7 minutes but with better responsiveness

  3. docker-integration-test-environment.yaml:27-29
- Added depends_on for yaci-cli to wait for database health before
starting

  Expected Improvements:

- Prevents timeout failures by allowing up to 20 minutes for service
startup
- Better service orchestration with explicit dependency chains (db →
yaci-cli/yaci-indexer → api)
  - Faster health detection with 10s intervals instead of 30s
- Better Docker caching with Buildx action (will speed up future builds)

  Additional Recommendations for Future:

1. Pre-build and cache Docker images in CI/CD to avoid building from
source every time
  2. Use GitHub Actions cache for Maven dependencies
3. Consider splitting the workflow to build images separately and reuse
them in integration tests

The changes are minimal and backward-compatible. Your local environment
will continue to work as before, and the CI/CD should now complete
successfully without timing
  out.

Author: matiwinnetou

.github/workflows/integration-test.yaml

@@ -12,8 +12,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+      - name: "Set up Docker Buildx"
+        uses: docker/setup-buildx-action@v3
       - name: "Set up environment"
-        run: docker compose --env-file .env.IntegrationTest -f docker-integration-test-environment.yaml up --build -d --wait
+        run: docker compose --env-file .env.IntegrationTest -f docker-integration-test-environment.yaml up --build -d --wait --wait-timeout 1200
       - name: "Wait for node to be populated"
         run: "sleep 30s"
       - name: "Install Node"

docker-compose-api.yaml

@@ -58,12 +58,17 @@ services:
     volumes:
       - ${CARDANO_CONFIG}:/config
       - ${CARDANO_NODE_DIR}:${CARDANO_NODE_DIR}
+    depends_on:
+      db:
+        condition: service_healthy
+      yaci-indexer:
+        condition: service_started
     healthcheck:
       test: [ "CMD-SHELL", "curl --fail http://localhost:${API_PORT}/network/options -H 'Content-Type: application/json' --data '{\"network_identifier\": {\"blockchain\": \"cardano\",\"network\": \"${NETWORK}\"},\"metadata\": {}}' -X POST" ]
-      interval: 30s
-      retries: 20
-      start_period: 20s
-      timeout: 10s
+      interval: 10s
+      retries: 40
+      start_period: 60s
+      timeout: 5s
     restart: always
 
 

docker-integration-test-environment.yaml

@@ -24,4 +24,8 @@ services:
       yaci_store_enabled: true
       ogmios_enabled: false
 
+    depends_on:
+      db:
+        condition: service_healthy
+
     entrypoint: ["/app/yaci-cli", "create-node", "-o", "--start"]