2014-02-12 22:22:08 +02:00
|
|
|
`sdc` is a CLI for Joyent SmartDataCenter and the
|
2015-05-19 00:07:45 +03:00
|
|
|
Joyent Public Cloud (<https://my.joyent.com>,
|
2014-02-12 22:22:08 +02:00
|
|
|
<http://www.joyent.com/products/compute-service>).
|
2014-02-07 23:21:24 +02:00
|
|
|
|
|
|
|
# Installation
|
|
|
|
|
|
|
|
1. Install [node.js](http://nodejs.org/).
|
2014-02-12 22:22:08 +02:00
|
|
|
2. `npm install -g sdc`
|
2014-02-07 23:21:24 +02:00
|
|
|
|
|
|
|
Verify that installed and is on your PATH:
|
|
|
|
|
2014-02-12 22:22:08 +02:00
|
|
|
$ sdc --version
|
|
|
|
sdc CLI 1.0.0
|
2014-02-07 23:21:24 +02:00
|
|
|
|
|
|
|
Before you can used the CLI you'll need a Joyent account, an SSH key uploaded
|
2014-02-12 22:22:08 +02:00
|
|
|
and `sdc` configured with those account details.
|
2014-02-07 23:21:24 +02:00
|
|
|
|
|
|
|
# Setup
|
|
|
|
|
|
|
|
TODO
|
|
|
|
|
|
|
|
# Getting Started
|
|
|
|
|
|
|
|
TODO
|
2014-02-20 05:52:58 +02:00
|
|
|
|
|
|
|
|
2014-02-21 01:45:15 +02:00
|
|
|
# node-sdc 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`.
|
|
|
|
|
2014-02-20 05:52:58 +02:00
|
|
|
|
|
|
|
# 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.
|
|
|
|
|