Scriptworker Readme Documentation Status

Scriptworker implements the TaskCluster worker model, then launches a pre-defined script.

This worker was designed for Releng processes that need specific, limited, and pre-defined capabilities.

Free software: MPL2 license


Credentials can live in ./scriptworker.yaml, ./secrets.json, ~/.scriptworker, or in environment variables: TASKCLUSTER_ACCESS_TOKEN, TASKCLUSTER_CLIENT_ID, and TASKCLUSTER_CERTIFICATE.

  • Launch: scriptworker [config_path]


Note: GPG tests require gpg 2.0.x!

Without integration tests, install tox, then

NO_TESTS_OVER_WIRE=1 tox -e py36

With integration tests, first create a client with the scopes:


Then create a ./secrets.json or ~/.scriptworker that looks like:

    "integration_credentials": {
        "clientId": "...",
        "accessToken": "...",
        "certificate": "..."

(certificate is only specified if using temp creds)



It’s also possible to create a ./secrets.json as above, then:

cp docker/Dockerfile.test Dockerfile
docker build -t scriptworker-test . && docker run scriptworker-test tox

GPG Homedir testing

Sometimes it’s nice to be able to test things like rebuild_gpg_homedirs. To do so:

cp docker/Dockerfile.gnupg Dockerfile
docker build -t scriptworker-gpg . && docker run -i scriptworker-gpg bash -il
# in the docker shell,
rebuild_gpg_homedirs scriptworker.yaml

Indices and tables