end-to-end-tests.yaml

# The workflow can be triggered manually.
# It will build and deploy Klaw and run E2E tests against it.
# The E2E test is very basic and only makes sure that the app
# including Coral is built successfully.
name: E2E tests
on:
  - workflow_dispatch
  - workflow_call

jobs:
  end-to-end-tests:
    permissions:
      actions: write
    timeout-minutes: 60
    runs-on: ubuntu-latest


    steps:
      - name: Checkout code
        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

      - name: Set Node and pnpm versions
        id: versions
        working-directory: ./e2e
        shell: bash
        run: |
          NODE_VERSION=$(jq -r '.engines.node' package.json)
          PNPM_VERSION=$(jq -r '.engines.pnpm' package.json)
          echo "NODE_VERSION=$NODE_VERSION" >> $GITHUB_OUTPUT
          echo "PNPM_VERSION=$PNPM_VERSION" >> $GITHUB_OUTPUT

      - name: Setup node.js
        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0
        with:
          node-version: ${{ steps.versions.outputs.NODE_VERSION }}

      # PNPM needs to be available for coral in the build
      - name: Setup pnpm
        uses: pnpm/action-setup@fe02b34f77f8bc703788d5817da081398fad5dd2 # v4.0.0
        with:
          version: ${{ steps.versions.outputs.PNPM_VERSION }}
          run_install: false

      - name: Get pnpm store directory
        id: pnpm-cache
        shell: bash
        run: |
          echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT

      - name: Setup pnpm cache
        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
        with:
          path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
          restore-keys: |
            ${{ runner.os }}-pnpm-store-

      - name: Set up JDK
        uses: actions/setup-java@8df1039502a15bceb9433410b1a100fbe190c53b # v4.5.0
        with:
          java-version: 20
          distribution: 'temurin'
          cache: maven

      - name: Build Klaw
        working-directory: ./e2e
        run: pnpm __build-klaw

      # @TODO: make sure Klaw always runs on a predictable address
      # then this step is unnecessary
      - name: Get container network address
        id: containerIp
        shell: bash
        run: |
          container_name="klaw-core"
          container_ip=$(docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' "$container_name")

          if [ -n "$container_ip" ]; then
            echo "Container is running at IP address: $container_ip"
            echo "CONTAINER_IP=$container_ip" >> $GITHUB_OUTPUT
          else
            echo "Container not found or not running"
            exit 1
          fi
          
      # This step may be brittle. The service in the container seems not to
      # be immediately ready to accept connections, so the retry makes sure
      # we're giving it (hopefully) enough time to be ready.
      - name: Make sure Klaw is reachable
        id: klaw-build-reachable
        run:  |
          retries=5  # Number of retries
          interval=5  # Initial retry interval in seconds
          max_interval=30  # Max retry interval in seconds
          success=false
          
          echo "Check that Klaw is running on ${{ steps.containerIp.outputs.CONTAINER_IP}}:9097"
  
          for ((i = 0; i < retries; i++)); do
            if curl --fail --silent "${{ steps.containerIp.outputs.CONTAINER_IP}}:9097"; then
            success=true
            break 
          fi
          
          # Sleep before the next retry with exponential backoff
          sleep $interval
          interval=$((interval * 2))
        
          # Ensure the interval doesn't exceed the maximum
          if [ $interval -gt $max_interval ]; then
            interval=$max_interval
          fi
          done
          
          if [ "$success" = false ]; then
            echo "Klaw is not reachable 😭"
            exit 1 
          fi

      - name: Install dependencies
        working-directory: ./e2e
        run: pnpm install

      - name: Install Playwright browsers
        working-directory: ./e2e
        run: pnpm playwright install --with-deps chromium

      - name: Run Playwright tests
        working-directory: ./e2e
        run: BASE_URL=http://${{ steps.containerIp.outputs.CONTAINER_IP }}:9097 pnpm __test

      - name: Upload Playwright artifacts
        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
        if: ${{ !cancelled() }}
        with:
          name: playwright-report
          path: ./e2e/playwright-report/
          retention-days: 5

      - name: Teardown Klaw
        if: always()
        run:  docker-scripts/klaw-docker.sh --destroy