Skip to content

Sets up the stackql cli in your GitHub Actions workflow.

Notifications You must be signed in to change notification settings

stackql/setup-stackql

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

Setup StackQL

setup-stackql

The stackql/setup-stackql action is a JavaScript action that sets up StackQL CLI in your GitHub Actions workflow by downloading a latest Stackql CLI and adding it to the PATH.

This action can be run on ubuntu-latest, windows-latest, and macos-latest GitHub Actions runners, and will install and expose the latest version of the stackql CLI on the runner environment.

Usage

Authentication to StackQL providers is done via environment variables source from GitHub Actions Secrets. To learn more about authentication, see the setup instructions for your provider or providers at the StackQL Provider Registry Docs.

Examples

The following example demonstrate the use of the stackql/setup-stackql action in a GitHub Actions workflow, demonstrating how to use the action to install the stackql CLI and then use it to execute a StackQL query.

GitHub Example

Check the "Use GitHub Provider" step in setup-stackql-test.yml for the working example, for more information on the GitHub provider for StackQL, see the GitHub Provider Docs.

    - name: setup StackQL
      uses: stackql/[email protected]
      with:
        use_wrapper: true

    - name: Use GitHub Provider
      run: |
        stackql exec -i ./examples/github-example.iql
      env: 
        STACKQL_GITHUB_USERNAME: ${{  secrets.STACKQL_GITHUB_USERNAME }}
        STACKQL_GITHUB_PASSWORD: ${{  secrets.STACKQL_GITHUB_PASSWORD }}

Google Example

Check the "Use Google Provider" step in setup-stackql-test.yml for the working example, for more information on the Google provider for StackQL, see the Google Provider Docs.

    - name: setup StackQL
      uses: stackql/[email protected]
      with:
        use_wrapper: true

    - name: Use Google Provider
      run: | 
        stackql exec -i ./examples/google-example.iql
      env: 
        GOOGLE_CREDENTIALS : ${{  secrets.GOOGLE_CREDENTIALS  }}

Inputs

  • use_wrapper - (optional) Whether to install a wrapper to wrap subsequent calls of the stackql binary and expose its STDOUT, STDERR, and exit code as outputs named stdout, stderr, and exitcode respectively. Defaults to false.

Outputs

This action does not configure any outputs directly. However, when you set the use_wrapper input to true, the following outputs are available for subsequent steps that call the stackql binary:

  • stdout - The STDOUT stream of the call to the stackql binary.
  • stderr - The STDERR stream of the call to the stackql binary.
  • exitcode - The exit code of the call to the stackql binary.