Add composite actions to run the experiments

.github/actions/gradle/README.md

@@ -0,0 +1,40 @@
+# Composite GitHub Actions
+
+The composite actions provided here will simplify running the build validation scripts from your GitHub Actions workflow.
+
+## Usage
+
+Create a GitHub Actions workflow, add the steps to configure the build requirements like JDK, etc., and then add the
+following steps to invoke the actual experiments:
+
+```yaml
+steps:
+  # Download the latest version of the build validation scripts
+  - uses: gradle/gradle-enterprise-build-validation-scripts/.github/actions/gradle/[email protected]
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+  # Run experiment 1
+  - uses: gradle/gradle-enterprise-build-validation-scripts/.github/actions/gradle/[email protected]
+    with:
+      gitRepo: <PROJECT_GIT_URL>
+      gitBranch: <PROJECT_BRANCH>
+      tasks: <PROJECT_BUILD_TASK>
+      ...
+  # Run experiment 2
+  - uses: gradle/gradle-enterprise-build-validation-scripts/.github/actions/gradle/[email protected]
+    with:
+      gitRepo: <PROJECT_GIT_URL>
+      gitBranch: <PROJECT_BRANCH>
+      tasks: <PROJECT_BUILD_TASK>
+      ...
+    # Run experiment 3
+  - uses: gradle/gradle-enterprise-build-validation-scripts/.github/actions/gradle/[email protected]
+    with:
+      gitRepo: <PROJECT_GIT_URL>
+      gitBranch: <PROJECT_BRANCH>
+      tasks: <PROJECT_BUILD_TASK>
+      ...
+```
+
+Once the workflow has been triggered and finishes executing, you can navigate to the workflow's output and investigate the summary
+produced by the build validation scripts.

.github/actions/gradle/download/action.yml

@@ -0,0 +1,33 @@
+name: Download latest Gradle build validation scripts
+description: "Downloads the latest release of the build validation scripts for Gradle"
+
+inputs:
+  token:
+    description: "GitHub token"
+    required: false
+
+runs:
+  using: "composite"
+  steps:
+    - name: Download latest build Gradle validation scripts
+      run: |
+        authHeader=""
+        if [ ! -z "${{ inputs.token }}" ]; then
+          authHeader="--header 'Authorization: Bearer ${{ inputs.token }}'"
+        fi
+
+        # Build the command to get the details of the latest version of the build validation scripts
+        cmdGetLatestReleaseData="curl -s $authHeader https://api.github.com/repos/gradle/gradle-enterprise-build-validation-scripts/releases/latest"
+
+        # Get the download url of the latest version of the build validation scripts
+        downloadUrl=$($cmdGetLatestReleaseData | jq -c '.assets[] | select(.content_type == "application/zip")' | jq -r .browser_download_url | grep -v maven)
+
+        # Build the command to download the latest version of the build validation scripts
+        cmdGetLatestRelease="curl -s -L $authHeader -o gradle-enterprise-gradle-build-validation.zip $downloadUrl"
+
+        # Download the latest version of the build validation scripts
+        eval "$cmdGetLatestRelease"
+
+        # Unzip the downloaded build validation scripts
+        unzip -q -o gradle-enterprise-gradle-build-validation.zip
+      shell: bash

.github/actions/gradle/experiment-1/action.yml

