feat: SDK relay launch script options (#74)

* feat: robustify launch script and other preps to run on a GH runner

Author: typotter

package-testing/sdk-test-runner/Dockerfile

@@ -3,6 +3,7 @@ FROM node:18-alpine
 WORKDIR /app
 
 COPY package.json  ./
+COPY yarn.lock  ./
 
 RUN yarn install
 

package-testing/sdk-test-runner/README.md

@@ -93,7 +93,10 @@ The following components are required to use the the package test runner with a
 
 1. An **SDK relay server**. This is a REST server running at `localhost:4000` resonding to the [Asssignment and Bandit Request API](#sdk-relay-server)
    1. OR, an **SDK relay client**. This is a client application that connects to the SDK test runner via `socket.io` and responses to [Assignment requests](#sdk-relay-client)
-2. A `build-and-run.sh` file which, given a properly configured environment, [builds the SDK Relay Server application](#build-and-runsh) **using the specified version of the SDK package**.
+2. Launch Script:
+   1. A `build-and-run-<platform>.sh` file which fully configures the environment then initiates a [build and run of the relay server application](#build-and-runsh) **using the specified version of the SDK package**. <platform> is one of `linux`, `macos`, or `windows`.
+   2. OR, a `build-and-run.sh` file which can configure the environment based on the env variable, `PLATFORM` and then initiate a [build and run of the relay server application](#build-and-runsh) **using the specified version of the SDK package**.
+   3. OR, a `docker-run.sh` file which builds and runs a docker container running the SDK relay app
 
 The following are key components derived from above which allow for convenient and consistent dev-ops.
 
@@ -278,6 +281,25 @@ Example `build-and-run.sh` script
 
 #!/usr/bin/env bash
 
+# Configure environment per platform
+case "${PLATFORM}" in
+    "windows")
+        choco install php -v ${PHP_VERSION}
+        ;;
+    "macos")
+        brew install php@${PHP_VERSION}
+        ;;
+    "ubuntu")
+        sudo apt update
+        sudo apt install php-${PHP_VERSION}
+        ;;
+    *)
+        echo "Unsupported platform: ${PLATFORM}"
+        exit 1
+        ;;
+esac
+
+
 composer install
 
 # Set default values for vars

package-testing/sdk-test-runner/test-sdk.sh

@@ -1,4 +1,6 @@
 #!/bin/bash
+trap "exit 1" TERM
+export TOP_PID=$$
 
 # Usage:
 #
@@ -36,6 +38,7 @@ function wait_for_url() {
 
   while [[ $attempt -le $max_attempts ]]; do
     curl --silent --output /dev/null --fail "$url" && { return 1; }
+    echo "Waiting attempt number ${attempt}"
     sleep 1
     ((attempt++))
   done
@@ -45,7 +48,7 @@ function wait_for_url() {
 
 function exit_with_message() {
   echo_red "$1"
-  exit 1
+   kill -s TERM $TOP_PID
 }
 
 # Parse command-line arguments
@@ -67,12 +70,17 @@ export SDK_RELAY_PORT="${SDK_RELAY_PORT:-4000}"
 export EPPO_SCENARIO_FILE="${EPPO_SCENARIO_FILE:-scenarios.json}"
 export EPPO_TEST_DATA_PATH="${EPPO_TEST_DATA_PATH:-./test-data}"
 
-
 # Validate SDK name
 if [[ -z "$SDK_NAME" ]]; then
   exit_with_message "Missing required argument: sdkName"
 fi
 
+# Ensure platform is set
+if [[ -z "$PLATFORM" ]]; then
+  exit_with_message "PLATFORM environment variable must be set"
+fi
+export PLATFORM
+
 # Extrapolate the SDK directory name
 if [[ -z "$SDK_DIR" ]]; then
   SDK_DIR=${SDK_NAME}-relay
@@ -121,10 +129,22 @@ case "$command" in
 
         echo "  ... Starting Test Cluster node [${SDK_DIR}]"
 
-        # change directory to the SDK relay then build-and-run
+        # change directory to the SDK relay then run the SDK relay server
         RUNNER_DIR=$(pwd)
+        mkdir -p ${RUNNER_DIR}/logs
         pushd ../$SDK_DIR
-        ./build-and-run.sh >> ${RUNNER_DIR}/logs/sdk.log 2>&1 &
+
+        BUILD_AND_RUN_PLATFORM=build-and-run-${PLATFORM}.sh
+        if [ -f docker-run.sh ]; then
+           echo "    ... Starting SDK Relay via docker launch script"
+          ./docker-run.sh >> ${RUNNER_DIR}/logs/sdk.log 2>&1 &
+        elif [ -f ${BUILD_AND_RUN_PLATFORM} ]; then
+           echo "    ... Starting SDK Relay via platform build-and-run script"
+          ./${BUILD_AND_RUN_PLATFORM} >> ${RUNNER_DIR}/logs/sdk.log 2>&1 &
+        else
+          exit_with_message "SDK Relay does not have a launch script in $SDK_DIR"
+        fi
+
         SDK_RELAY_PID=$!
         popd
 
@@ -139,6 +159,7 @@ case "$command" in
         echo "  ... Starting Test Cluster node [Eppo-exp/sdk-test-runner]"
 
         docker run \
+          --add-host host.docker.internal:host-gateway \
           -e SDK_NAME \
           -e EPPO_API_HOST=host.docker.internal \
           -e SDK_RELAY_HOST=host.docker.internal \
@@ -148,6 +169,7 @@ case "$command" in
           --name eppo-sdk-test-runner \
           -t Eppo-exp/sdk-test-runner:latest "--junit=logs/results.xml"
 
+        EXIT_CODE=$?
 
         echo "  ... Downing the docker containers"
         docker logs eppo-api >& logs/api.log
@@ -158,7 +180,8 @@ case "$command" in
         docker container remove eppo-sdk-test-runner #already stopped at this point
 
         pkill -P $SDK_RELAY_PID
-        
+
+        exit $EXIT_CODE
         ;;
     client)
         echo_red "Client mode not yet implemented"