This repository has been archived on 2020-01-20. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Dave Eddy 0fee17fda0 getting ready for OSS
- s/triton/tritonapi/
- s/Triton/TritonApi/
- s/CloudAPI/CloudApi/
2015-09-04 14:05:36 -04:00
bin drop cruft and debugging/commented code 2015-09-02 01:06:00 -07:00
deps first commit 2014-02-07 13:21:24 -08:00
etc completion handled by node-cmdln 2015-09-04 13:01:00 -04:00
examples joyentcloud.com is deprecated, use joyent.com. 2015-05-18 14:07:45 -07:00
lib getting ready for OSS 2015-09-04 14:05:36 -04:00
test lots of unit tests 2015-09-02 15:38:27 -04:00
tools 'make git-hooks' to install hooks 2015-09-01 10:55:39 -07:00
.gitignore bash completion support 2015-09-04 00:09:19 -07:00
.gitmodules first commit 2014-02-07 13:21:24 -08:00
.npmignore bash completion support 2015-09-04 00:09:19 -07:00
CHANGES.md starting the rename 2015-08-25 11:49:46 -07:00
Makefile more assertions in common, ensure tests run with assertions 2015-09-02 23:30:07 -04:00
package.json use latest published cmdln with bash completions 2015-09-04 10:55:10 -07:00
README.md bash completion support 2015-09-04 00:09:19 -07:00
TODO.txt bash completion support 2015-09-04 00:09:19 -07:00

Triton

triton is a CLI tool for Joyent's Triton (a.k.a. SmartDataCenter), either for on-premises installations of Triton or Joyent's Public Cloud (https://my.joyent.com, http://www.joyent.com/products/compute-service).

This project is experimental and probably broken. For now, please look at node-smartdc.

Installation

  1. Install node.js.
  2. npm install -g git://github.com/joyent/node-triton

Verify that installed and is on your PATH:

$ triton --version
Triton client 1.0.0

Before you can used the CLI you'll need a Joyent account, an SSH key uploaded and triton configured with those account details.

Setup

TODO

Example

Get a quick overview of your account

$ triton info
dave.eddy@joyent.com - Dave Eddy <dave.eddy@joyent.com>
https://us-east-3b.api.joyent.com

5 instance(s)
- 1 stopped
- 4 running
- 610.3 MiB RAM Total
- 14.3 GiB Disk Total

See running instances

$ triton instances
ID                                    NAME       STATE    TYPE          IMG                                   MEMORY  DISK  AGO
908a781b-e4c8-4291-dcf5-b0fcbcc0cb8a  machine-1  stopped  smartmachine  5c7d0d24-3475-11e5-8e67-27953a8b237e  128     3072  2h
7807f369-79eb-ebe9-85f6-db3017a75f0f  machine-2  running  smartmachine  5c7d0d24-3475-11e5-8e67-27953a8b237e  128     3072  2h
a2d537b4-feb1-c530-f1ff-e034eb73adaa  machine-3  running  smartmachine  5c7d0d24-3475-11e5-8e67-27953a8b237e  128     3072  2h
7db6c907-2693-42bc-ea9b-f38678f2554b  machine-4  running  smartmachine  5c7d0d24-3475-11e5-8e67-27953a8b237e  128     3072  2h
8892b12f-60e9-c4ba-f0f8-a4ca9714ea9c  machine-5  running  smartmachine  5c7d0d24-3475-11e5-8e67-27953a8b237e  128     3072  2h

Connect to an instance over SSH

$ triton ssh machine-4
Last login: Wed Aug 26 17:59:35 2015 from 208.184.5.170
   __        .                   .
 _|  |_      | .-. .  . .-. :--. |-
|_    _|     ;|   ||  |(.-' |  | |
  |__|   `--'  `-' `;-| `-' '  ' `-'
                   /  ; Instance (base-64 15.2.0)
                   `-'  https://docs.joyent.com/images/smartos/base

[root@7db6c907-2693-42bc-ea9b-f38678f2554b ~]# uptime
 20:08pm  up   2:27,  0 users,  load average: 0.00, 0.00, 0.01
[root@7db6c907-2693-42bc-ea9b-f38678f2554b ~]# logout
Connection to 165.225.169.63 closed.

Or non-interactively

$ triton ssh machine-4 uname -v
joyent_20150826T120743Z

Bash completion

You can quickly source triton bash completions in your current shell with:

source <(triton completion)

For a more permanent installation:

triton completion >> ~/.bashrc

# Or maybe:
triton completion > /usr/local/etc/bash_completion.d/triton

node-triton differences with node-smartdc

  • There is a single sdc command instead of a number of sdc-FOO commands.
  • The SDC_USER envvar is accepted in preference to SDC_ACCOUNT.

cloudapi2.js differences with node-smartdc/lib/cloudapi.js

The old node-smartdc module included an lib for talking directly to the SDC Cloud API (node-smartdc/lib/cloudapi.js). Part of this module (node-sdc) is a re-write of the Cloud API lib with some backward incompatibilities. The differences and backward incompatibilities are discussed here.

  • Currently no caching options in cloudapi2.js (this should be re-added in some form). The noCache option to many of the cloudapi.js methods will not be re-added, it was a wart.
  • The leading account option to each cloudapi.js method has been dropped. It was redundant for the constructor account option.
  • "account" is now "user" in the CloudAPI constructor.
  • All (all? at least at the time of this writing) methods in cloudapi2.js have a signature of function (options, callback) instead of the sometimes haphazard extra arguments.

Development Hooks

Before commiting be sure to:

make check      # lint and style checks
make test       # run unit tests

A good way to do that is to install the stock pre-commit hook in your clone via:

make git-hooks