Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
server

GitHub Action

Sauce Connect Proxy Action

v2.2.1

Sauce Connect Proxy Action

server

Sauce Connect Proxy Action

A GitHub action to launch Sauce Connect Proxy

Installation

Copy and paste the following snippet into your .yml file.

 
              
- name: Sauce Connect Proxy Action

              
  uses: saucelabs/[email protected]
Learn more about this action in saucelabs/sauce-connect-action

Choose a version

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