ZauberNerd / sauce-connect-action

A GitHub action to launch Sauce Connect Proxy.

Sauce Connect Proxy GitHub Action

A GitHub action to launch Sauce Connect Proxy.

Example

jobs:
    test:
        runs-on: ubuntu-latest
        name: Action Test
        steps:
            # ...
            - uses: saucelabs/sauce-connect-action@v2
              with:
                  username: ${{ secrets.SAUCE_USERNAME }}
                  accessKey: ${{ secrets.SAUCE_ACCESS_KEY }}
                  tunnelName: github-action-tunnel
                  configFile: ${{ github.workspace }}/sc-configuration/config.yaml
            # ...

Inputs

username:

Required Sauce Labs user name.

accessKey:

Required Sauce Labs API Access Key.

configFile:

Sauce Connect Proxy configuration file.

Only an absolute path to the file is supported at the moment (i.e. must prepend the relative path to the file in the repo with github.workspace, see the example above).

scVersion:

(Optional) version of the saucelabs/sauce-connect docker image. Use the latest sauce-connect release by default.

retryTimeout:

Do not retry if this amount of minutes has passed since starting. (default: "10")

Addiotional configuration

Please refer to Sauce Labs documentation for each option documentation.

• cainfo
• configFile
• directDomains
• fastFailRegexps
• metricsAddress
• noAutodetect
• noSSLBumpDomains
• pac
• proxy
• proxyTunnel
• proxyUserpwd
• region
• scproxyPort
• sePort
• sharedTunnel
• statusAddress
• tunnelDomains
• tunnelIdentifier
• tunnelName
• tunnelPool
• verbose

Sauce Connect Proxy log

Sometimes, it's beneficial to have an access to Sauce Connect Proxy log for debugging or for an audit.

It can be done with upload-artifact GitHub Action. Optionally, a failure condition may be specified in order to store the log only in case of a failure.

jobs:
    test:
        runs-on: ubuntu-latest
        name: Action Test
        steps:
            # ...
            - uses: saucelabs/sauce-connect-action@v2
              with:
                  username: ${{ secrets.SAUCE_USERNAME }}
                  accessKey: ${{ secrets.SAUCE_ACCESS_KEY }}
                  tunnelName: github-action-tunnel
                  configFile: ${{ github.workspace }}/sc-configuration/config.yaml
            # ...

            - uses: actions/upload-artifact@v2
              if: ${{ failure() }}
              with:
                name: sauce-connect-log
                path: ${{ env.SAUCE_CONNECT_DIR_IN_HOST }}/sauce-connect.log