476 lines
15 KiB
JavaScript
476 lines
15 KiB
JavaScript
/*
|
|
* Copyright (c) 2015, Joyent, Inc. All rights reserved.
|
|
*
|
|
* Core Triton client driver class.
|
|
*/
|
|
|
|
var p = console.log;
|
|
var assert = require('assert-plus');
|
|
var auth = require('smartdc-auth');
|
|
var EventEmitter = require('events').EventEmitter;
|
|
var fs = require('fs');
|
|
var format = require('util').format;
|
|
var once = require('once');
|
|
var path = require('path');
|
|
var restifyClients = require('restify-clients');
|
|
// We are cheating here. restify-clients should export its 'bunyan'.
|
|
var restifyBunyanSerializers =
|
|
require('restify-clients/lib/helpers/bunyan').serializers;
|
|
var tabula = require('tabula');
|
|
var vasync = require('vasync');
|
|
|
|
var cloudapi = require('./cloudapi2');
|
|
var common = require('./common');
|
|
var errors = require('./errors');
|
|
var loadConfigSync = require('./config').loadConfigSync;
|
|
|
|
|
|
|
|
//---- Triton class
|
|
|
|
/**
|
|
* Create a Triton client.
|
|
*
|
|
* @param options {Object}
|
|
* - log {Bunyan Logger}
|
|
* - profileName {String} Optional. Name of profile to use. Defaults to
|
|
* 'defaultProfile' in the config.
|
|
* - envProfile {Object} Optional. A starter 'env' profile object. Missing
|
|
* fields will be filled in from standard SDC_* envvars.
|
|
* ...
|
|
*/
|
|
function Triton(options) {
|
|
assert.object(options, 'options');
|
|
assert.object(options.log, 'options.log');
|
|
assert.optionalString(options.profileName, 'options.profileName');
|
|
assert.optionalString(options.configPath, 'options.configPath');
|
|
assert.optionalString(options.cacheDir, 'options.cacheDir');
|
|
assert.optionalObject(options.envProfile, 'options.envProfile');
|
|
|
|
// Make sure a given bunyan logger has reasonable client_re[qs] serializers.
|
|
// Note: This was fixed in restify, then broken again in
|
|
// https://github.com/mcavage/node-restify/pull/501
|
|
if (options.log.serializers &&
|
|
(!options.log.serializers.client_req ||
|
|
!options.log.serializers.client_req)) {
|
|
this.log = options.log.child({
|
|
serializers: restifyBunyanSerializers
|
|
});
|
|
} else {
|
|
this.log = options.log;
|
|
}
|
|
this.config = loadConfigSync({
|
|
configPath: options.configPath,
|
|
envProfile: options.envProfile
|
|
});
|
|
this.profiles = this.config.profiles;
|
|
this.profile = this.getProfile(
|
|
options.profileName || this.config.defaultProfile);
|
|
this.log.trace({profile: this.profile}, 'profile data');
|
|
|
|
if (options.cacheDir !== undefined) {
|
|
var slug = common.slug(this.profile);
|
|
this.cacheDir = path.join(options.cacheDir, slug);
|
|
this.log.trace({cacheDir: this.cacheDir}, 'cache dir');
|
|
try {
|
|
fs.mkdirSync(this.cacheDir);
|
|
} catch (e) {}
|
|
}
|
|
|
|
this.cloudapi = this._cloudapiFromProfile(this.profile);
|
|
}
|
|
|
|
|
|
|
|
Triton.prototype.getProfile = function getProfile(name) {
|
|
for (var i = 0; i < this.profiles.length; i++) {
|
|
if (this.profiles[i].name === name) {
|
|
return this.profiles[i];
|
|
}
|
|
}
|
|
};
|
|
|
|
|
|
Triton.prototype._cloudapiFromProfile = function _cloudapiFromProfile(profile) {
|
|
assert.object(profile, 'profile');
|
|
assert.string(profile.account, 'profile.account');
|
|
assert.string(profile.keyId, 'profile.keyId');
|
|
assert.string(profile.url, 'profile.url');
|
|
assert.optionalString(profile.privKey, 'profile.privKey');
|
|
assert.optionalBool(profile.insecure, 'profile.insecure');
|
|
var rejectUnauthorized = (profile.insecure === undefined
|
|
? true : !profile.insecure);
|
|
|
|
var sign;
|
|
if (profile.privKey) {
|
|
sign = auth.privateKeySigner({
|
|
user: profile.account,
|
|
keyId: profile.keyId,
|
|
key: profile.privKey
|
|
});
|
|
} else {
|
|
sign = auth.cliSigner({
|
|
keyId: profile.keyId,
|
|
user: profile.account
|
|
});
|
|
}
|
|
var client = cloudapi.createClient({
|
|
url: profile.url,
|
|
user: profile.account,
|
|
version: '*',
|
|
rejectUnauthorized: rejectUnauthorized,
|
|
sign: sign,
|
|
log: this.log
|
|
});
|
|
return client;
|
|
};
|
|
|
|
/**
|
|
* cloudapi listImages wrapper with optional caching
|
|
*/
|
|
Triton.prototype.listImages = function listImages(opts, cb) {
|
|
var self = this;
|
|
if (cb === undefined) {
|
|
cb = opts;
|
|
opts = {};
|
|
}
|
|
assert.object(opts, 'opts');
|
|
assert.optionalBool(opts.useCache, 'opts.useCache');
|
|
assert.func(cb, 'cb');
|
|
|
|
var cacheFile;
|
|
if (self.cacheDir)
|
|
cacheFile = path.join(self.cacheDir, 'images.json');
|
|
|
|
if (opts.useCache && !cacheFile) {
|
|
cb(new Error('opts.useCache set but no cacheDir found'));
|
|
return;
|
|
}
|
|
|
|
// try to read the cache if the user wants it
|
|
// if this fails for any reason we fallback to hitting the cloudapi
|
|
if (opts.useCache) {
|
|
self.log.debug({file: cacheFile}, 'reading images cache file');
|
|
fs.readFile(cacheFile, 'utf8', function (err, out) {
|
|
if (err) {
|
|
self.log.warn({err: err, cacheFile: cacheFile},
|
|
'failed to read cache file');
|
|
fetch();
|
|
return;
|
|
}
|
|
var data;
|
|
try {
|
|
data = JSON.parse(out);
|
|
} catch (e) {
|
|
self.log.warn({err: e, cacheFile: cacheFile},
|
|
'failed to parse cache file');
|
|
fetch();
|
|
return;
|
|
}
|
|
|
|
self.log.info('calling back with images cache data');
|
|
cb(null, data, {});
|
|
});
|
|
return;
|
|
}
|
|
|
|
fetch();
|
|
function fetch() {
|
|
self.cloudapi.listImages(opts, function (err, imgs, res) {
|
|
if (!err && self.cacheDir) {
|
|
// cache the results
|
|
var data = JSON.stringify(imgs);
|
|
fs.writeFile(cacheFile, data, {encoding: 'utf8'},
|
|
function (err2) {
|
|
if (err2) {
|
|
self.log.info({err: err2},
|
|
'error caching images results');
|
|
}
|
|
self.log.trace({file: cacheFile}, 'images cache updated');
|
|
done();
|
|
});
|
|
} else {
|
|
done();
|
|
}
|
|
|
|
|
|
function done() {
|
|
cb(err, imgs, res);
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Get an image by ID, exact name, or short ID, in that order.
|
|
*
|
|
* If there is more than one image with that name, then the latest
|
|
* (by published_at) is returned.
|
|
*/
|
|
Triton.prototype.getImage = function getImage(name, cb) {
|
|
assert.string(name, 'name');
|
|
assert.func(cb, 'cb');
|
|
|
|
if (common.UUID_RE.test(name)) {
|
|
this.cloudapi.getImage({id: name}, function (err, img) {
|
|
if (err) {
|
|
cb(err);
|
|
} else if (img.state !== 'active') {
|
|
cb(new Error(format('image %s is not active', name)));
|
|
} else {
|
|
cb(null, img);
|
|
}
|
|
});
|
|
} else {
|
|
this.cloudapi.listImages(function (err, imgs) {
|
|
if (err) {
|
|
return cb(err);
|
|
}
|
|
|
|
var nameMatches = [];
|
|
var shortIdMatches = [];
|
|
for (var i = 0; i < imgs.length; i++) {
|
|
var img = imgs[i];
|
|
if (img.name === name) {
|
|
nameMatches.push(img);
|
|
}
|
|
if (img.id.slice(0, 8) === name) {
|
|
shortIdMatches.push(img);
|
|
}
|
|
}
|
|
|
|
if (nameMatches.length === 1) {
|
|
cb(null, nameMatches[0]);
|
|
} else if (nameMatches.length > 1) {
|
|
tabula.sortArrayOfObjects(nameMatches, 'published_at');
|
|
cb(null, nameMatches[nameMatches.length - 1]);
|
|
} else if (shortIdMatches.length === 1) {
|
|
cb(null, shortIdMatches[0]);
|
|
} else if (shortIdMatches.length === 0) {
|
|
cb(new Error(format(
|
|
'no image with name or short id "%s" was found', name)));
|
|
} else {
|
|
cb(new Error(format('no image with name "%s" was found '
|
|
+ 'and "%s" is an ambiguous short id', name)));
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* Get an active package by ID, exact name, or short ID, in that order.
|
|
*
|
|
* If there is more than one package with that name, then this errors out.
|
|
*/
|
|
Triton.prototype.getPackage = function getPackage(name, cb) {
|
|
assert.string(name, 'name');
|
|
assert.func(cb, 'cb');
|
|
|
|
if (common.UUID_RE.test(name)) {
|
|
this.cloudapi.getPackage({id: name}, function (err, pkg) {
|
|
if (err) {
|
|
cb(err);
|
|
} else if (!pkg.active) {
|
|
cb(new Error(format('package %s is not active', name)));
|
|
} else {
|
|
cb(null, pkg);
|
|
}
|
|
});
|
|
} else {
|
|
this.cloudapi.listPackages(function (err, pkgs) {
|
|
if (err) {
|
|
return cb(err);
|
|
}
|
|
|
|
var nameMatches = [];
|
|
var shortIdMatches = [];
|
|
for (var i = 0; i < pkgs.length; i++) {
|
|
var pkg = pkgs[i];
|
|
if (pkg.name === name) {
|
|
nameMatches.push(pkg);
|
|
}
|
|
if (pkg.id.slice(0, 8) === name) {
|
|
shortIdMatches.push(pkg);
|
|
}
|
|
}
|
|
|
|
if (nameMatches.length === 1) {
|
|
cb(null, nameMatches[0]);
|
|
} else if (nameMatches.length > 1) {
|
|
cb(new Error(format(
|
|
'package name "%s" is ambiguous: matches %d packages',
|
|
name, nameMatches.length)));
|
|
} else if (shortIdMatches.length === 1) {
|
|
cb(null, shortIdMatches[0]);
|
|
} else if (shortIdMatches.length === 0) {
|
|
cb(new Error(format(
|
|
'no package with name or short id "%s" was found', name)));
|
|
} else {
|
|
cb(new Error(format('no package with name "%s" was found '
|
|
+ 'and "%s" is an ambiguous short id', name)));
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* Get an network by ID, exact name, or short ID, in that order.
|
|
*
|
|
* If the name is ambiguous, then this errors out.
|
|
*/
|
|
Triton.prototype.getNetwork = function getNetwork(name, cb) {
|
|
assert.string(name, 'name');
|
|
assert.func(cb, 'cb');
|
|
|
|
if (common.isUUID(name)) {
|
|
this.cloudapi.getNetwork(name, function (err, net) {
|
|
if (err) {
|
|
cb(err);
|
|
} else {
|
|
cb(null, net);
|
|
}
|
|
});
|
|
} else {
|
|
this.cloudapi.listNetworks(function (err, nets) {
|
|
if (err) {
|
|
return cb(err);
|
|
}
|
|
|
|
var nameMatches = [];
|
|
var shortIdMatches = [];
|
|
for (var i = 0; i < nets.length; i++) {
|
|
var net = nets[i];
|
|
if (net.name === name) {
|
|
nameMatches.push(net);
|
|
}
|
|
if (net.id.slice(0, 8) === name) {
|
|
shortIdMatches.push(net);
|
|
}
|
|
}
|
|
|
|
if (nameMatches.length === 1) {
|
|
cb(null, nameMatches[0]);
|
|
} else if (nameMatches.length > 1) {
|
|
cb(new Error(format(
|
|
'network name "%s" is ambiguous: matches %d networks',
|
|
name, nameMatches.length)));
|
|
} else if (shortIdMatches.length === 1) {
|
|
cb(null, shortIdMatches[0]);
|
|
} else if (shortIdMatches.length === 0) {
|
|
cb(new Error(format(
|
|
'no network with name or short id "%s" was found', name)));
|
|
} else {
|
|
cb(new Error(format('no network with name "%s" was found '
|
|
+ 'and "%s" is an ambiguous short id', name)));
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* Get an instance by ID, exact name, or short ID, in that order.
|
|
*
|
|
* @param {String} name
|
|
* @param {Function} callback `function (err, inst)`
|
|
*/
|
|
Triton.prototype.getInstance = function getInstance(name, cb) {
|
|
var self = this;
|
|
assert.string(name, 'name');
|
|
assert.func(cb, 'cb');
|
|
|
|
var shortId;
|
|
var inst;
|
|
|
|
vasync.pipeline({funcs: [
|
|
function tryUuid(_, next) {
|
|
var uuid;
|
|
if (common.isUUID(name)) {
|
|
uuid = name;
|
|
} else {
|
|
shortId = common.normShortId(name);
|
|
if (shortId && common.isUUID(shortId)) {
|
|
// E.g. a >32-char docker container ID normalized to a UUID.
|
|
uuid = shortId;
|
|
} else {
|
|
return next();
|
|
}
|
|
}
|
|
self.cloudapi.getMachine(uuid, function (err, inst_) {
|
|
inst = inst_;
|
|
next(err);
|
|
});
|
|
},
|
|
|
|
function tryName(_, next) {
|
|
if (inst) {
|
|
return next();
|
|
}
|
|
|
|
self.cloudapi.listMachines({name: name}, function (err, insts) {
|
|
if (err) {
|
|
return next(err);
|
|
}
|
|
for (var i = 0; i < insts.length; i++) {
|
|
if (insts[i].name === name) {
|
|
inst = insts[i];
|
|
// Relying on rule that instance name is unique
|
|
// for a user and DC.
|
|
return next();
|
|
}
|
|
}
|
|
next();
|
|
});
|
|
},
|
|
|
|
function tryShortId(_, next) {
|
|
if (inst || !shortId) {
|
|
return next();
|
|
}
|
|
var nextOnce = once(next);
|
|
|
|
var match;
|
|
var s = self.cloudapi.createListMachinesStream();
|
|
s.on('error', function (err) {
|
|
nextOnce(err);
|
|
});
|
|
s.on('readable', function () {
|
|
var candidate;
|
|
while ((candidate = s.read()) !== null) {
|
|
if (candidate.id.slice(0, shortId.length) === shortId) {
|
|
if (match) {
|
|
return nextOnce(new Error(
|
|
'instance short id "%s" is ambiguous',
|
|
shortId));
|
|
} else {
|
|
match = candidate;
|
|
}
|
|
}
|
|
}
|
|
});
|
|
s.on('end', function () {
|
|
if (match) {
|
|
inst = match;
|
|
}
|
|
nextOnce();
|
|
});
|
|
}
|
|
]}, function (err) {
|
|
if (err) {
|
|
cb(err);
|
|
} else if (inst) {
|
|
cb(null, inst);
|
|
} else {
|
|
cb(new Error(format(
|
|
'no instance with name or short id "%s" was found', name)));
|
|
}
|
|
});
|
|
};
|
|
|
|
|
|
//---- exports
|
|
|
|
module.exports = Triton;
|