@@ -0,0 +1,63 @@
+name: Run experiment 1
+description: "Runs experiment 1 of the build validation scripts for Gradle"
+
+inputs:
+  gitRepo:
+    description: "The URL for the Git repository to validate"
+    required: true
+  gitBranch:
+    description: "The branch for the Git repository to validate"
+    required: false
+  gitCommitId:
+    description: "The Git commit id for the Git repository to validate"
+    required: false
+  projectDir:
+    description: "The build invocation directory within the Git repository"
+    required: false
+  tasks:
+    description: "The Gradle tasks to invoke"
+    required: false
+  args:
+    description: "Additional arguments to pass to Gradle"
+    required: false
+  gradleEnterpriseUrl:
+    description: "The URL for the Gradle Enterprise server to connect to"
+    required: false
+  enableGradleEnterprise:
+    description: "Enables Gradle Enterprise on a project not already connected"
+    required: false
+
+runs:
+  using: "composite"
+  steps:
+    - name: Run Gradle Experiment 1
+      id: run
+      run: |
+        cd gradle-enterprise-gradle-build-validation
+
+        EXTRA_ARGS=""
+        if [ ! -z "${{ inputs.gitBranch }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -b ${{ inputs.gitBranch }}"
+        fi
+        if [ ! -z "${{ inputs.gitCommitId }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -c ${{ inputs.gitCommitId }}"
+        fi
+        if [ ! -z "${{ inputs.projectDir }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -p ${{ inputs.projectDir }}"
+        fi
+        if [ ! -z "${{ inputs.tasks }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -t ${{ inputs.tasks }}"
+        fi
+        if [ ! -z "${{ inputs.args }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -a ${{ inputs.args }}"
+        fi
+        if [ ! -z "${{ inputs.gradleEnterpriseUrl }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -s ${{ inputs.gradleEnterpriseUrl }}"
+        fi
+        if [ ! -z "${{ inputs.enableGradleEnterprise }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -e"
+        fi
+
+        # run experiment
+        ./01-validate-incremental-building.sh -r ${{ inputs.gitRepo }} $EXTRA_ARGS
+      shell: bash

.github/actions/gradle/experiment-2/action.yml

@@ -0,0 +1,63 @@
+name: Run experiment 2
+description: "Runs experiment 2 of the build validation scripts for Gradle"
+
+inputs:
+  gitRepo:
+    description: "The URL for the Git repository to validate"
+    required: true
+  gitBranch:
+    description: "The branch for the Git repository to validate"
+    required: false
+  gitCommitId:
+    description: "The Git commit id for the Git repository to validate"
+    required: false
+  projectDir:
+    description: "The build invocation directory within the Git repository"
+    required: false
+  tasks:
+    description: "The Gradle tasks to invoke"
+    required: false
+  args:
+    description: "Additional arguments to pass to Gradle"
+    required: false
+  gradleEnterpriseUrl:
+    description: "The URL for the Gradle Enterprise server to connect to"
+    required: false
+  enableGradleEnterprise:
+    description: "Enables Gradle Enterprise on a project not already connected"
+    required: false
+
+runs:
+  using: "composite"
+  steps:
+    - name: Run Gradle Experiment 2
+      id: run
+      run: |
+        cd gradle-enterprise-gradle-build-validation
+
+        EXTRA_ARGS=""
+        if [ ! -z "${{ inputs.gitBranch }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -b ${{ inputs.gitBranch }}"
+        fi
+        if [ ! -z "${{ inputs.gitCommitId }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -c ${{ inputs.gitCommitId }}"
+        fi
+        if [ ! -z "${{ inputs.projectDir }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -p ${{ inputs.projectDir }}"
+        fi
+        if [ ! -z "${{ inputs.tasks }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -t ${{ inputs.tasks }}"
+        fi
+        if [ ! -z "${{ inputs.args }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -a ${{ inputs.args }}"
+        fi
+        if [ ! -z "${{ inputs.gradleEnterpriseUrl }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -s ${{ inputs.gradleEnterpriseUrl }}"
+        fi
+        if [ ! -z "${{ inputs.enableGradleEnterprise }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -e"
+        fi
+
+        # run experiment
+        ./02-validate-local-build-caching-same-location.sh -r ${{ inputs.gitRepo }} $EXTRA_ARGS
+      shell: bash

.github/actions/gradle/experiment-3/action.yml

@@ -0,0 +1,63 @@
+name: Run experiment 3
+description: "Runs experiment 3 of the build validation scripts for Gradle"
+
+inputs:
+  gitRepo:
+    description: "The URL for the Git repository to validate"
+    required: true
+  gitBranch:
+    description: "The branch for the Git repository to validate"
+    required: false
+  gitCommitId:
+    description: "The Git commit id for the Git repository to validate"
+    required: false
+  projectDir:
+    description: "The build invocation directory within the Git repository"
+    required: false
+  tasks:
+    description: "The Gradle tasks to invoke"
+    required: false
+  args:
+    description: "Additional arguments to pass to Gradle"
+    required: false
+  gradleEnterpriseUrl:
+    description: "The URL for the Gradle Enterprise server to connect to"
+    required: false
+  enableGradleEnterprise:
+    description: "Enables Gradle Enterprise on a project not already connected"
+    required: false
+
+runs:
+  using: "composite"
+  steps:
+    - name: Run Gradle Experiment 3
+      id: run
+      run: |
+        cd gradle-enterprise-gradle-build-validation
+
+        EXTRA_ARGS=""
+        if [ ! -z "${{ inputs.gitBranch }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -b ${{ inputs.gitBranch }}"
+        fi
+        if [ ! -z "${{ inputs.gitCommitId }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -c ${{ inputs.gitCommitId }}"
+        fi
+        if [ ! -z "${{ inputs.projectDir }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -p ${{ inputs.projectDir }}"
+        fi
+        if [ ! -z "${{ inputs.tasks }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -t ${{ inputs.tasks }}"
+        fi
+        if [ ! -z "${{ inputs.args }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -a ${{ inputs.args }}"
+        fi
+        if [ ! -z "${{ inputs.gradleEnterpriseUrl }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -s ${{ inputs.gradleEnterpriseUrl }}"
+        fi
+        if [ ! -z "${{ inputs.enableGradleEnterprise }}" ]; then
+          EXTRA_ARGS="$EXTRA_ARGS -e"
+        fi
+
+        # run experiment
+        ./03-validate-local-build-caching-different-locations.sh -r ${{ inputs.gitRepo }} $EXTRA_ARGS
+      shell: bash