Skip to content
Terrible CLI hacks until I have more time to do better hacks
Branch: master
Clone or download
Pull request Compare This branch is 52 commits ahead, 289 commits behind taskcluster:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
examples
lib
.gitignore
README.md
package.json

README.md

taskcluster-cli

TaskCluster CLI is a command line interface for creating and managing tasks submitted to TaskCluster.

Requirements

  • node 0.10.30 or greater

Installation

  1. Run npm install -g taskcluster-cli to install taskcluster-cli and required dependencies.

Configuration

Add TaskCluster credential environment variables. This is best done in your shell profile.

export TASKCLUSTER_CLIENT_ID=...
export TASKCLUSTER_ACCESS_TOKEN=...
export TASKCLUSTER_CERTIFICATE=... # the full JSON string

Or you can run taskcluster login which will authenticate you with temporary credentials that will then be stored in a configuration. This is the preferred way of authentication.

Usage

taskcluster run --provisioner-id=<instance provisioner> --worker-type=<worker type> <image> <command>

Example

Create a task that will list the files in a directory on Ubuntu 14.04.

taskcluster run --owner=your@email.com --provisioner-id=aws-provisioner --worker-type=cli ubuntu:14.04 ls
Task Created.
Task ID: 82LOBaruRZaGSXqXc3U6rA
Task State: Pending
[taskcluster] taskId: 82LOBaruRZaGSXqXc3U6rA, workerId: i-56443d59

ubuntu:14.04 exists in the cache.
bin   dev  home  lib64	mnt  proc  run	 srv  tmp  var
boot  etc  lib	 media	opt  root  sbin  sys  usr
[taskcluster] Successful task run with exit code: 0 completed in 1.337 seconds

Create a task that will list the packages installed on Ubuntu 14.04

taskcluster run --owner=your@email.com --provisioner-id=aws-provisioner --worker-type=cli ubuntu:14.04 -- /usr/bin/dpkg --list

Task Created.
Task ID: 5y3HM2dcRSWbegZp0MS-hg
Task State: Pending
[taskcluster] taskId: 5y3HM2dcRSWbegZp0MS-hg, workerId: i-aa67c563

Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend
|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)
||/ Name           Version      Architecture Description
+++-==============-============-============-=================================
ii  adduser        3.113+nmu3ub all          add and remove users and groups
....
[taskcluster] Successful task run with exit code: 0 completed in 10.279 seconds
Task Completed
You can’t perform that action at this time.