diff --git a/Tasks/AzureIoTEdgeV2/task.json b/Tasks/AzureIoTEdgeV2/task.json index ce09d2221f8e..c0c381ab90e7 100644 --- a/Tasks/AzureIoTEdgeV2/task.json +++ b/Tasks/AzureIoTEdgeV2/task.json @@ -14,7 +14,7 @@ "version": { "Major": 2, "Minor": 0, - "Patch": 3 + "Patch": 4 }, "preview": true, "instanceNameFormat": "Azure IoT Edge - $(action)", diff --git a/Tasks/AzureMysqlDeploymentV1/task.json b/Tasks/AzureMysqlDeploymentV1/task.json index 0253ebeb8033..81b03e3eac9b 100644 --- a/Tasks/AzureMysqlDeploymentV1/task.json +++ b/Tasks/AzureMysqlDeploymentV1/task.json @@ -17,7 +17,7 @@ "version": { "Major": 1, "Minor": 0, - "Patch": 16 + "Patch": 17 }, "demands": [], "minimumAgentVersion": "1.100.0", diff --git a/Tasks/AzureVmssDeploymentV0/task.json b/Tasks/AzureVmssDeploymentV0/task.json index e1752862338c..330584bda41a 100644 --- a/Tasks/AzureVmssDeploymentV0/task.json +++ b/Tasks/AzureVmssDeploymentV0/task.json @@ -15,7 +15,7 @@ "version": { "Major": 0, "Minor": 0, - "Patch": 25 + "Patch": 26 }, "demands": [], "minimumAgentVersion": "2.0.0", diff --git a/Tasks/Common/kubernetes-common/Strings/resources.resjson/en-US/resources.resjson b/Tasks/Common/kubernetes-common/Strings/resources.resjson/en-US/resources.resjson new file mode 100644 index 000000000000..9e26dfeeb6e6 --- /dev/null +++ b/Tasks/Common/kubernetes-common/Strings/resources.resjson/en-US/resources.resjson @@ -0,0 +1 @@ +{} \ No newline at end of file diff --git a/Tasks/Common/kubernetes-common/globals/node/index.d.ts b/Tasks/Common/kubernetes-common/globals/node/index.d.ts new file mode 100644 index 000000000000..1dc54b352d88 --- /dev/null +++ b/Tasks/Common/kubernetes-common/globals/node/index.d.ts @@ -0,0 +1,3350 @@ +// Generated by typings +// Source: https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/ab8d917787092fdfb16390f2bee6de8ab5c1783c/node/node.d.ts +interface Error { + stack?: string; +} + +interface ErrorConstructor { + captureStackTrace(targetObject: Object, constructorOpt?: Function): void; + stackTraceLimit: number; +} + +// compat for TypeScript 1.8 +// if you use with --target es3 or --target es5 and use below definitions, +// use the lib.es6.d.ts that is bundled with TypeScript 1.8. +interface MapConstructor { } +interface WeakMapConstructor { } +interface SetConstructor { } +interface WeakSetConstructor { } + +/************************************************ +* * +* GLOBAL * +* * +************************************************/ +declare var process: NodeJS.Process; +declare var global: NodeJS.Global; + +declare var __filename: string; +declare var __dirname: string; + +declare function setTimeout(callback: (...args: any[]) => void, ms: number, ...args: any[]): NodeJS.Timer; +declare function clearTimeout(timeoutId: NodeJS.Timer): void; +declare function setInterval(callback: (...args: any[]) => void, ms: number, ...args: any[]): NodeJS.Timer; +declare function clearInterval(intervalId: NodeJS.Timer): void; +declare function setImmediate(callback: (...args: any[]) => void, ...args: any[]): any; +declare function clearImmediate(immediateId: any): void; + +interface NodeRequireFunction { + (id: string): any; +} + +interface NodeRequire extends NodeRequireFunction { + resolve(id: string): string; + cache: any; + extensions: any; + main: any; +} + +declare var require: NodeRequire; + +interface NodeModule { + exports: any; + require: NodeRequireFunction; + id: string; + filename: string; + loaded: boolean; + parent: any; + children: any[]; +} + +declare var module: NodeModule; + +// Same as module.exports +declare var exports: any; +declare var SlowBuffer: { + new (str: string, encoding?: string): Buffer; + new (size: number): Buffer; + new (size: Uint8Array): Buffer; + new (array: any[]): Buffer; + prototype: Buffer; + isBuffer(obj: any): boolean; + byteLength(string: string, encoding?: string): number; + concat(list: Buffer[], totalLength?: number): Buffer; +}; + + +// Buffer class +type BufferEncoding = "ascii" | "utf8" | "utf16le" | "ucs2" | "binary" | "hex"; +interface Buffer extends NodeBuffer { } + +/** + * Raw data is stored in instances of the Buffer class. + * A Buffer is similar to an array of integers but corresponds to a raw memory allocation outside the V8 heap. A Buffer cannot be resized. + * Valid string encodings: 'ascii'|'utf8'|'utf16le'|'ucs2'(alias of 'utf16le')|'base64'|'binary'(deprecated)|'hex' + */ +declare var Buffer: { + /** + * Allocates a new buffer containing the given {str}. + * + * @param str String to store in buffer. + * @param encoding encoding to use, optional. Default is 'utf8' + */ + new (str: string, encoding?: string): Buffer; + /** + * Allocates a new buffer of {size} octets. + * + * @param size count of octets to allocate. + */ + new (size: number): Buffer; + /** + * Allocates a new buffer containing the given {array} of octets. + * + * @param array The octets to store. + */ + new (array: Uint8Array): Buffer; + /** + * Produces a Buffer backed by the same allocated memory as + * the given {ArrayBuffer}. + * + * + * @param arrayBuffer The ArrayBuffer with which to share memory. + */ + new (arrayBuffer: ArrayBuffer): Buffer; + /** + * Allocates a new buffer containing the given {array} of octets. + * + * @param array The octets to store. + */ + new (array: any[]): Buffer; + /** + * Copies the passed {buffer} data onto a new {Buffer} instance. + * + * @param buffer The buffer to copy. + */ + new (buffer: Buffer): Buffer; + prototype: Buffer; + /** + * Allocates a new Buffer using an {array} of octets. + * + * @param array + */ + from(array: any[]): Buffer; + /** + * When passed a reference to the .buffer property of a TypedArray instance, + * the newly created Buffer will share the same allocated memory as the TypedArray. + * The optional {byteOffset} and {length} arguments specify a memory range + * within the {arrayBuffer} that will be shared by the Buffer. + * + * @param arrayBuffer The .buffer property of a TypedArray or a new ArrayBuffer() + * @param byteOffset + * @param length + */ + from(arrayBuffer: ArrayBuffer, byteOffset?: number, length?: number): Buffer; + /** + * Copies the passed {buffer} data onto a new Buffer instance. + * + * @param buffer + */ + from(buffer: Buffer): Buffer; + /** + * Creates a new Buffer containing the given JavaScript string {str}. + * If provided, the {encoding} parameter identifies the character encoding. + * If not provided, {encoding} defaults to 'utf8'. + * + * @param str + */ + from(str: string, encoding?: string): Buffer; + /** + * Returns true if {obj} is a Buffer + * + * @param obj object to test. + */ + isBuffer(obj: any): obj is Buffer; + /** + * Returns true if {encoding} is a valid encoding argument. + * Valid string encodings in Node 0.12: 'ascii'|'utf8'|'utf16le'|'ucs2'(alias of 'utf16le')|'base64'|'binary'(deprecated)|'hex' + * + * @param encoding string to test. + */ + isEncoding(encoding: string): boolean; + /** + * Gives the actual byte length of a string. encoding defaults to 'utf8'. + * This is not the same as String.prototype.length since that returns the number of characters in a string. + * + * @param string string to test. + * @param encoding encoding used to evaluate (defaults to 'utf8') + */ + byteLength(string: string, encoding?: string): number; + /** + * Returns a buffer which is the result of concatenating all the buffers in the list together. + * + * If the list has no items, or if the totalLength is 0, then it returns a zero-length buffer. + * If the list has exactly one item, then the first item of the list is returned. + * If the list has more than one item, then a new Buffer is created. + * + * @param list An array of Buffer objects to concatenate + * @param totalLength Total length of the buffers when concatenated. + * If totalLength is not provided, it is read from the buffers in the list. However, this adds an additional loop to the function, so it is faster to provide the length explicitly. + */ + concat(list: Buffer[], totalLength?: number): Buffer; + /** + * The same as buf1.compare(buf2). + */ + compare(buf1: Buffer, buf2: Buffer): number; + /** + * Allocates a new buffer of {size} octets. + * + * @param size count of octets to allocate. + * @param fill if specified, buffer will be initialized by calling buf.fill(fill). + * If parameter is omitted, buffer will be filled with zeros. + * @param encoding encoding used for call to buf.fill while initalizing + */ + alloc(size: number, fill?: string | Buffer | number, encoding?: string): Buffer; + /** + * Allocates a new buffer of {size} octets, leaving memory not initialized, so the contents + * of the newly created Buffer are unknown and may contain sensitive data. + * + * @param size count of octets to allocate + */ + allocUnsafe(size: number): Buffer; + /** + * Allocates a new non-pooled buffer of {size} octets, leaving memory not initialized, so the contents + * of the newly created Buffer are unknown and may contain sensitive data. + * + * @param size count of octets to allocate + */ + allocUnsafeSlow(size: number): Buffer; +}; + +/************************************************ +* * +* GLOBAL INTERFACES * +* * +************************************************/ +declare namespace NodeJS { + export interface ErrnoException extends Error { + errno?: string; + code?: string; + path?: string; + syscall?: string; + stack?: string; + } + + export class EventEmitter { + addListener(event: string|symbol, listener: Function): this; + on(event: string|symbol, listener: Function): this; + once(event: string|symbol, listener: Function): this; + removeListener(event: string|symbol, listener: Function): this; + removeAllListeners(event?: string|symbol): this; + setMaxListeners(n: number): this; + getMaxListeners(): number; + listeners(event: string|symbol): Function[]; + emit(event: string|symbol, ...args: any[]): boolean; + listenerCount(type: string|symbol): number; + // Added in Node 6... + prependListener(event: string|symbol, listener: Function): this; + prependOnceListener(event: string|symbol, listener: Function): this; + eventNames(): (string|symbol)[]; + } + + export interface ReadableStream extends EventEmitter { + readable: boolean; + read(size?: number): string | Buffer; + setEncoding(encoding: string): void; + pause(): ReadableStream; + resume(): ReadableStream; + pipe(destination: T, options?: { end?: boolean; }): T; + unpipe(destination?: T): void; + unshift(chunk: string): void; + unshift(chunk: Buffer): void; + wrap(oldStream: ReadableStream): ReadableStream; + } + + export interface WritableStream extends EventEmitter { + writable: boolean; + write(buffer: Buffer | string, cb?: Function): boolean; + write(str: string, encoding?: string, cb?: Function): boolean; + end(): void; + end(buffer: Buffer, cb?: Function): void; + end(str: string, cb?: Function): void; + end(str: string, encoding?: string, cb?: Function): void; + } + + export interface ReadWriteStream extends ReadableStream, WritableStream { + pause(): ReadWriteStream; + resume(): ReadWriteStream; + } + + export interface Events extends EventEmitter { } + + export interface Domain extends Events { + run(fn: Function): void; + add(emitter: Events): void; + remove(emitter: Events): void; + bind(cb: (err: Error, data: any) => any): any; + intercept(cb: (data: any) => any): any; + dispose(): void; + + addListener(event: string, listener: Function): this; + on(event: string, listener: Function): this; + once(event: string, listener: Function): this; + removeListener(event: string, listener: Function): this; + removeAllListeners(event?: string): this; + } + + export interface MemoryUsage { + rss: number; + heapTotal: number; + heapUsed: number; + } + + export interface ProcessVersions { + http_parser: string; + node: string; + v8: string; + ares: string; + uv: string; + zlib: string; + modules: string; + openssl: string; + } + + export interface Process extends EventEmitter { + stdout: WritableStream; + stderr: WritableStream; + stdin: ReadableStream; + argv: string[]; + execArgv: string[]; + execPath: string; + abort(): void; + chdir(directory: string): void; + cwd(): string; + env: any; + exit(code?: number): void; + exitCode: number; + getgid(): number; + setgid(id: number): void; + setgid(id: string): void; + getuid(): number; + setuid(id: number): void; + setuid(id: string): void; + version: string; + versions: ProcessVersions; + config: { + target_defaults: { + cflags: any[]; + default_configuration: string; + defines: string[]; + include_dirs: string[]; + libraries: string[]; + }; + variables: { + clang: number; + host_arch: string; + node_install_npm: boolean; + node_install_waf: boolean; + node_prefix: string; + node_shared_openssl: boolean; + node_shared_v8: boolean; + node_shared_zlib: boolean; + node_use_dtrace: boolean; + node_use_etw: boolean; + node_use_openssl: boolean; + target_arch: string; + v8_no_strict_aliasing: number; + v8_use_snapshot: boolean; + visibility: string; + }; + }; + kill(pid: number, signal?: string | number): void; + pid: number; + title: string; + arch: string; + platform: string; + memoryUsage(): MemoryUsage; + nextTick(callback: Function, ...args: any[]): void; + umask(mask?: number): number; + uptime(): number; + hrtime(time?: number[]): number[]; + domain: Domain; + + // Worker + send?(message: any, sendHandle?: any): void; + disconnect(): void; + connected: boolean; + } + + export interface Global { + Array: typeof Array; + ArrayBuffer: typeof ArrayBuffer; + Boolean: typeof Boolean; + Buffer: typeof Buffer; + DataView: typeof DataView; + Date: typeof Date; + Error: typeof Error; + EvalError: typeof EvalError; + Float32Array: typeof Float32Array; + Float64Array: typeof Float64Array; + Function: typeof Function; + GLOBAL: Global; + Infinity: typeof Infinity; + Int16Array: typeof Int16Array; + Int32Array: typeof Int32Array; + Int8Array: typeof Int8Array; + Intl: typeof Intl; + JSON: typeof JSON; + Map: MapConstructor; + Math: typeof Math; + NaN: typeof NaN; + Number: typeof Number; + Object: typeof Object; + Promise: Function; + RangeError: typeof RangeError; + ReferenceError: typeof ReferenceError; + RegExp: typeof RegExp; + Set: SetConstructor; + String: typeof String; + Symbol: Function; + SyntaxError: typeof SyntaxError; + TypeError: typeof TypeError; + URIError: typeof URIError; + Uint16Array: typeof Uint16Array; + Uint32Array: typeof Uint32Array; + Uint8Array: typeof Uint8Array; + Uint8ClampedArray: Function; + WeakMap: WeakMapConstructor; + WeakSet: WeakSetConstructor; + clearImmediate: (immediateId: any) => void; + clearInterval: (intervalId: NodeJS.Timer) => void; + clearTimeout: (timeoutId: NodeJS.Timer) => void; + console: typeof console; + decodeURI: typeof decodeURI; + decodeURIComponent: typeof decodeURIComponent; + encodeURI: typeof encodeURI; + encodeURIComponent: typeof encodeURIComponent; + escape: (str: string) => string; + eval: typeof eval; + global: Global; + isFinite: typeof isFinite; + isNaN: typeof isNaN; + parseFloat: typeof parseFloat; + parseInt: typeof parseInt; + process: Process; + root: Global; + setImmediate: (callback: (...args: any[]) => void, ...args: any[]) => any; + setInterval: (callback: (...args: any[]) => void, ms: number, ...args: any[]) => NodeJS.Timer; + setTimeout: (callback: (...args: any[]) => void, ms: number, ...args: any[]) => NodeJS.Timer; + undefined: typeof undefined; + unescape: (str: string) => string; + gc: () => void; + v8debug?: any; + } + + export interface Timer { + ref(): void; + unref(): void; + } +} + +interface IterableIterator { } + +/** + * @deprecated + */ +interface NodeBuffer extends Uint8Array { + write(string: string, offset?: number, length?: number, encoding?: string): number; + toString(encoding?: string, start?: number, end?: number): string; + toJSON(): {type: 'Buffer', data: any[]}; + equals(otherBuffer: Buffer): boolean; + compare(otherBuffer: Buffer, targetStart?: number, targetEnd?: number, sourceStart?: number, sourceEnd?: number): number; + copy(targetBuffer: Buffer, targetStart?: number, sourceStart?: number, sourceEnd?: number): number; + slice(start?: number, end?: number): Buffer; + writeUIntLE(value: number, offset: number, byteLength: number, noAssert?: boolean): number; + writeUIntBE(value: number, offset: number, byteLength: number, noAssert?: boolean): number; + writeIntLE(value: number, offset: number, byteLength: number, noAssert?: boolean): number; + writeIntBE(value: number, offset: number, byteLength: number, noAssert?: boolean): number; + readUIntLE(offset: number, byteLength: number, noAssert?: boolean): number; + readUIntBE(offset: number, byteLength: number, noAssert?: boolean): number; + readIntLE(offset: number, byteLength: number, noAssert?: boolean): number; + readIntBE(offset: number, byteLength: number, noAssert?: boolean): number; + readUInt8(offset: number, noAssert?: boolean): number; + readUInt16LE(offset: number, noAssert?: boolean): number; + readUInt16BE(offset: number, noAssert?: boolean): number; + readUInt32LE(offset: number, noAssert?: boolean): number; + readUInt32BE(offset: number, noAssert?: boolean): number; + readInt8(offset: number, noAssert?: boolean): number; + readInt16LE(offset: number, noAssert?: boolean): number; + readInt16BE(offset: number, noAssert?: boolean): number; + readInt32LE(offset: number, noAssert?: boolean): number; + readInt32BE(offset: number, noAssert?: boolean): number; + readFloatLE(offset: number, noAssert?: boolean): number; + readFloatBE(offset: number, noAssert?: boolean): number; + readDoubleLE(offset: number, noAssert?: boolean): number; + readDoubleBE(offset: number, noAssert?: boolean): number; + swap16(): Buffer; + swap32(): Buffer; + swap64(): Buffer; + writeUInt8(value: number, offset: number, noAssert?: boolean): number; + writeUInt16LE(value: number, offset: number, noAssert?: boolean): number; + writeUInt16BE(value: number, offset: number, noAssert?: boolean): number; + writeUInt32LE(value: number, offset: number, noAssert?: boolean): number; + writeUInt32BE(value: number, offset: number, noAssert?: boolean): number; + writeInt8(value: number, offset: number, noAssert?: boolean): number; + writeInt16LE(value: number, offset: number, noAssert?: boolean): number; + writeInt16BE(value: number, offset: number, noAssert?: boolean): number; + writeInt32LE(value: number, offset: number, noAssert?: boolean): number; + writeInt32BE(value: number, offset: number, noAssert?: boolean): number; + writeFloatLE(value: number, offset: number, noAssert?: boolean): number; + writeFloatBE(value: number, offset: number, noAssert?: boolean): number; + writeDoubleLE(value: number, offset: number, noAssert?: boolean): number; + writeDoubleBE(value: number, offset: number, noAssert?: boolean): number; + fill(value: any, offset?: number, end?: number): this; + indexOf(value: string | number | Buffer, byteOffset?: number, encoding?: string): number; + lastIndexOf(value: string | number | Buffer, byteOffset?: number, encoding?: string): number; + entries(): IterableIterator<[number, number]>; + includes(value: string | number | Buffer, byteOffset?: number, encoding?: string): boolean; + keys(): IterableIterator; + values(): IterableIterator; +} + +/************************************************ +* * +* MODULES * +* * +************************************************/ +declare module "buffer" { + export var INSPECT_MAX_BYTES: number; + var BuffType: typeof Buffer; + var SlowBuffType: typeof SlowBuffer; + export { BuffType as Buffer, SlowBuffType as SlowBuffer }; +} + +declare module "querystring" { + export interface StringifyOptions { + encodeURIComponent?: Function; + } + + export interface ParseOptions { + maxKeys?: number; + decodeURIComponent?: Function; + } + + export function stringify(obj: T, sep?: string, eq?: string, options?: StringifyOptions): string; + export function parse(str: string, sep?: string, eq?: string, options?: ParseOptions): any; + export function parse(str: string, sep?: string, eq?: string, options?: ParseOptions): T; + export function escape(str: string): string; + export function unescape(str: string): string; +} + +declare module "events" { + export class EventEmitter extends NodeJS.EventEmitter { + static EventEmitter: EventEmitter; + static listenerCount(emitter: EventEmitter, event: string|symbol): number; // deprecated + static defaultMaxListeners: number; + + addListener(event: string|symbol, listener: Function): this; + on(event: string|symbol, listener: Function): this; + once(event: string|symbol, listener: Function): this; + prependListener(event: string|symbol, listener: Function): this; + prependOnceListener(event: string|symbol, listener: Function): this; + removeListener(event: string|symbol, listener: Function): this; + removeAllListeners(event?: string|symbol): this; + setMaxListeners(n: number): this; + getMaxListeners(): number; + listeners(event: string|symbol): Function[]; + emit(event: string|symbol, ...args: any[]): boolean; + eventNames(): (string|symbol)[]; + listenerCount(type: string|symbol): number; + } +} + +declare module "http" { + import * as events from "events"; + import * as net from "net"; + import * as stream from "stream"; + + export interface RequestOptions { + protocol?: string; + host?: string; + hostname?: string; + family?: number; + port?: number; + localAddress?: string; + socketPath?: string; + method?: string; + path?: string; + headers?: { [key: string]: any }; + auth?: string; + agent?: Agent | boolean; + } + + export interface Server extends net.Server { + setTimeout(msecs: number, callback: Function): void; + maxHeadersCount: number; + timeout: number; + listening: boolean; + } + /** + * @deprecated Use IncomingMessage + */ + export interface ServerRequest extends IncomingMessage { + connection: net.Socket; + } + export interface ServerResponse extends stream.Writable { + // Extended base methods + write(buffer: Buffer): boolean; + write(buffer: Buffer, cb?: Function): boolean; + write(str: string, cb?: Function): boolean; + write(str: string, encoding?: string, cb?: Function): boolean; + write(str: string, encoding?: string, fd?: string): boolean; + + writeContinue(): void; + writeHead(statusCode: number, reasonPhrase?: string, headers?: any): void; + writeHead(statusCode: number, headers?: any): void; + statusCode: number; + statusMessage: string; + headersSent: boolean; + setHeader(name: string, value: string | string[]): void; + setTimeout(msecs: number, callback: Function): ServerResponse; + sendDate: boolean; + getHeader(name: string): string; + removeHeader(name: string): void; + write(chunk: any, encoding?: string): any; + addTrailers(headers: any): void; + finished: boolean; + + // Extended base methods + end(): void; + end(buffer: Buffer, cb?: Function): void; + end(str: string, cb?: Function): void; + end(str: string, encoding?: string, cb?: Function): void; + end(data?: any, encoding?: string): void; + } + export interface ClientRequest extends stream.Writable { + // Extended base methods + write(buffer: Buffer): boolean; + write(buffer: Buffer, cb?: Function): boolean; + write(str: string, cb?: Function): boolean; + write(str: string, encoding?: string, cb?: Function): boolean; + write(str: string, encoding?: string, fd?: string): boolean; + + write(chunk: any, encoding?: string): void; + abort(): void; + setTimeout(timeout: number, callback?: Function): void; + setNoDelay(noDelay?: boolean): void; + setSocketKeepAlive(enable?: boolean, initialDelay?: number): void; + + setHeader(name: string, value: string | string[]): void; + getHeader(name: string): string; + removeHeader(name: string): void; + addTrailers(headers: any): void; + + // Extended base methods + end(): void; + end(buffer: Buffer, cb?: Function): void; + end(str: string, cb?: Function): void; + end(str: string, encoding?: string, cb?: Function): void; + end(data?: any, encoding?: string): void; + } + export interface IncomingMessage extends stream.Readable { + httpVersion: string; + httpVersionMajor: string; + httpVersionMinor: string; + connection: net.Socket; + headers: any; + rawHeaders: string[]; + trailers: any; + rawTrailers: any; + setTimeout(msecs: number, callback: Function): NodeJS.Timer; + /** + * Only valid for request obtained from http.Server. + */ + method?: string; + /** + * Only valid for request obtained from http.Server. + */ + url?: string; + /** + * Only valid for response obtained from http.ClientRequest. + */ + statusCode?: number; + /** + * Only valid for response obtained from http.ClientRequest. + */ + statusMessage?: string; + socket: net.Socket; + destroy(error?: Error): void; + } + /** + * @deprecated Use IncomingMessage + */ + export interface ClientResponse extends IncomingMessage { } + + export interface AgentOptions { + /** + * Keep sockets around in a pool to be used by other requests in the future. Default = false + */ + keepAlive?: boolean; + /** + * When using HTTP KeepAlive, how often to send TCP KeepAlive packets over sockets being kept alive. Default = 1000. + * Only relevant if keepAlive is set to true. + */ + keepAliveMsecs?: number; + /** + * Maximum number of sockets to allow per host. Default for Node 0.10 is 5, default for Node 0.12 is Infinity + */ + maxSockets?: number; + /** + * Maximum number of sockets to leave open in a free state. Only relevant if keepAlive is set to true. Default = 256. + */ + maxFreeSockets?: number; + } + + export class Agent { + maxSockets: number; + sockets: any; + requests: any; + + constructor(opts?: AgentOptions); + + /** + * Destroy any sockets that are currently in use by the agent. + * It is usually not necessary to do this. However, if you are using an agent with KeepAlive enabled, + * then it is best to explicitly shut down the agent when you know that it will no longer be used. Otherwise, + * sockets may hang open for quite a long time before the server terminates them. + */ + destroy(): void; + } + + export var METHODS: string[]; + + export var STATUS_CODES: { + [errorCode: number]: string; + [errorCode: string]: string; + }; + export function createServer(requestListener?: (request: IncomingMessage, response: ServerResponse) => void): Server; + export function createClient(port?: number, host?: string): any; + export function request(options: RequestOptions, callback?: (res: IncomingMessage) => void): ClientRequest; + export function get(options: any, callback?: (res: IncomingMessage) => void): ClientRequest; + export var globalAgent: Agent; +} + +declare module "cluster" { + import * as child from "child_process"; + import * as events from "events"; + import * as net from "net"; + + // interfaces + export interface ClusterSettings { + execArgv?: string[]; // default: process.execArgv + exec?: string; + args?: string[]; + silent?: boolean; + stdio?: any[]; + uid?: number; + gid?: number; + } + + export interface ClusterSetupMasterSettings { + exec?: string; // default: process.argv[1] + args?: string[]; // default: process.argv.slice(2) + silent?: boolean; // default: false + stdio?: any[]; + } + + export interface Address { + address: string; + port: number; + addressType: number | "udp4" | "udp6"; // 4, 6, -1, "udp4", "udp6" + } + + export class Worker extends events.EventEmitter { + id: string; + process: child.ChildProcess; + suicide: boolean; + send(message: any, sendHandle?: any): boolean; + kill(signal?: string): void; + destroy(signal?: string): void; + disconnect(): void; + isConnected(): boolean; + isDead(): boolean; + exitedAfterDisconnect: boolean; + + /** + * events.EventEmitter + * 1. disconnect + * 2. error + * 3. exit + * 4. listening + * 5. message + * 6. online + */ + addListener(event: string, listener: Function): this; + addListener(event: "disconnect", listener: () => void): this; + addListener(event: "error", listener: (code: number, signal: string) => void): this; + addListener(event: "exit", listener: (code: number, signal: string) => void): this; + addListener(event: "listening", listener: (address: Address) => void): this; + addListener(event: "message", listener: (message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + addListener(event: "online", listener: () => void): this; + + on(event: string, listener: Function): this; + on(event: "disconnect", listener: () => void): this; + on(event: "error", listener: (code: number, signal: string) => void): this; + on(event: "exit", listener: (code: number, signal: string) => void): this; + on(event: "listening", listener: (address: Address) => void): this; + on(event: "message", listener: (message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + on(event: "online", listener: () => void): this; + + once(event: string, listener: Function): this; + once(event: "disconnect", listener: () => void): this; + once(event: "error", listener: (code: number, signal: string) => void): this; + once(event: "exit", listener: (code: number, signal: string) => void): this; + once(event: "listening", listener: (address: Address) => void): this; + once(event: "message", listener: (message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + once(event: "online", listener: () => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "disconnect", listener: () => void): this; + prependListener(event: "error", listener: (code: number, signal: string) => void): this; + prependListener(event: "exit", listener: (code: number, signal: string) => void): this; + prependListener(event: "listening", listener: (address: Address) => void): this; + prependListener(event: "message", listener: (message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + prependListener(event: "online", listener: () => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "disconnect", listener: () => void): this; + prependOnceListener(event: "error", listener: (code: number, signal: string) => void): this; + prependOnceListener(event: "exit", listener: (code: number, signal: string) => void): this; + prependOnceListener(event: "listening", listener: (address: Address) => void): this; + prependOnceListener(event: "message", listener: (message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + prependOnceListener(event: "online", listener: () => void): this; + } + + export interface Cluster extends events.EventEmitter { + Worker: Worker; + disconnect(callback?: Function): void; + fork(env?: any): Worker; + isMaster: boolean; + isWorker: boolean; + // TODO: cluster.schedulingPolicy + settings: ClusterSettings; + setupMaster(settings?: ClusterSetupMasterSettings): void; + worker: Worker; + workers: { + [index: string]: Worker + }; + + /** + * events.EventEmitter + * 1. disconnect + * 2. exit + * 3. fork + * 4. listening + * 5. message + * 6. online + * 7. setup + */ + addListener(event: string, listener: Function): this; + addListener(event: "disconnect", listener: (worker: Worker) => void): this; + addListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): this; + addListener(event: "fork", listener: (worker: Worker) => void): this; + addListener(event: "listening", listener: (worker: Worker, address: Address) => void): this; + addListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + addListener(event: "online", listener: (worker: Worker) => void): this; + addListener(event: "setup", listener: (settings: any) => void): this; + + on(event: string, listener: Function): this; + on(event: "disconnect", listener: (worker: Worker) => void): this; + on(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): this; + on(event: "fork", listener: (worker: Worker) => void): this; + on(event: "listening", listener: (worker: Worker, address: Address) => void): this; + on(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + on(event: "online", listener: (worker: Worker) => void): this; + on(event: "setup", listener: (settings: any) => void): this; + + once(event: string, listener: Function): this; + once(event: "disconnect", listener: (worker: Worker) => void): this; + once(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): this; + once(event: "fork", listener: (worker: Worker) => void): this; + once(event: "listening", listener: (worker: Worker, address: Address) => void): this; + once(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + once(event: "online", listener: (worker: Worker) => void): this; + once(event: "setup", listener: (settings: any) => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "disconnect", listener: (worker: Worker) => void): this; + prependListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): this; + prependListener(event: "fork", listener: (worker: Worker) => void): this; + prependListener(event: "listening", listener: (worker: Worker, address: Address) => void): this; + prependListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + prependListener(event: "online", listener: (worker: Worker) => void): this; + prependListener(event: "setup", listener: (settings: any) => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "disconnect", listener: (worker: Worker) => void): this; + prependOnceListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): this; + prependOnceListener(event: "fork", listener: (worker: Worker) => void): this; + prependOnceListener(event: "listening", listener: (worker: Worker, address: Address) => void): this; + prependOnceListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + prependOnceListener(event: "online", listener: (worker: Worker) => void): this; + prependOnceListener(event: "setup", listener: (settings: any) => void): this; + + } + + export function disconnect(callback ?: Function): void; + export function fork(env?: any): Worker; + export var isMaster: boolean; + export var isWorker: boolean; + // TODO: cluster.schedulingPolicy + export var settings: ClusterSettings; + export function setupMaster(settings?: ClusterSetupMasterSettings): void; + export var worker: Worker; + export var workers: { + [index: string]: Worker + }; + + /** + * events.EventEmitter + * 1. disconnect + * 2. exit + * 3. fork + * 4. listening + * 5. message + * 6. online + * 7. setup + */ + export function addListener(event: string, listener: Function): Cluster; + export function addListener(event: "disconnect", listener: (worker: Worker) => void): Cluster; + export function addListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): Cluster; + export function addListener(event: "fork", listener: (worker: Worker) => void): Cluster; + export function addListener(event: "listening", listener: (worker: Worker, address: Address) => void): Cluster; + export function addListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): Cluster; // the handle is a net.Socket or net.Server object, or undefined. + export function addListener(event: "online", listener: (worker: Worker) => void): Cluster; + export function addListener(event: "setup", listener: (settings: any) => void): Cluster; + + export function on(event: string, listener: Function): Cluster; + export function on(event: "disconnect", listener: (worker: Worker) => void): Cluster; + export function on(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): Cluster; + export function on(event: "fork", listener: (worker: Worker) => void): Cluster; + export function on(event: "listening", listener: (worker: Worker, address: Address) => void): Cluster; + export function on(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): Cluster; // the handle is a net.Socket or net.Server object, or undefined. + export function on(event: "online", listener: (worker: Worker) => void): Cluster; + export function on(event: "setup", listener: (settings: any) => void): Cluster; + + export function once(event: string, listener: Function): Cluster; + export function once(event: "disconnect", listener: (worker: Worker) => void): Cluster; + export function once(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): Cluster; + export function once(event: "fork", listener: (worker: Worker) => void): Cluster; + export function once(event: "listening", listener: (worker: Worker, address: Address) => void): Cluster; + export function once(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): Cluster; // the handle is a net.Socket or net.Server object, or undefined. + export function once(event: "online", listener: (worker: Worker) => void): Cluster; + export function once(event: "setup", listener: (settings: any) => void): Cluster; + + export function removeListener(event: string, listener: Function): Cluster; + export function removeAllListeners(event?: string): Cluster; + export function setMaxListeners(n: number): Cluster; + export function getMaxListeners(): number; + export function listeners(event: string): Function[]; + export function emit(event: string, ...args: any[]): boolean; + export function listenerCount(type: string): number; + + export function prependListener(event: string, listener: Function): Cluster; + export function prependListener(event: "disconnect", listener: (worker: Worker) => void): Cluster; + export function prependListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): Cluster; + export function prependListener(event: "fork", listener: (worker: Worker) => void): Cluster; + export function prependListener(event: "listening", listener: (worker: Worker, address: Address) => void): Cluster; + export function prependListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): Cluster; // the handle is a net.Socket or net.Server object, or undefined. + export function prependListener(event: "online", listener: (worker: Worker) => void): Cluster; + export function prependListener(event: "setup", listener: (settings: any) => void): Cluster; + + export function prependOnceListener(event: string, listener: Function): Cluster; + export function prependOnceListener(event: "disconnect", listener: (worker: Worker) => void): Cluster; + export function prependOnceListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): Cluster; + export function prependOnceListener(event: "fork", listener: (worker: Worker) => void): Cluster; + export function prependOnceListener(event: "listening", listener: (worker: Worker, address: Address) => void): Cluster; + export function prependOnceListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): Cluster; // the handle is a net.Socket or net.Server object, or undefined. + export function prependOnceListener(event: "online", listener: (worker: Worker) => void): Cluster; + export function prependOnceListener(event: "setup", listener: (settings: any) => void): Cluster; + + export function eventNames(): string[]; +} + +declare module "zlib" { + import * as stream from "stream"; + export interface ZlibOptions { chunkSize?: number; windowBits?: number; level?: number; memLevel?: number; strategy?: number; dictionary?: any; } + + export interface Gzip extends stream.Transform { } + export interface Gunzip extends stream.Transform { } + export interface Deflate extends stream.Transform { } + export interface Inflate extends stream.Transform { } + export interface DeflateRaw extends stream.Transform { } + export interface InflateRaw extends stream.Transform { } + export interface Unzip extends stream.Transform { } + + export function createGzip(options?: ZlibOptions): Gzip; + export function createGunzip(options?: ZlibOptions): Gunzip; + export function createDeflate(options?: ZlibOptions): Deflate; + export function createInflate(options?: ZlibOptions): Inflate; + export function createDeflateRaw(options?: ZlibOptions): DeflateRaw; + export function createInflateRaw(options?: ZlibOptions): InflateRaw; + export function createUnzip(options?: ZlibOptions): Unzip; + + export function deflate(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function deflateSync(buf: Buffer, options?: ZlibOptions): any; + export function deflateRaw(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function deflateRawSync(buf: Buffer, options?: ZlibOptions): any; + export function gzip(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function gzipSync(buf: Buffer, options?: ZlibOptions): any; + export function gunzip(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function gunzipSync(buf: Buffer, options?: ZlibOptions): any; + export function inflate(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function inflateSync(buf: Buffer, options?: ZlibOptions): any; + export function inflateRaw(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function inflateRawSync(buf: Buffer, options?: ZlibOptions): any; + export function unzip(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function unzipSync(buf: Buffer, options?: ZlibOptions): any; + + // Constants + export var Z_NO_FLUSH: number; + export var Z_PARTIAL_FLUSH: number; + export var Z_SYNC_FLUSH: number; + export var Z_FULL_FLUSH: number; + export var Z_FINISH: number; + export var Z_BLOCK: number; + export var Z_TREES: number; + export var Z_OK: number; + export var Z_STREAM_END: number; + export var Z_NEED_DICT: number; + export var Z_ERRNO: number; + export var Z_STREAM_ERROR: number; + export var Z_DATA_ERROR: number; + export var Z_MEM_ERROR: number; + export var Z_BUF_ERROR: number; + export var Z_VERSION_ERROR: number; + export var Z_NO_COMPRESSION: number; + export var Z_BEST_SPEED: number; + export var Z_BEST_COMPRESSION: number; + export var Z_DEFAULT_COMPRESSION: number; + export var Z_FILTERED: number; + export var Z_HUFFMAN_ONLY: number; + export var Z_RLE: number; + export var Z_FIXED: number; + export var Z_DEFAULT_STRATEGY: number; + export var Z_BINARY: number; + export var Z_TEXT: number; + export var Z_ASCII: number; + export var Z_UNKNOWN: number; + export var Z_DEFLATED: number; + export var Z_NULL: number; +} + +declare module "os" { + export interface CpuInfo { + model: string; + speed: number; + times: { + user: number; + nice: number; + sys: number; + idle: number; + irq: number; + }; + } + + export interface NetworkInterfaceInfo { + address: string; + netmask: string; + family: string; + mac: string; + internal: boolean; + } + + export function hostname(): string; + export function loadavg(): number[]; + export function uptime(): number; + export function freemem(): number; + export function totalmem(): number; + export function cpus(): CpuInfo[]; + export function type(): string; + export function release(): string; + export function networkInterfaces(): { [index: string]: NetworkInterfaceInfo[] }; + export function homedir(): string; + export function userInfo(options?: { encoding: string }): { username: string, uid: number, gid: number, shell: any, homedir: string } + export var constants: { + UV_UDP_REUSEADDR: number, + errno: { + SIGHUP: number; + SIGINT: number; + SIGQUIT: number; + SIGILL: number; + SIGTRAP: number; + SIGABRT: number; + SIGIOT: number; + SIGBUS: number; + SIGFPE: number; + SIGKILL: number; + SIGUSR1: number; + SIGSEGV: number; + SIGUSR2: number; + SIGPIPE: number; + SIGALRM: number; + SIGTERM: number; + SIGCHLD: number; + SIGSTKFLT: number; + SIGCONT: number; + SIGSTOP: number; + SIGTSTP: number; + SIGTTIN: number; + SIGTTOU: number; + SIGURG: number; + SIGXCPU: number; + SIGXFSZ: number; + SIGVTALRM: number; + SIGPROF: number; + SIGWINCH: number; + SIGIO: number; + SIGPOLL: number; + SIGPWR: number; + SIGSYS: number; + SIGUNUSED: number; + }, + signals: { + E2BIG: number; + EACCES: number; + EADDRINUSE: number; + EADDRNOTAVAIL: number; + EAFNOSUPPORT: number; + EAGAIN: number; + EALREADY: number; + EBADF: number; + EBADMSG: number; + EBUSY: number; + ECANCELED: number; + ECHILD: number; + ECONNABORTED: number; + ECONNREFUSED: number; + ECONNRESET: number; + EDEADLK: number; + EDESTADDRREQ: number; + EDOM: number; + EDQUOT: number; + EEXIST: number; + EFAULT: number; + EFBIG: number; + EHOSTUNREACH: number; + EIDRM: number; + EILSEQ: number; + EINPROGRESS: number; + EINTR: number; + EINVAL: number; + EIO: number; + EISCONN: number; + EISDIR: number; + ELOOP: number; + EMFILE: number; + EMLINK: number; + EMSGSIZE: number; + EMULTIHOP: number; + ENAMETOOLONG: number; + ENETDOWN: number; + ENETRESET: number; + ENETUNREACH: number; + ENFILE: number; + ENOBUFS: number; + ENODATA: number; + ENODEV: number; + ENOENT: number; + ENOEXEC: number; + ENOLCK: number; + ENOLINK: number; + ENOMEM: number; + ENOMSG: number; + ENOPROTOOPT: number; + ENOSPC: number; + ENOSR: number; + ENOSTR: number; + ENOSYS: number; + ENOTCONN: number; + ENOTDIR: number; + ENOTEMPTY: number; + ENOTSOCK: number; + ENOTSUP: number; + ENOTTY: number; + ENXIO: number; + EOPNOTSUPP: number; + EOVERFLOW: number; + EPERM: number; + EPIPE: number; + EPROTO: number; + EPROTONOSUPPORT: number; + EPROTOTYPE: number; + ERANGE: number; + EROFS: number; + ESPIPE: number; + ESRCH: number; + ESTALE: number; + ETIME: number; + ETIMEDOUT: number; + ETXTBSY: number; + EWOULDBLOCK: number; + EXDEV: number; + }, + }; + export function arch(): string; + export function platform(): string; + export function tmpdir(): string; + export var EOL: string; + export function endianness(): "BE" | "LE"; +} + +declare module "https" { + import * as tls from "tls"; + import * as events from "events"; + import * as http from "http"; + + export interface ServerOptions { + pfx?: any; + key?: any; + passphrase?: string; + cert?: any; + ca?: any; + crl?: any; + ciphers?: string; + honorCipherOrder?: boolean; + requestCert?: boolean; + rejectUnauthorized?: boolean; + NPNProtocols?: any; + SNICallback?: (servername: string, cb: (err: Error, ctx: tls.SecureContext) => any) => any; + } + + export interface RequestOptions extends http.RequestOptions { + pfx?: any; + key?: any; + passphrase?: string; + cert?: any; + ca?: any; + ciphers?: string; + rejectUnauthorized?: boolean; + secureProtocol?: string; + } + + export interface Agent extends http.Agent { } + + export interface AgentOptions extends http.AgentOptions { + pfx?: any; + key?: any; + passphrase?: string; + cert?: any; + ca?: any; + ciphers?: string; + rejectUnauthorized?: boolean; + secureProtocol?: string; + maxCachedSessions?: number; + } + + export var Agent: { + new (options?: AgentOptions): Agent; + }; + export interface Server extends tls.Server { } + export function createServer(options: ServerOptions, requestListener?: Function): Server; + export function request(options: RequestOptions, callback?: (res: http.IncomingMessage) => void): http.ClientRequest; + export function get(options: RequestOptions, callback?: (res: http.IncomingMessage) => void): http.ClientRequest; + export var globalAgent: Agent; +} + +declare module "punycode" { + export function decode(string: string): string; + export function encode(string: string): string; + export function toUnicode(domain: string): string; + export function toASCII(domain: string): string; + export var ucs2: ucs2; + interface ucs2 { + decode(string: string): number[]; + encode(codePoints: number[]): string; + } + export var version: any; +} + +declare module "repl" { + import * as stream from "stream"; + import * as readline from "readline"; + + export interface ReplOptions { + prompt?: string; + input?: NodeJS.ReadableStream; + output?: NodeJS.WritableStream; + terminal?: boolean; + eval?: Function; + useColors?: boolean; + useGlobal?: boolean; + ignoreUndefined?: boolean; + writer?: Function; + completer?: Function; + replMode?: any; + breakEvalOnSigint?: any; + } + + export interface REPLServer extends readline.ReadLine { + defineCommand(keyword: string, cmd: Function | { help: string, action: Function }): void; + displayPrompt(preserveCursor?: boolean): void + } + + export function start(options: ReplOptions): REPLServer; +} + +declare module "readline" { + import * as events from "events"; + import * as stream from "stream"; + + export interface Key { + sequence?: string; + name?: string; + ctrl?: boolean; + meta?: boolean; + shift?: boolean; + } + + export interface ReadLine extends events.EventEmitter { + setPrompt(prompt: string): void; + prompt(preserveCursor?: boolean): void; + question(query: string, callback: (answer: string) => void): void; + pause(): ReadLine; + resume(): ReadLine; + close(): void; + write(data: string | Buffer, key?: Key): void; + } + + export interface Completer { + (line: string): CompleterResult; + (line: string, callback: (err: any, result: CompleterResult) => void): any; + } + + export interface CompleterResult { + completions: string[]; + line: string; + } + + export interface ReadLineOptions { + input: NodeJS.ReadableStream; + output?: NodeJS.WritableStream; + completer?: Completer; + terminal?: boolean; + historySize?: number; + } + + export function createInterface(input: NodeJS.ReadableStream, output?: NodeJS.WritableStream, completer?: Completer, terminal?: boolean): ReadLine; + export function createInterface(options: ReadLineOptions): ReadLine; + + export function cursorTo(stream: NodeJS.WritableStream, x: number, y: number): void; + export function moveCursor(stream: NodeJS.WritableStream, dx: number | string, dy: number | string): void; + export function clearLine(stream: NodeJS.WritableStream, dir: number): void; + export function clearScreenDown(stream: NodeJS.WritableStream): void; +} + +declare module "vm" { + export interface Context { } + export interface ScriptOptions { + filename?: string; + lineOffset?: number; + columnOffset?: number; + displayErrors?: boolean; + timeout?: number; + cachedData?: Buffer; + produceCachedData?: boolean; + } + export interface RunningScriptOptions { + filename?: string; + lineOffset?: number; + columnOffset?: number; + displayErrors?: boolean; + timeout?: number; + } + export class Script { + constructor(code: string, options?: ScriptOptions); + runInContext(contextifiedSandbox: Context, options?: RunningScriptOptions): any; + runInNewContext(sandbox?: Context, options?: RunningScriptOptions): any; + runInThisContext(options?: RunningScriptOptions): any; + } + export function createContext(sandbox?: Context): Context; + export function isContext(sandbox: Context): boolean; + export function runInContext(code: string, contextifiedSandbox: Context, options?: RunningScriptOptions): any; + export function runInDebugContext(code: string): any; + export function runInNewContext(code: string, sandbox?: Context, options?: RunningScriptOptions): any; + export function runInThisContext(code: string, options?: RunningScriptOptions): any; +} + +declare module "child_process" { + import * as events from "events"; + import * as stream from "stream"; + + export interface ChildProcess extends events.EventEmitter { + stdin: stream.Writable; + stdout: stream.Readable; + stderr: stream.Readable; + stdio: [stream.Writable, stream.Readable, stream.Readable]; + pid: number; + kill(signal?: string): void; + send(message: any, sendHandle?: any): boolean; + connected: boolean; + disconnect(): void; + unref(): void; + ref(): void; + } + + export interface SpawnOptions { + cwd?: string; + env?: any; + stdio?: any; + detached?: boolean; + uid?: number; + gid?: number; + shell?: boolean | string; + } + export function spawn(command: string, args?: string[], options?: SpawnOptions): ChildProcess; + + export interface ExecOptions { + cwd?: string; + env?: any; + shell?: string; + timeout?: number; + maxBuffer?: number; + killSignal?: string; + uid?: number; + gid?: number; + } + export interface ExecOptionsWithStringEncoding extends ExecOptions { + encoding: BufferEncoding; + } + export interface ExecOptionsWithBufferEncoding extends ExecOptions { + encoding: string; // specify `null`. + } + export function exec(command: string, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + export function exec(command: string, options: ExecOptionsWithStringEncoding, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + // usage. child_process.exec("tsc", {encoding: null as string}, (err, stdout, stderr) => {}); + export function exec(command: string, options: ExecOptionsWithBufferEncoding, callback?: (error: Error, stdout: Buffer, stderr: Buffer) => void): ChildProcess; + export function exec(command: string, options: ExecOptions, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + + export interface ExecFileOptions { + cwd?: string; + env?: any; + timeout?: number; + maxBuffer?: number; + killSignal?: string; + uid?: number; + gid?: number; + } + export interface ExecFileOptionsWithStringEncoding extends ExecFileOptions { + encoding: BufferEncoding; + } + export interface ExecFileOptionsWithBufferEncoding extends ExecFileOptions { + encoding: string; // specify `null`. + } + export function execFile(file: string, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + export function execFile(file: string, options?: ExecFileOptionsWithStringEncoding, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + // usage. child_process.execFile("file.sh", {encoding: null as string}, (err, stdout, stderr) => {}); + export function execFile(file: string, options?: ExecFileOptionsWithBufferEncoding, callback?: (error: Error, stdout: Buffer, stderr: Buffer) => void): ChildProcess; + export function execFile(file: string, options?: ExecFileOptions, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + export function execFile(file: string, args?: string[], callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + export function execFile(file: string, args?: string[], options?: ExecFileOptionsWithStringEncoding, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + // usage. child_process.execFile("file.sh", ["foo"], {encoding: null as string}, (err, stdout, stderr) => {}); + export function execFile(file: string, args?: string[], options?: ExecFileOptionsWithBufferEncoding, callback?: (error: Error, stdout: Buffer, stderr: Buffer) => void): ChildProcess; + export function execFile(file: string, args?: string[], options?: ExecFileOptions, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + + export interface ForkOptions { + cwd?: string; + env?: any; + execPath?: string; + execArgv?: string[]; + silent?: boolean; + uid?: number; + gid?: number; + } + export function fork(modulePath: string, args?: string[], options?: ForkOptions): ChildProcess; + + export interface SpawnSyncOptions { + cwd?: string; + input?: string | Buffer; + stdio?: any; + env?: any; + uid?: number; + gid?: number; + timeout?: number; + killSignal?: string; + maxBuffer?: number; + encoding?: string; + shell?: boolean | string; + } + export interface SpawnSyncOptionsWithStringEncoding extends SpawnSyncOptions { + encoding: BufferEncoding; + } + export interface SpawnSyncOptionsWithBufferEncoding extends SpawnSyncOptions { + encoding: string; // specify `null`. + } + export interface SpawnSyncReturns { + pid: number; + output: string[]; + stdout: T; + stderr: T; + status: number; + signal: string; + error: Error; + } + export function spawnSync(command: string): SpawnSyncReturns; + export function spawnSync(command: string, options?: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns; + export function spawnSync(command: string, options?: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns; + export function spawnSync(command: string, options?: SpawnSyncOptions): SpawnSyncReturns; + export function spawnSync(command: string, args?: string[], options?: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns; + export function spawnSync(command: string, args?: string[], options?: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns; + export function spawnSync(command: string, args?: string[], options?: SpawnSyncOptions): SpawnSyncReturns; + + export interface ExecSyncOptions { + cwd?: string; + input?: string | Buffer; + stdio?: any; + env?: any; + shell?: string; + uid?: number; + gid?: number; + timeout?: number; + killSignal?: string; + maxBuffer?: number; + encoding?: string; + } + export interface ExecSyncOptionsWithStringEncoding extends ExecSyncOptions { + encoding: BufferEncoding; + } + export interface ExecSyncOptionsWithBufferEncoding extends ExecSyncOptions { + encoding: string; // specify `null`. + } + export function execSync(command: string): Buffer; + export function execSync(command: string, options?: ExecSyncOptionsWithStringEncoding): string; + export function execSync(command: string, options?: ExecSyncOptionsWithBufferEncoding): Buffer; + export function execSync(command: string, options?: ExecSyncOptions): Buffer; + + export interface ExecFileSyncOptions { + cwd?: string; + input?: string | Buffer; + stdio?: any; + env?: any; + uid?: number; + gid?: number; + timeout?: number; + killSignal?: string; + maxBuffer?: number; + encoding?: string; + } + export interface ExecFileSyncOptionsWithStringEncoding extends ExecFileSyncOptions { + encoding: BufferEncoding; + } + export interface ExecFileSyncOptionsWithBufferEncoding extends ExecFileSyncOptions { + encoding: string; // specify `null`. + } + export function execFileSync(command: string): Buffer; + export function execFileSync(command: string, options?: ExecFileSyncOptionsWithStringEncoding): string; + export function execFileSync(command: string, options?: ExecFileSyncOptionsWithBufferEncoding): Buffer; + export function execFileSync(command: string, options?: ExecFileSyncOptions): Buffer; + export function execFileSync(command: string, args?: string[], options?: ExecFileSyncOptionsWithStringEncoding): string; + export function execFileSync(command: string, args?: string[], options?: ExecFileSyncOptionsWithBufferEncoding): Buffer; + export function execFileSync(command: string, args?: string[], options?: ExecFileSyncOptions): Buffer; +} + +declare module "url" { + export interface Url { + href?: string; + protocol?: string; + auth?: string; + hostname?: string; + port?: string; + host?: string; + pathname?: string; + search?: string; + query?: string | any; + slashes?: boolean; + hash?: string; + path?: string; + } + + export function parse(urlStr: string, parseQueryString?: boolean, slashesDenoteHost?: boolean): Url; + export function format(url: Url): string; + export function resolve(from: string, to: string): string; +} + +declare module "dns" { + export interface MxRecord { + exchange: string, + priority: number + } + + export function lookup(domain: string, family: number, callback: (err: Error, address: string, family: number) => void): string; + export function lookup(domain: string, callback: (err: Error, address: string, family: number) => void): string; + export function resolve(domain: string, rrtype: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolve(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolve4(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolve6(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolveMx(domain: string, callback: (err: Error, addresses: MxRecord[]) =>void ): string[]; + export function resolveTxt(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolveSrv(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolveNs(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolveCname(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function reverse(ip: string, callback: (err: Error, domains: string[]) => void): string[]; + export function setServers(servers: string[]): void; + + //Error codes + export var NODATA: string; + export var FORMERR: string; + export var SERVFAIL: string; + export var NOTFOUND: string; + export var NOTIMP: string; + export var REFUSED: string; + export var BADQUERY: string; + export var BADNAME: string; + export var BADFAMILY: string; + export var BADRESP: string; + export var CONNREFUSED: string; + export var TIMEOUT: string; + export var EOF: string; + export var FILE: string; + export var NOMEM: string; + export var DESTRUCTION: string; + export var BADSTR: string; + export var BADFLAGS: string; + export var NONAME: string; + export var BADHINTS: string; + export var NOTINITIALIZED: string; + export var LOADIPHLPAPI: string; + export var ADDRGETNETWORKPARAMS: string; + export var CANCELLED: string; +} + +declare module "net" { + import * as stream from "stream"; + + export interface Socket extends stream.Duplex { + // Extended base methods + write(buffer: Buffer): boolean; + write(buffer: Buffer, cb?: Function): boolean; + write(str: string, cb?: Function): boolean; + write(str: string, encoding?: string, cb?: Function): boolean; + write(str: string, encoding?: string, fd?: string): boolean; + + connect(port: number, host?: string, connectionListener?: Function): void; + connect(path: string, connectionListener?: Function): void; + bufferSize: number; + setEncoding(encoding?: string): void; + write(data: any, encoding?: string, callback?: Function): void; + destroy(): void; + pause(): Socket; + resume(): Socket; + setTimeout(timeout: number, callback?: Function): void; + setNoDelay(noDelay?: boolean): void; + setKeepAlive(enable?: boolean, initialDelay?: number): void; + address(): { port: number; family: string; address: string; }; + unref(): void; + ref(): void; + + remoteAddress: string; + remoteFamily: string; + remotePort: number; + localAddress: string; + localPort: number; + bytesRead: number; + bytesWritten: number; + + // Extended base methods + end(): void; + end(buffer: Buffer, cb?: Function): void; + end(str: string, cb?: Function): void; + end(str: string, encoding?: string, cb?: Function): void; + end(data?: any, encoding?: string): void; + } + + export var Socket: { + new (options?: { fd?: string; type?: string; allowHalfOpen?: boolean; }): Socket; + }; + + export interface ListenOptions { + port?: number; + host?: string; + backlog?: number; + path?: string; + exclusive?: boolean; + } + + export interface Server extends Socket { + listen(port: number, hostname?: string, backlog?: number, listeningListener?: Function): Server; + listen(port: number, hostname?: string, listeningListener?: Function): Server; + listen(port: number, backlog?: number, listeningListener?: Function): Server; + listen(port: number, listeningListener?: Function): Server; + listen(path: string, backlog?: number, listeningListener?: Function): Server; + listen(path: string, listeningListener?: Function): Server; + listen(handle: any, backlog?: number, listeningListener?: Function): Server; + listen(handle: any, listeningListener?: Function): Server; + listen(options: ListenOptions, listeningListener?: Function): Server; + close(callback?: Function): Server; + address(): { port: number; family: string; address: string; }; + getConnections(cb: (error: Error, count: number) => void): void; + ref(): Server; + unref(): Server; + maxConnections: number; + connections: number; + } + export function createServer(connectionListener?: (socket: Socket) => void): Server; + export function createServer(options?: { allowHalfOpen?: boolean; }, connectionListener?: (socket: Socket) => void): Server; + export function connect(options: { port: number, host?: string, localAddress?: string, localPort?: string, family?: number, allowHalfOpen?: boolean; }, connectionListener?: Function): Socket; + export function connect(port: number, host?: string, connectionListener?: Function): Socket; + export function connect(path: string, connectionListener?: Function): Socket; + export function createConnection(options: { port: number, host?: string, localAddress?: string, localPort?: string, family?: number, allowHalfOpen?: boolean; }, connectionListener?: Function): Socket; + export function createConnection(port: number, host?: string, connectionListener?: Function): Socket; + export function createConnection(path: string, connectionListener?: Function): Socket; + export function isIP(input: string): number; + export function isIPv4(input: string): boolean; + export function isIPv6(input: string): boolean; +} + +declare module "dgram" { + import * as events from "events"; + + interface RemoteInfo { + address: string; + port: number; + size: number; + } + + interface AddressInfo { + address: string; + family: string; + port: number; + } + + interface BindOptions { + port: number; + address?: string; + exclusive?: boolean; + } + + interface SocketOptions { + type: "udp4" | "udp6"; + reuseAddr?: boolean; + } + + export function createSocket(type: string, callback?: (msg: Buffer, rinfo: RemoteInfo) => void): Socket; + export function createSocket(options: SocketOptions, callback?: (msg: Buffer, rinfo: RemoteInfo) => void): Socket; + + export interface Socket extends events.EventEmitter { + send(msg: Buffer | String | any[], port: number, address: string, callback?: (error: Error, bytes: number) => void): void; + send(msg: Buffer | String | any[], offset: number, length: number, port: number, address: string, callback?: (error: Error, bytes: number) => void): void; + bind(port?: number, address?: string, callback?: () => void): void; + bind(options: BindOptions, callback?: Function): void; + close(callback?: any): void; + address(): AddressInfo; + setBroadcast(flag: boolean): void; + setTTL(ttl: number): void; + setMulticastTTL(ttl: number): void; + setMulticastLoopback(flag: boolean): void; + addMembership(multicastAddress: string, multicastInterface?: string): void; + dropMembership(multicastAddress: string, multicastInterface?: string): void; + ref(): void; + unref(): void; + } +} + +declare module "fs" { + import * as stream from "stream"; + import * as events from "events"; + + interface Stats { + isFile(): boolean; + isDirectory(): boolean; + isBlockDevice(): boolean; + isCharacterDevice(): boolean; + isSymbolicLink(): boolean; + isFIFO(): boolean; + isSocket(): boolean; + dev: number; + ino: number; + mode: number; + nlink: number; + uid: number; + gid: number; + rdev: number; + size: number; + blksize: number; + blocks: number; + atime: Date; + mtime: Date; + ctime: Date; + birthtime: Date; + } + + interface FSWatcher extends events.EventEmitter { + close(): void; + + /** + * events.EventEmitter + * 1. change + * 2. error + */ + addListener(event: string, listener: Function): this; + addListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this; + addListener(event: "error", listener: (code: number, signal: string) => void): this; + + on(event: string, listener: Function): this; + on(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this; + on(event: "error", listener: (code: number, signal: string) => void): this; + + once(event: string, listener: Function): this; + once(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this; + once(event: "error", listener: (code: number, signal: string) => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this; + prependListener(event: "error", listener: (code: number, signal: string) => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this; + prependOnceListener(event: "error", listener: (code: number, signal: string) => void): this; + } + + export interface ReadStream extends stream.Readable { + close(): void; + destroy(): void; + + /** + * events.EventEmitter + * 1. open + * 2. close + */ + addListener(event: string, listener: Function): this; + addListener(event: "open", listener: (fd: number) => void): this; + addListener(event: "close", listener: () => void): this; + + on(event: string, listener: Function): this; + on(event: "open", listener: (fd: number) => void): this; + on(event: "close", listener: () => void): this; + + once(event: string, listener: Function): this; + once(event: "open", listener: (fd: number) => void): this; + once(event: "close", listener: () => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "open", listener: (fd: number) => void): this; + prependListener(event: "close", listener: () => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "open", listener: (fd: number) => void): this; + prependOnceListener(event: "close", listener: () => void): this; + } + + export interface WriteStream extends stream.Writable { + close(): void; + bytesWritten: number; + path: string | Buffer; + + /** + * events.EventEmitter + * 1. open + * 2. close + */ + addListener(event: string, listener: Function): this; + addListener(event: "open", listener: (fd: number) => void): this; + addListener(event: "close", listener: () => void): this; + + on(event: string, listener: Function): this; + on(event: "open", listener: (fd: number) => void): this; + on(event: "close", listener: () => void): this; + + once(event: string, listener: Function): this; + once(event: "open", listener: (fd: number) => void): this; + once(event: "close", listener: () => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "open", listener: (fd: number) => void): this; + prependListener(event: "close", listener: () => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "open", listener: (fd: number) => void): this; + prependOnceListener(event: "close", listener: () => void): this; + } + + /** + * Asynchronous rename. + * @param oldPath + * @param newPath + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function rename(oldPath: string, newPath: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + /** + * Synchronous rename + * @param oldPath + * @param newPath + */ + export function renameSync(oldPath: string, newPath: string): void; + export function truncate(path: string | Buffer, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function truncate(path: string | Buffer, len: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function truncateSync(path: string | Buffer, len?: number): void; + export function ftruncate(fd: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function ftruncate(fd: number, len: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function ftruncateSync(fd: number, len?: number): void; + export function chown(path: string | Buffer, uid: number, gid: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function chownSync(path: string | Buffer, uid: number, gid: number): void; + export function fchown(fd: number, uid: number, gid: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function fchownSync(fd: number, uid: number, gid: number): void; + export function lchown(path: string | Buffer, uid: number, gid: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function lchownSync(path: string | Buffer, uid: number, gid: number): void; + export function chmod(path: string | Buffer, mode: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function chmod(path: string | Buffer, mode: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function chmodSync(path: string | Buffer, mode: number): void; + export function chmodSync(path: string | Buffer, mode: string): void; + export function fchmod(fd: number, mode: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function fchmod(fd: number, mode: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function fchmodSync(fd: number, mode: number): void; + export function fchmodSync(fd: number, mode: string): void; + export function lchmod(path: string | Buffer, mode: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function lchmod(path: string | Buffer, mode: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function lchmodSync(path: string | Buffer, mode: number): void; + export function lchmodSync(path: string | Buffer, mode: string): void; + export function stat(path: string | Buffer, callback?: (err: NodeJS.ErrnoException, stats: Stats) => any): void; + export function lstat(path: string | Buffer, callback?: (err: NodeJS.ErrnoException, stats: Stats) => any): void; + export function fstat(fd: number, callback?: (err: NodeJS.ErrnoException, stats: Stats) => any): void; + export function statSync(path: string | Buffer): Stats; + export function lstatSync(path: string | Buffer): Stats; + export function fstatSync(fd: number): Stats; + export function link(srcpath: string | Buffer, dstpath: string | Buffer, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function linkSync(srcpath: string | Buffer, dstpath: string | Buffer): void; + export function symlink(srcpath: string | Buffer, dstpath: string | Buffer, type?: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function symlinkSync(srcpath: string | Buffer, dstpath: string | Buffer, type?: string): void; + export function readlink(path: string | Buffer, callback?: (err: NodeJS.ErrnoException, linkString: string) => any): void; + export function readlinkSync(path: string | Buffer): string; + export function realpath(path: string | Buffer, callback?: (err: NodeJS.ErrnoException, resolvedPath: string) => any): void; + export function realpath(path: string | Buffer, cache: { [path: string]: string }, callback: (err: NodeJS.ErrnoException, resolvedPath: string) => any): void; + export function realpathSync(path: string | Buffer, cache?: { [path: string]: string }): string; + /* + * Asynchronous unlink - deletes the file specified in {path} + * + * @param path + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function unlink(path: string | Buffer, callback?: (err?: NodeJS.ErrnoException) => void): void; + /* + * Synchronous unlink - deletes the file specified in {path} + * + * @param path + */ + export function unlinkSync(path: string | Buffer): void; + /* + * Asynchronous rmdir - removes the directory specified in {path} + * + * @param path + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function rmdir(path: string | Buffer, callback?: (err?: NodeJS.ErrnoException) => void): void; + /* + * Synchronous rmdir - removes the directory specified in {path} + * + * @param path + */ + export function rmdirSync(path: string | Buffer): void; + /* + * Asynchronous mkdir - creates the directory specified in {path}. Parameter {mode} defaults to 0777. + * + * @param path + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function mkdir(path: string | Buffer, callback?: (err?: NodeJS.ErrnoException) => void): void; + /* + * Asynchronous mkdir - creates the directory specified in {path}. Parameter {mode} defaults to 0777. + * + * @param path + * @param mode + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function mkdir(path: string | Buffer, mode: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + /* + * Asynchronous mkdir - creates the directory specified in {path}. Parameter {mode} defaults to 0777. + * + * @param path + * @param mode + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function mkdir(path: string | Buffer, mode: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + /* + * Synchronous mkdir - creates the directory specified in {path}. Parameter {mode} defaults to 0777. + * + * @param path + * @param mode + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function mkdirSync(path: string | Buffer, mode?: number): void; + /* + * Synchronous mkdir - creates the directory specified in {path}. Parameter {mode} defaults to 0777. + * + * @param path + * @param mode + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function mkdirSync(path: string | Buffer, mode?: string): void; + /* + * Asynchronous mkdtemp - Creates a unique temporary directory. Generates six random characters to be appended behind a required prefix to create a unique temporary directory. + * + * @param prefix + * @param callback The created folder path is passed as a string to the callback's second parameter. + */ + export function mkdtemp(prefix: string, callback?: (err: NodeJS.ErrnoException, folder: string) => void): void; + /* + * Synchronous mkdtemp - Creates a unique temporary directory. Generates six random characters to be appended behind a required prefix to create a unique temporary directory. + * + * @param prefix + * @returns Returns the created folder path. + */ + export function mkdtempSync(prefix: string): string; + export function readdir(path: string | Buffer, callback?: (err: NodeJS.ErrnoException, files: string[]) => void): void; + export function readdirSync(path: string | Buffer): string[]; + export function close(fd: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function closeSync(fd: number): void; + export function open(path: string | Buffer, flags: string | number, callback: (err: NodeJS.ErrnoException, fd: number) => void): void; + export function open(path: string | Buffer, flags: string | number, mode: number, callback: (err: NodeJS.ErrnoException, fd: number) => void): void; + export function openSync(path: string | Buffer, flags: string | number, mode?: number): number; + export function utimes(path: string | Buffer, atime: number, mtime: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function utimes(path: string | Buffer, atime: Date, mtime: Date, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function utimesSync(path: string | Buffer, atime: number, mtime: number): void; + export function utimesSync(path: string | Buffer, atime: Date, mtime: Date): void; + export function futimes(fd: number, atime: number, mtime: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function futimes(fd: number, atime: Date, mtime: Date, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function futimesSync(fd: number, atime: number, mtime: number): void; + export function futimesSync(fd: number, atime: Date, mtime: Date): void; + export function fsync(fd: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function fsyncSync(fd: number): void; + export function write(fd: number, buffer: Buffer, offset: number, length: number, position: number, callback?: (err: NodeJS.ErrnoException, written: number, buffer: Buffer) => void): void; + export function write(fd: number, buffer: Buffer, offset: number, length: number, callback?: (err: NodeJS.ErrnoException, written: number, buffer: Buffer) => void): void; + export function write(fd: number, data: any, callback?: (err: NodeJS.ErrnoException, written: number, str: string) => void): void; + export function write(fd: number, data: any, offset: number, callback?: (err: NodeJS.ErrnoException, written: number, str: string) => void): void; + export function write(fd: number, data: any, offset: number, encoding: string, callback?: (err: NodeJS.ErrnoException, written: number, str: string) => void): void; + export function writeSync(fd: number, buffer: Buffer, offset: number, length: number, position?: number): number; + export function writeSync(fd: number, data: any, position?: number, enconding?: string): number; + export function read(fd: number, buffer: Buffer, offset: number, length: number, position: number, callback?: (err: NodeJS.ErrnoException, bytesRead: number, buffer: Buffer) => void): void; + export function readSync(fd: number, buffer: Buffer, offset: number, length: number, position: number): number; + /* + * Asynchronous readFile - Asynchronously reads the entire contents of a file. + * + * @param fileName + * @param encoding + * @param callback - The callback is passed two arguments (err, data), where data is the contents of the file. + */ + export function readFile(filename: string, encoding: string, callback: (err: NodeJS.ErrnoException, data: string) => void): void; + /* + * Asynchronous readFile - Asynchronously reads the entire contents of a file. + * + * @param fileName + * @param options An object with optional {encoding} and {flag} properties. If {encoding} is specified, readFile returns a string; otherwise it returns a Buffer. + * @param callback - The callback is passed two arguments (err, data), where data is the contents of the file. + */ + export function readFile(filename: string, options: { encoding: string; flag?: string; }, callback: (err: NodeJS.ErrnoException, data: string) => void): void; + /* + * Asynchronous readFile - Asynchronously reads the entire contents of a file. + * + * @param fileName + * @param options An object with optional {encoding} and {flag} properties. If {encoding} is specified, readFile returns a string; otherwise it returns a Buffer. + * @param callback - The callback is passed two arguments (err, data), where data is the contents of the file. + */ + export function readFile(filename: string, options: { flag?: string; }, callback: (err: NodeJS.ErrnoException, data: Buffer) => void): void; + /* + * Asynchronous readFile - Asynchronously reads the entire contents of a file. + * + * @param fileName + * @param callback - The callback is passed two arguments (err, data), where data is the contents of the file. + */ + export function readFile(filename: string, callback: (err: NodeJS.ErrnoException, data: Buffer) => void): void; + /* + * Synchronous readFile - Synchronously reads the entire contents of a file. + * + * @param fileName + * @param encoding + */ + export function readFileSync(filename: string, encoding: string): string; + /* + * Synchronous readFile - Synchronously reads the entire contents of a file. + * + * @param fileName + * @param options An object with optional {encoding} and {flag} properties. If {encoding} is specified, readFileSync returns a string; otherwise it returns a Buffer. + */ + export function readFileSync(filename: string, options: { encoding: string; flag?: string; }): string; + /* + * Synchronous readFile - Synchronously reads the entire contents of a file. + * + * @param fileName + * @param options An object with optional {encoding} and {flag} properties. If {encoding} is specified, readFileSync returns a string; otherwise it returns a Buffer. + */ + export function readFileSync(filename: string, options?: { flag?: string; }): Buffer; + export function writeFile(filename: string, data: any, callback?: (err: NodeJS.ErrnoException) => void): void; + export function writeFile(filename: string, data: any, options: { encoding?: string; mode?: number; flag?: string; }, callback?: (err: NodeJS.ErrnoException) => void): void; + export function writeFile(filename: string, data: any, options: { encoding?: string; mode?: string; flag?: string; }, callback?: (err: NodeJS.ErrnoException) => void): void; + export function writeFileSync(filename: string, data: any, options?: { encoding?: string; mode?: number; flag?: string; }): void; + export function writeFileSync(filename: string, data: any, options?: { encoding?: string; mode?: string; flag?: string; }): void; + export function appendFile(filename: string, data: any, options: { encoding?: string; mode?: number; flag?: string; }, callback?: (err: NodeJS.ErrnoException) => void): void; + export function appendFile(filename: string, data: any, options: { encoding?: string; mode?: string; flag?: string; }, callback?: (err: NodeJS.ErrnoException) => void): void; + export function appendFile(filename: string, data: any, callback?: (err: NodeJS.ErrnoException) => void): void; + export function appendFileSync(filename: string, data: any, options?: { encoding?: string; mode?: number; flag?: string; }): void; + export function appendFileSync(filename: string, data: any, options?: { encoding?: string; mode?: string; flag?: string; }): void; + export function watchFile(filename: string, listener: (curr: Stats, prev: Stats) => void): void; + export function watchFile(filename: string, options: { persistent?: boolean; interval?: number; }, listener: (curr: Stats, prev: Stats) => void): void; + export function unwatchFile(filename: string, listener?: (curr: Stats, prev: Stats) => void): void; + export function watch(filename: string, listener?: (event: string, filename: string) => any): FSWatcher; + export function watch(filename: string, encoding: string, listener?: (event: string, filename: string | Buffer) => any): FSWatcher; + export function watch(filename: string, options: { persistent?: boolean; recursive?: boolean; encoding?: string }, listener?: (event: string, filename: string | Buffer) => any): FSWatcher; + export function exists(path: string | Buffer, callback?: (exists: boolean) => void): void; + export function existsSync(path: string | Buffer): boolean; + + interface Constants { + /** Constant for fs.access(). File is visible to the calling process. */ + F_OK: number; + + /** Constant for fs.access(). File can be read by the calling process. */ + R_OK: number; + + /** Constant for fs.access(). File can be written by the calling process. */ + W_OK: number; + + /** Constant for fs.access(). File can be executed by the calling process. */ + X_OK: number; + } + + export const constants: Constants; + + /** Tests a user's permissions for the file specified by path. */ + export function access(path: string | Buffer, callback: (err: NodeJS.ErrnoException) => void): void; + export function access(path: string | Buffer, mode: number, callback: (err: NodeJS.ErrnoException) => void): void; + /** Synchronous version of fs.access. This throws if any accessibility checks fail, and does nothing otherwise. */ + export function accessSync(path: string | Buffer, mode?: number): void; + export function createReadStream(path: string | Buffer, options?: { + flags?: string; + encoding?: string; + fd?: number; + mode?: number; + autoClose?: boolean; + start?: number; + end?: number; + }): ReadStream; + export function createWriteStream(path: string | Buffer, options?: { + flags?: string; + encoding?: string; + fd?: number; + mode?: number; + }): WriteStream; + export function fdatasync(fd: number, callback: Function): void; + export function fdatasyncSync(fd: number): void; +} + +declare module "path" { + + /** + * A parsed path object generated by path.parse() or consumed by path.format(). + */ + export interface ParsedPath { + /** + * The root of the path such as '/' or 'c:\' + */ + root: string; + /** + * The full directory path such as '/home/user/dir' or 'c:\path\dir' + */ + dir: string; + /** + * The file name including extension (if any) such as 'index.html' + */ + base: string; + /** + * The file extension (if any) such as '.html' + */ + ext: string; + /** + * The file name without extension (if any) such as 'index' + */ + name: string; + } + + /** + * Normalize a string path, reducing '..' and '.' parts. + * When multiple slashes are found, they're replaced by a single one; when the path contains a trailing slash, it is preserved. On Windows backslashes are used. + * + * @param p string path to normalize. + */ + export function normalize(p: string): string; + /** + * Join all arguments together and normalize the resulting path. + * Arguments must be strings. In v0.8, non-string arguments were silently ignored. In v0.10 and up, an exception is thrown. + * + * @param paths string paths to join. + */ + export function join(...paths: any[]): string; + /** + * Join all arguments together and normalize the resulting path. + * Arguments must be strings. In v0.8, non-string arguments were silently ignored. In v0.10 and up, an exception is thrown. + * + * @param paths string paths to join. + */ + export function join(...paths: string[]): string; + /** + * The right-most parameter is considered {to}. Other parameters are considered an array of {from}. + * + * Starting from leftmost {from} paramter, resolves {to} to an absolute path. + * + * If {to} isn't already absolute, {from} arguments are prepended in right to left order, until an absolute path is found. If after using all {from} paths still no absolute path is found, the current working directory is used as well. The resulting path is normalized, and trailing slashes are removed unless the path gets resolved to the root directory. + * + * @param pathSegments string paths to join. Non-string arguments are ignored. + */ + export function resolve(...pathSegments: any[]): string; + /** + * Determines whether {path} is an absolute path. An absolute path will always resolve to the same location, regardless of the working directory. + * + * @param path path to test. + */ + export function isAbsolute(path: string): boolean; + /** + * Solve the relative path from {from} to {to}. + * At times we have two absolute paths, and we need to derive the relative path from one to the other. This is actually the reverse transform of path.resolve. + * + * @param from + * @param to + */ + export function relative(from: string, to: string): string; + /** + * Return the directory name of a path. Similar to the Unix dirname command. + * + * @param p the path to evaluate. + */ + export function dirname(p: string): string; + /** + * Return the last portion of a path. Similar to the Unix basename command. + * Often used to extract the file name from a fully qualified path. + * + * @param p the path to evaluate. + * @param ext optionally, an extension to remove from the result. + */ + export function basename(p: string, ext?: string): string; + /** + * Return the extension of the path, from the last '.' to end of string in the last portion of the path. + * If there is no '.' in the last portion of the path or the first character of it is '.', then it returns an empty string + * + * @param p the path to evaluate. + */ + export function extname(p: string): string; + /** + * The platform-specific file separator. '\\' or '/'. + */ + export var sep: string; + /** + * The platform-specific file delimiter. ';' or ':'. + */ + export var delimiter: string; + /** + * Returns an object from a path string - the opposite of format(). + * + * @param pathString path to evaluate. + */ + export function parse(pathString: string): ParsedPath; + /** + * Returns a path string from an object - the opposite of parse(). + * + * @param pathString path to evaluate. + */ + export function format(pathObject: ParsedPath): string; + + export module posix { + export function normalize(p: string): string; + export function join(...paths: any[]): string; + export function resolve(...pathSegments: any[]): string; + export function isAbsolute(p: string): boolean; + export function relative(from: string, to: string): string; + export function dirname(p: string): string; + export function basename(p: string, ext?: string): string; + export function extname(p: string): string; + export var sep: string; + export var delimiter: string; + export function parse(p: string): ParsedPath; + export function format(pP: ParsedPath): string; + } + + export module win32 { + export function normalize(p: string): string; + export function join(...paths: any[]): string; + export function resolve(...pathSegments: any[]): string; + export function isAbsolute(p: string): boolean; + export function relative(from: string, to: string): string; + export function dirname(p: string): string; + export function basename(p: string, ext?: string): string; + export function extname(p: string): string; + export var sep: string; + export var delimiter: string; + export function parse(p: string): ParsedPath; + export function format(pP: ParsedPath): string; + } +} + +declare module "string_decoder" { + export interface NodeStringDecoder { + write(buffer: Buffer): string; + end(buffer?: Buffer): string; + } + export var StringDecoder: { + new (encoding?: string): NodeStringDecoder; + }; +} + +declare module "tls" { + import * as crypto from "crypto"; + import * as net from "net"; + import * as stream from "stream"; + + var CLIENT_RENEG_LIMIT: number; + var CLIENT_RENEG_WINDOW: number; + + export interface Certificate { + /** + * Country code. + */ + C: string; + /** + * Street. + */ + ST: string; + /** + * Locality. + */ + L: string; + /** + * Organization. + */ + O: string; + /** + * Organizational unit. + */ + OU: string; + /** + * Common name. + */ + CN: string; + } + + export interface CipherNameAndProtocol { + /** + * The cipher name. + */ + name: string; + /** + * SSL/TLS protocol version. + */ + version: string; + } + + export class TLSSocket extends stream.Duplex { + /** + * Returns the bound address, the address family name and port of the underlying socket as reported by + * the operating system. + * @returns {any} - An object with three properties, e.g. { port: 12346, family: 'IPv4', address: '127.0.0.1' }. + */ + address(): { port: number; family: string; address: string }; + /** + * A boolean that is true if the peer certificate was signed by one of the specified CAs, otherwise false. + */ + authorized: boolean; + /** + * The reason why the peer's certificate has not been verified. + * This property becomes available only when tlsSocket.authorized === false. + */ + authorizationError: Error; + /** + * Static boolean value, always true. + * May be used to distinguish TLS sockets from regular ones. + */ + encrypted: boolean; + /** + * Returns an object representing the cipher name and the SSL/TLS protocol version of the current connection. + * @returns {CipherNameAndProtocol} - Returns an object representing the cipher name + * and the SSL/TLS protocol version of the current connection. + */ + getCipher(): CipherNameAndProtocol; + /** + * Returns an object representing the peer's certificate. + * The returned object has some properties corresponding to the field of the certificate. + * If detailed argument is true the full chain with issuer property will be returned, + * if false only the top certificate without issuer property. + * If the peer does not provide a certificate, it returns null or an empty object. + * @param {boolean} detailed - If true; the full chain with issuer property will be returned. + * @returns {any} - An object representing the peer's certificate. + */ + getPeerCertificate(detailed?: boolean): { + subject: Certificate; + issuerInfo: Certificate; + issuer: Certificate; + raw: any; + valid_from: string; + valid_to: string; + fingerprint: string; + serialNumber: string; + }; + /** + * Could be used to speed up handshake establishment when reconnecting to the server. + * @returns {any} - ASN.1 encoded TLS session or undefined if none was negotiated. + */ + getSession(): any; + /** + * NOTE: Works only with client TLS sockets. + * Useful only for debugging, for session reuse provide session option to tls.connect(). + * @returns {any} - TLS session ticket or undefined if none was negotiated. + */ + getTLSTicket(): any; + /** + * The string representation of the local IP address. + */ + localAddress: string; + /** + * The numeric representation of the local port. + */ + localPort: string; + /** + * The string representation of the remote IP address. + * For example, '74.125.127.100' or '2001:4860:a005::68'. + */ + remoteAddress: string; + /** + * The string representation of the remote IP family. 'IPv4' or 'IPv6'. + */ + remoteFamily: string; + /** + * The numeric representation of the remote port. For example, 443. + */ + remotePort: number; + /** + * Initiate TLS renegotiation process. + * + * NOTE: Can be used to request peer's certificate after the secure connection has been established. + * ANOTHER NOTE: When running as the server, socket will be destroyed with an error after handshakeTimeout timeout. + * @param {TlsOptions} options - The options may contain the following fields: rejectUnauthorized, + * requestCert (See tls.createServer() for details). + * @param {Function} callback - callback(err) will be executed with null as err, once the renegotiation + * is successfully completed. + */ + renegotiate(options: TlsOptions, callback: (err: Error) => any): any; + /** + * Set maximum TLS fragment size (default and maximum value is: 16384, minimum is: 512). + * Smaller fragment size decreases buffering latency on the client: large fragments are buffered by + * the TLS layer until the entire fragment is received and its integrity is verified; + * large fragments can span multiple roundtrips, and their processing can be delayed due to packet + * loss or reordering. However, smaller fragments add extra TLS framing bytes and CPU overhead, + * which may decrease overall server throughput. + * @param {number} size - TLS fragment size (default and maximum value is: 16384, minimum is: 512). + * @returns {boolean} - Returns true on success, false otherwise. + */ + setMaxSendFragment(size: number): boolean; + } + + export interface TlsOptions { + host?: string; + port?: number; + pfx?: string | Buffer[]; + key?: string | string[] | Buffer | any[]; + passphrase?: string; + cert?: string | string[] | Buffer | Buffer[]; + ca?: string | string[] | Buffer | Buffer[]; + crl?: string | string[]; + ciphers?: string; + honorCipherOrder?: boolean; + requestCert?: boolean; + rejectUnauthorized?: boolean; + NPNProtocols?: string[] | Buffer; + SNICallback?: (servername: string, cb: (err: Error, ctx: SecureContext) => any) => any; + ecdhCurve?: string; + dhparam?: string | Buffer; + handshakeTimeout?: number; + ALPNProtocols?: string[] | Buffer; + sessionTimeout?: number; + ticketKeys?: any; + sessionIdContext?: string; + secureProtocol?: string; + } + + export interface ConnectionOptions { + host?: string; + port?: number; + socket?: net.Socket; + pfx?: string | Buffer + key?: string | string[] | Buffer | Buffer[]; + passphrase?: string; + cert?: string | string[] | Buffer | Buffer[]; + ca?: string | Buffer | (string | Buffer)[]; + rejectUnauthorized?: boolean; + NPNProtocols?: (string | Buffer)[]; + servername?: string; + path?: string; + ALPNProtocols?: (string | Buffer)[]; + checkServerIdentity?: (servername: string, cert: string | Buffer | (string | Buffer)[]) => any; + secureProtocol?: string; + secureContext?: Object; + session?: Buffer; + minDHSize?: number; + } + + export interface Server extends net.Server { + close(): Server; + address(): { port: number; family: string; address: string; }; + addContext(hostName: string, credentials: { + key: string; + cert: string; + ca: string; + }): void; + maxConnections: number; + connections: number; + } + + export interface ClearTextStream extends stream.Duplex { + authorized: boolean; + authorizationError: Error; + getPeerCertificate(): any; + getCipher: { + name: string; + version: string; + }; + address: { + port: number; + family: string; + address: string; + }; + remoteAddress: string; + remotePort: number; + } + + export interface SecurePair { + encrypted: any; + cleartext: any; + } + + export interface SecureContextOptions { + pfx?: string | Buffer; + key?: string | Buffer; + passphrase?: string; + cert?: string | Buffer; + ca?: string | Buffer; + crl?: string | string[] + ciphers?: string; + honorCipherOrder?: boolean; + } + + export interface SecureContext { + context: any; + } + + export function createServer(options: TlsOptions, secureConnectionListener?: (cleartextStream: ClearTextStream) => void): Server; + export function connect(options: ConnectionOptions, secureConnectionListener?: () => void): ClearTextStream; + export function connect(port: number, host?: string, options?: ConnectionOptions, secureConnectListener?: () => void): ClearTextStream; + export function connect(port: number, options?: ConnectionOptions, secureConnectListener?: () => void): ClearTextStream; + export function createSecurePair(credentials?: crypto.Credentials, isServer?: boolean, requestCert?: boolean, rejectUnauthorized?: boolean): SecurePair; + export function createSecureContext(details: SecureContextOptions): SecureContext; +} + +declare module "crypto" { + export interface Certificate { + exportChallenge(spkac: string | Buffer): Buffer; + exportPublicKey(spkac: string | Buffer): Buffer; + verifySpkac(spkac: Buffer): boolean; + } + export var Certificate: { + new (): Certificate; + (): Certificate; + } + + export var fips: boolean; + + export interface CredentialDetails { + pfx: string; + key: string; + passphrase: string; + cert: string; + ca: string | string[]; + crl: string | string[]; + ciphers: string; + } + export interface Credentials { context?: any; } + export function createCredentials(details: CredentialDetails): Credentials; + export function createHash(algorithm: string): Hash; + export function createHmac(algorithm: string, key: string | Buffer): Hmac; + + type Utf8AsciiLatin1Encoding = "utf8" | "ascii" | "latin1"; + type HexBase64Latin1Encoding = "latin1" | "hex" | "base64"; + type Utf8AsciiBinaryEncoding = "utf8" | "ascii" | "binary"; + type HexBase64BinaryEncoding = "binary" | "base64" | "hex"; + type ECDHKeyFormat = "compressed" | "uncompressed" | "hybrid"; + + export interface Hash extends NodeJS.ReadWriteStream { + update(data: string | Buffer): Hash; + update(data: string | Buffer, input_encoding: Utf8AsciiLatin1Encoding): Hash; + digest(): Buffer; + digest(encoding: HexBase64Latin1Encoding): string; + } + export interface Hmac extends NodeJS.ReadWriteStream { + update(data: string | Buffer): Hmac; + update(data: string | Buffer, input_encoding: Utf8AsciiLatin1Encoding): Hmac; + digest(): Buffer; + digest(encoding: HexBase64Latin1Encoding): string; + } + export function createCipher(algorithm: string, password: any): Cipher; + export function createCipheriv(algorithm: string, key: any, iv: any): Cipher; + export interface Cipher extends NodeJS.ReadWriteStream { + update(data: Buffer): Buffer; + update(data: string, input_encoding: Utf8AsciiBinaryEncoding): Buffer; + update(data: Buffer, input_encoding: any, output_encoding: HexBase64BinaryEncoding): string; + update(data: string, input_encoding: Utf8AsciiBinaryEncoding, output_encoding: HexBase64BinaryEncoding): string; + final(): Buffer; + final(output_encoding: string): string; + setAutoPadding(auto_padding?: boolean): void; + getAuthTag(): Buffer; + setAAD(buffer: Buffer): void; + } + export function createDecipher(algorithm: string, password: any): Decipher; + export function createDecipheriv(algorithm: string, key: any, iv: any): Decipher; + export interface Decipher extends NodeJS.ReadWriteStream { + update(data: Buffer): Buffer; + update(data: string, input_encoding: HexBase64BinaryEncoding): Buffer; + update(data: Buffer, input_encoding: any, output_encoding: Utf8AsciiBinaryEncoding): string; + update(data: string, input_encoding: HexBase64BinaryEncoding, output_encoding: Utf8AsciiBinaryEncoding): string; + final(): Buffer; + final(output_encoding: string): string; + setAutoPadding(auto_padding?: boolean): void; + setAuthTag(tag: Buffer): void; + setAAD(buffer: Buffer): void; + } + export function createSign(algorithm: string): Signer; + export interface Signer extends NodeJS.WritableStream { + update(data: string | Buffer): Signer; + update(data: string | Buffer, input_encoding: Utf8AsciiLatin1Encoding): Signer; + sign(private_key: string | { key: string; passphrase: string }): Buffer; + sign(private_key: string | { key: string; passphrase: string }, output_format: HexBase64Latin1Encoding): string; + } + export function createVerify(algorith: string): Verify; + export interface Verify extends NodeJS.WritableStream { + update(data: string | Buffer): Verify; + update(data: string | Buffer, input_encoding: Utf8AsciiLatin1Encoding): Verify; + verify(object: string, signature: Buffer): boolean; + verify(object: string, signature: string, signature_format: HexBase64Latin1Encoding): boolean; + } + export function createDiffieHellman(prime_length: number, generator?: number): DiffieHellman; + export function createDiffieHellman(prime: Buffer): DiffieHellman; + export function createDiffieHellman(prime: string, prime_encoding: HexBase64Latin1Encoding): DiffieHellman; + export function createDiffieHellman(prime: string, prime_encoding: HexBase64Latin1Encoding, generator: number | Buffer): DiffieHellman; + export function createDiffieHellman(prime: string, prime_encoding: HexBase64Latin1Encoding, generator: string, generator_encoding: HexBase64Latin1Encoding): DiffieHellman; + export interface DiffieHellman { + generateKeys(): Buffer; + generateKeys(encoding: HexBase64Latin1Encoding): string; + computeSecret(other_public_key: Buffer): Buffer; + computeSecret(other_public_key: string, input_encoding: HexBase64Latin1Encoding): Buffer; + computeSecret(other_public_key: string, input_encoding: HexBase64Latin1Encoding, output_encoding: HexBase64Latin1Encoding): string; + getPrime(): Buffer; + getPrime(encoding: HexBase64Latin1Encoding): string; + getGenerator(): Buffer; + getGenerator(encoding: HexBase64Latin1Encoding): string; + getPublicKey(): Buffer; + getPublicKey(encoding: HexBase64Latin1Encoding): string; + getPrivateKey(): Buffer; + getPrivateKey(encoding: HexBase64Latin1Encoding): string; + setPublicKey(public_key: Buffer): void; + setPublicKey(public_key: string, encoding: string): void; + setPrivateKey(private_key: Buffer): void; + setPrivateKey(private_key: string, encoding: string): void; + verifyError: number; + } + export function getDiffieHellman(group_name: string): DiffieHellman; + export function pbkdf2(password: string | Buffer, salt: string | Buffer, iterations: number, keylen: number, digest: string, callback: (err: Error, derivedKey: Buffer) => any): void; + export function pbkdf2Sync(password: string | Buffer, salt: string | Buffer, iterations: number, keylen: number, digest: string): Buffer; + export function randomBytes(size: number): Buffer; + export function randomBytes(size: number, callback: (err: Error, buf: Buffer) => void): void; + export function pseudoRandomBytes(size: number): Buffer; + export function pseudoRandomBytes(size: number, callback: (err: Error, buf: Buffer) => void): void; + export interface RsaPublicKey { + key: string; + padding?: number; + } + export interface RsaPrivateKey { + key: string; + passphrase?: string, + padding?: number; + } + export function publicEncrypt(public_key: string | RsaPublicKey, buffer: Buffer): Buffer + export function privateDecrypt(private_key: string | RsaPrivateKey, buffer: Buffer): Buffer + export function privateEncrypt(private_key: string | RsaPrivateKey, buffer: Buffer): Buffer + export function publicDecrypt(public_key: string | RsaPublicKey, buffer: Buffer): Buffer + export function getCiphers(): string[]; + export function getCurves(): string[]; + export function getHashes(): string[]; + export interface ECDH { + generateKeys(): Buffer; + generateKeys(encoding: HexBase64Latin1Encoding): string; + generateKeys(encoding: HexBase64Latin1Encoding, format: ECDHKeyFormat): string; + computeSecret(other_public_key: Buffer): Buffer; + computeSecret(other_public_key: string, input_encoding: HexBase64Latin1Encoding): Buffer; + computeSecret(other_public_key: string, input_encoding: HexBase64Latin1Encoding, output_encoding: HexBase64Latin1Encoding): string; + getPrivateKey(): Buffer; + getPrivateKey(encoding: HexBase64Latin1Encoding): string; + getPublicKey(): Buffer; + getPublicKey(encoding: HexBase64Latin1Encoding): string; + getPublicKey(encoding: HexBase64Latin1Encoding, format: ECDHKeyFormat): string; + setPrivateKey(private_key: Buffer): void; + setPrivateKey(private_key: string, encoding: HexBase64Latin1Encoding): void; + } + export function createECDH(curve_name: string): ECDH; + export var DEFAULT_ENCODING: string; +} + +declare module "stream" { + import * as events from "events"; + + class internal extends events.EventEmitter { + pipe(destination: T, options?: { end?: boolean; }): T; + } + namespace internal { + + export class Stream extends internal { } + + export interface ReadableOptions { + highWaterMark?: number; + encoding?: string; + objectMode?: boolean; + read?: (size?: number) => any; + } + + export class Readable extends events.EventEmitter implements NodeJS.ReadableStream { + readable: boolean; + constructor(opts?: ReadableOptions); + _read(size: number): void; + read(size?: number): any; + setEncoding(encoding: string): void; + pause(): Readable; + resume(): Readable; + pipe(destination: T, options?: { end?: boolean; }): T; + unpipe(destination?: T): void; + unshift(chunk: any): void; + wrap(oldStream: NodeJS.ReadableStream): NodeJS.ReadableStream; + push(chunk: any, encoding?: string): boolean; + + /** + * Event emitter + * The defined events on documents including: + * 1. close + * 2. data + * 3. end + * 4. readable + * 5. error + **/ + addListener(event: string, listener: Function): this; + addListener(event: string, listener: Function): this; + addListener(event: "close", listener: () => void): this; + addListener(event: "data", listener: (chunk: Buffer | string) => void): this; + addListener(event: "end", listener: () => void): this; + addListener(event: "readable", listener: () => void): this; + addListener(event: "error", listener: (err: Error) => void): this; + + emit(event: string, ...args: any[]): boolean; + emit(event: "close"): boolean; + emit(event: "data", chunk: Buffer | string): boolean; + emit(event: "end"): boolean; + emit(event: "readable"): boolean; + emit(event: "error", err: Error): boolean; + + on(event: string, listener: Function): this; + on(event: "close", listener: () => void): this; + on(event: "data", listener: (chunk: Buffer | string) => void): this; + on(event: "end", listener: () => void): this; + on(event: "readable", listener: () => void): this; + on(event: "error", listener: (err: Error) => void): this; + + once(event: string, listener: Function): this; + once(event: "close", listener: () => void): this; + once(event: "data", listener: (chunk: Buffer | string) => void): this; + once(event: "end", listener: () => void): this; + once(event: "readable", listener: () => void): this; + once(event: "error", listener: (err: Error) => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "close", listener: () => void): this; + prependListener(event: "data", listener: (chunk: Buffer | string) => void): this; + prependListener(event: "end", listener: () => void): this; + prependListener(event: "readable", listener: () => void): this; + prependListener(event: "error", listener: (err: Error) => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "close", listener: () => void): this; + prependOnceListener(event: "data", listener: (chunk: Buffer | string) => void): this; + prependOnceListener(event: "end", listener: () => void): this; + prependOnceListener(event: "readable", listener: () => void): this; + prependOnceListener(event: "error", listener: (err: Error) => void): this; + + removeListener(event: string, listener: Function): this; + removeListener(event: "close", listener: () => void): this; + removeListener(event: "data", listener: (chunk: Buffer | string) => void): this; + removeListener(event: "end", listener: () => void): this; + removeListener(event: "readable", listener: () => void): this; + removeListener(event: "error", listener: (err: Error) => void): this; + } + + export interface WritableOptions { + highWaterMark?: number; + decodeStrings?: boolean; + objectMode?: boolean; + write?: (chunk: string | Buffer, encoding: string, callback: Function) => any; + writev?: (chunks: { chunk: string | Buffer, encoding: string }[], callback: Function) => any; + } + + export class Writable extends events.EventEmitter implements NodeJS.WritableStream { + writable: boolean; + constructor(opts?: WritableOptions); + _write(chunk: any, encoding: string, callback: Function): void; + write(chunk: any, cb?: Function): boolean; + write(chunk: any, encoding?: string, cb?: Function): boolean; + end(): void; + end(chunk: any, cb?: Function): void; + end(chunk: any, encoding?: string, cb?: Function): void; + + /** + * Event emitter + * The defined events on documents including: + * 1. close + * 2. drain + * 3. error + * 4. finish + * 5. pipe + * 6. unpipe + **/ + addListener(event: string, listener: Function): this; + addListener(event: "close", listener: () => void): this; + addListener(event: "drain", listener: () => void): this; + addListener(event: "error", listener: (err: Error) => void): this; + addListener(event: "finish", listener: () => void): this; + addListener(event: "pipe", listener: (src: Readable) => void): this; + addListener(event: "unpipe", listener: (src: Readable) => void): this; + + emit(event: string, ...args: any[]): boolean; + emit(event: "close"): boolean; + emit(event: "drain", chunk: Buffer | string): boolean; + emit(event: "error", err: Error): boolean; + emit(event: "finish"): boolean; + emit(event: "pipe", src: Readable): boolean; + emit(event: "unpipe", src: Readable): boolean; + + on(event: string, listener: Function): this; + on(event: "close", listener: () => void): this; + on(event: "drain", listener: () => void): this; + on(event: "error", listener: (err: Error) => void): this; + on(event: "finish", listener: () => void): this; + on(event: "pipe", listener: (src: Readable) => void): this; + on(event: "unpipe", listener: (src: Readable) => void): this; + + once(event: string, listener: Function): this; + once(event: "close", listener: () => void): this; + once(event: "drain", listener: () => void): this; + once(event: "error", listener: (err: Error) => void): this; + once(event: "finish", listener: () => void): this; + once(event: "pipe", listener: (src: Readable) => void): this; + once(event: "unpipe", listener: (src: Readable) => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "close", listener: () => void): this; + prependListener(event: "drain", listener: () => void): this; + prependListener(event: "error", listener: (err: Error) => void): this; + prependListener(event: "finish", listener: () => void): this; + prependListener(event: "pipe", listener: (src: Readable) => void): this; + prependListener(event: "unpipe", listener: (src: Readable) => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "close", listener: () => void): this; + prependOnceListener(event: "drain", listener: () => void): this; + prependOnceListener(event: "error", listener: (err: Error) => void): this; + prependOnceListener(event: "finish", listener: () => void): this; + prependOnceListener(event: "pipe", listener: (src: Readable) => void): this; + prependOnceListener(event: "unpipe", listener: (src: Readable) => void): this; + + removeListener(event: string, listener: Function): this; + removeListener(event: "close", listener: () => void): this; + removeListener(event: "drain", listener: () => void): this; + removeListener(event: "error", listener: (err: Error) => void): this; + removeListener(event: "finish", listener: () => void): this; + removeListener(event: "pipe", listener: (src: Readable) => void): this; + removeListener(event: "unpipe", listener: (src: Readable) => void): this; + } + + export interface DuplexOptions extends ReadableOptions, WritableOptions { + allowHalfOpen?: boolean; + readableObjectMode?: boolean; + writableObjectMode?: boolean; + } + + // Note: Duplex extends both Readable and Writable. + export class Duplex extends Readable implements NodeJS.ReadWriteStream { + // Readable + pause(): Duplex; + resume(): Duplex; + // Writeable + writable: boolean; + constructor(opts?: DuplexOptions); + _write(chunk: any, encoding: string, callback: Function): void; + write(chunk: any, cb?: Function): boolean; + write(chunk: any, encoding?: string, cb?: Function): boolean; + end(): void; + end(chunk: any, cb?: Function): void; + end(chunk: any, encoding?: string, cb?: Function): void; + } + + export interface TransformOptions extends ReadableOptions, WritableOptions { + transform?: (chunk: string | Buffer, encoding: string, callback: Function) => any; + flush?: (callback: Function) => any; + } + + // Note: Transform lacks the _read and _write methods of Readable/Writable. + export class Transform extends events.EventEmitter implements NodeJS.ReadWriteStream { + readable: boolean; + writable: boolean; + constructor(opts?: TransformOptions); + _transform(chunk: any, encoding: string, callback: Function): void; + _flush(callback: Function): void; + read(size?: number): any; + setEncoding(encoding: string): void; + pause(): Transform; + resume(): Transform; + pipe(destination: T, options?: { end?: boolean; }): T; + unpipe(destination?: T): void; + unshift(chunk: any): void; + wrap(oldStream: NodeJS.ReadableStream): NodeJS.ReadableStream; + push(chunk: any, encoding?: string): boolean; + write(chunk: any, cb?: Function): boolean; + write(chunk: any, encoding?: string, cb?: Function): boolean; + end(): void; + end(chunk: any, cb?: Function): void; + end(chunk: any, encoding?: string, cb?: Function): void; + } + + export class PassThrough extends Transform { } + } + + export = internal; +} + +declare module "util" { + export interface InspectOptions { + showHidden?: boolean; + depth?: number; + colors?: boolean; + customInspect?: boolean; + } + + export function format(format: any, ...param: any[]): string; + export function debug(string: string): void; + export function error(...param: any[]): void; + export function puts(...param: any[]): void; + export function print(...param: any[]): void; + export function log(string: string): void; + export function inspect(object: any, showHidden?: boolean, depth?: number, color?: boolean): string; + export function inspect(object: any, options: InspectOptions): string; + export function isArray(object: any): boolean; + export function isRegExp(object: any): boolean; + export function isDate(object: any): boolean; + export function isError(object: any): boolean; + export function inherits(constructor: any, superConstructor: any): void; + export function debuglog(key: string): (msg: string, ...param: any[]) => void; + export function isBoolean(object: any): boolean; + export function isBuffer(object: any): boolean; + export function isFunction(object: any): boolean; + export function isNull(object: any): boolean; + export function isNullOrUndefined(object: any): boolean; + export function isNumber(object: any): boolean; + export function isObject(object: any): boolean; + export function isPrimitive(object: any): boolean; + export function isString(object: any): boolean; + export function isSymbol(object: any): boolean; + export function isUndefined(object: any): boolean; + export function deprecate(fn: Function, message: string): Function; +} + +declare module "assert" { + function internal(value: any, message?: string): void; + namespace internal { + export class AssertionError implements Error { + name: string; + message: string; + actual: any; + expected: any; + operator: string; + generatedMessage: boolean; + + constructor(options?: { + message?: string; actual?: any; expected?: any; + operator?: string; stackStartFunction?: Function + }); + } + + export function fail(actual: any, expected: any, message: string, operator: string): void; + export function ok(value: any, message?: string): void; + export function equal(actual: any, expected: any, message?: string): void; + export function notEqual(actual: any, expected: any, message?: string): void; + export function deepEqual(actual: any, expected: any, message?: string): void; + export function notDeepEqual(acutal: any, expected: any, message?: string): void; + export function strictEqual(actual: any, expected: any, message?: string): void; + export function notStrictEqual(actual: any, expected: any, message?: string): void; + export function deepStrictEqual(actual: any, expected: any, message?: string): void; + export function notDeepStrictEqual(actual: any, expected: any, message?: string): void; + export var throws: { + (block: Function, message?: string): void; + (block: Function, error: Function, message?: string): void; + (block: Function, error: RegExp, message?: string): void; + (block: Function, error: (err: any) => boolean, message?: string): void; + }; + + export var doesNotThrow: { + (block: Function, message?: string): void; + (block: Function, error: Function, message?: string): void; + (block: Function, error: RegExp, message?: string): void; + (block: Function, error: (err: any) => boolean, message?: string): void; + }; + + export function ifError(value: any): void; + } + + export = internal; +} + +declare module "tty" { + import * as net from "net"; + + export function isatty(fd: number): boolean; + export interface ReadStream extends net.Socket { + isRaw: boolean; + setRawMode(mode: boolean): void; + isTTY: boolean; + } + export interface WriteStream extends net.Socket { + columns: number; + rows: number; + isTTY: boolean; + } +} + +declare module "domain" { + import * as events from "events"; + + export class Domain extends events.EventEmitter implements NodeJS.Domain { + run(fn: Function): void; + add(emitter: events.EventEmitter): void; + remove(emitter: events.EventEmitter): void; + bind(cb: (err: Error, data: any) => any): any; + intercept(cb: (data: any) => any): any; + dispose(): void; + members: any[]; + enter(): void; + exit(): void; + } + + export function create(): Domain; +} + +declare module "constants" { + export var E2BIG: number; + export var EACCES: number; + export var EADDRINUSE: number; + export var EADDRNOTAVAIL: number; + export var EAFNOSUPPORT: number; + export var EAGAIN: number; + export var EALREADY: number; + export var EBADF: number; + export var EBADMSG: number; + export var EBUSY: number; + export var ECANCELED: number; + export var ECHILD: number; + export var ECONNABORTED: number; + export var ECONNREFUSED: number; + export var ECONNRESET: number; + export var EDEADLK: number; + export var EDESTADDRREQ: number; + export var EDOM: number; + export var EEXIST: number; + export var EFAULT: number; + export var EFBIG: number; + export var EHOSTUNREACH: number; + export var EIDRM: number; + export var EILSEQ: number; + export var EINPROGRESS: number; + export var EINTR: number; + export var EINVAL: number; + export var EIO: number; + export var EISCONN: number; + export var EISDIR: number; + export var ELOOP: number; + export var EMFILE: number; + export var EMLINK: number; + export var EMSGSIZE: number; + export var ENAMETOOLONG: number; + export var ENETDOWN: number; + export var ENETRESET: number; + export var ENETUNREACH: number; + export var ENFILE: number; + export var ENOBUFS: number; + export var ENODATA: number; + export var ENODEV: number; + export var ENOENT: number; + export var ENOEXEC: number; + export var ENOLCK: number; + export var ENOLINK: number; + export var ENOMEM: number; + export var ENOMSG: number; + export var ENOPROTOOPT: number; + export var ENOSPC: number; + export var ENOSR: number; + export var ENOSTR: number; + export var ENOSYS: number; + export var ENOTCONN: number; + export var ENOTDIR: number; + export var ENOTEMPTY: number; + export var ENOTSOCK: number; + export var ENOTSUP: number; + export var ENOTTY: number; + export var ENXIO: number; + export var EOPNOTSUPP: number; + export var EOVERFLOW: number; + export var EPERM: number; + export var EPIPE: number; + export var EPROTO: number; + export var EPROTONOSUPPORT: number; + export var EPROTOTYPE: number; + export var ERANGE: number; + export var EROFS: number; + export var ESPIPE: number; + export var ESRCH: number; + export var ETIME: number; + export var ETIMEDOUT: number; + export var ETXTBSY: number; + export var EWOULDBLOCK: number; + export var EXDEV: number; + export var WSAEINTR: number; + export var WSAEBADF: number; + export var WSAEACCES: number; + export var WSAEFAULT: number; + export var WSAEINVAL: number; + export var WSAEMFILE: number; + export var WSAEWOULDBLOCK: number; + export var WSAEINPROGRESS: number; + export var WSAEALREADY: number; + export var WSAENOTSOCK: number; + export var WSAEDESTADDRREQ: number; + export var WSAEMSGSIZE: number; + export var WSAEPROTOTYPE: number; + export var WSAENOPROTOOPT: number; + export var WSAEPROTONOSUPPORT: number; + export var WSAESOCKTNOSUPPORT: number; + export var WSAEOPNOTSUPP: number; + export var WSAEPFNOSUPPORT: number; + export var WSAEAFNOSUPPORT: number; + export var WSAEADDRINUSE: number; + export var WSAEADDRNOTAVAIL: number; + export var WSAENETDOWN: number; + export var WSAENETUNREACH: number; + export var WSAENETRESET: number; + export var WSAECONNABORTED: number; + export var WSAECONNRESET: number; + export var WSAENOBUFS: number; + export var WSAEISCONN: number; + export var WSAENOTCONN: number; + export var WSAESHUTDOWN: number; + export var WSAETOOMANYREFS: number; + export var WSAETIMEDOUT: number; + export var WSAECONNREFUSED: number; + export var WSAELOOP: number; + export var WSAENAMETOOLONG: number; + export var WSAEHOSTDOWN: number; + export var WSAEHOSTUNREACH: number; + export var WSAENOTEMPTY: number; + export var WSAEPROCLIM: number; + export var WSAEUSERS: number; + export var WSAEDQUOT: number; + export var WSAESTALE: number; + export var WSAEREMOTE: number; + export var WSASYSNOTREADY: number; + export var WSAVERNOTSUPPORTED: number; + export var WSANOTINITIALISED: number; + export var WSAEDISCON: number; + export var WSAENOMORE: number; + export var WSAECANCELLED: number; + export var WSAEINVALIDPROCTABLE: number; + export var WSAEINVALIDPROVIDER: number; + export var WSAEPROVIDERFAILEDINIT: number; + export var WSASYSCALLFAILURE: number; + export var WSASERVICE_NOT_FOUND: number; + export var WSATYPE_NOT_FOUND: number; + export var WSA_E_NO_MORE: number; + export var WSA_E_CANCELLED: number; + export var WSAEREFUSED: number; + export var SIGHUP: number; + export var SIGINT: number; + export var SIGILL: number; + export var SIGABRT: number; + export var SIGFPE: number; + export var SIGKILL: number; + export var SIGSEGV: number; + export var SIGTERM: number; + export var SIGBREAK: number; + export var SIGWINCH: number; + export var SSL_OP_ALL: number; + export var SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION: number; + export var SSL_OP_CIPHER_SERVER_PREFERENCE: number; + export var SSL_OP_CISCO_ANYCONNECT: number; + export var SSL_OP_COOKIE_EXCHANGE: number; + export var SSL_OP_CRYPTOPRO_TLSEXT_BUG: number; + export var SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS: number; + export var SSL_OP_EPHEMERAL_RSA: number; + export var SSL_OP_LEGACY_SERVER_CONNECT: number; + export var SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER: number; + export var SSL_OP_MICROSOFT_SESS_ID_BUG: number; + export var SSL_OP_MSIE_SSLV2_RSA_PADDING: number; + export var SSL_OP_NETSCAPE_CA_DN_BUG: number; + export var SSL_OP_NETSCAPE_CHALLENGE_BUG: number; + export var SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG: number; + export var SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG: number; + export var SSL_OP_NO_COMPRESSION: number; + export var SSL_OP_NO_QUERY_MTU: number; + export var SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION: number; + export var SSL_OP_NO_SSLv2: number; + export var SSL_OP_NO_SSLv3: number; + export var SSL_OP_NO_TICKET: number; + export var SSL_OP_NO_TLSv1: number; + export var SSL_OP_NO_TLSv1_1: number; + export var SSL_OP_NO_TLSv1_2: number; + export var SSL_OP_PKCS1_CHECK_1: number; + export var SSL_OP_PKCS1_CHECK_2: number; + export var SSL_OP_SINGLE_DH_USE: number; + export var SSL_OP_SINGLE_ECDH_USE: number; + export var SSL_OP_SSLEAY_080_CLIENT_DH_BUG: number; + export var SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG: number; + export var SSL_OP_TLS_BLOCK_PADDING_BUG: number; + export var SSL_OP_TLS_D5_BUG: number; + export var SSL_OP_TLS_ROLLBACK_BUG: number; + export var ENGINE_METHOD_DSA: number; + export var ENGINE_METHOD_DH: number; + export var ENGINE_METHOD_RAND: number; + export var ENGINE_METHOD_ECDH: number; + export var ENGINE_METHOD_ECDSA: number; + export var ENGINE_METHOD_CIPHERS: number; + export var ENGINE_METHOD_DIGESTS: number; + export var ENGINE_METHOD_STORE: number; + export var ENGINE_METHOD_PKEY_METHS: number; + export var ENGINE_METHOD_PKEY_ASN1_METHS: number; + export var ENGINE_METHOD_ALL: number; + export var ENGINE_METHOD_NONE: number; + export var DH_CHECK_P_NOT_SAFE_PRIME: number; + export var DH_CHECK_P_NOT_PRIME: number; + export var DH_UNABLE_TO_CHECK_GENERATOR: number; + export var DH_NOT_SUITABLE_GENERATOR: number; + export var NPN_ENABLED: number; + export var RSA_PKCS1_PADDING: number; + export var RSA_SSLV23_PADDING: number; + export var RSA_NO_PADDING: number; + export var RSA_PKCS1_OAEP_PADDING: number; + export var RSA_X931_PADDING: number; + export var RSA_PKCS1_PSS_PADDING: number; + export var POINT_CONVERSION_COMPRESSED: number; + export var POINT_CONVERSION_UNCOMPRESSED: number; + export var POINT_CONVERSION_HYBRID: number; + export var O_RDONLY: number; + export var O_WRONLY: number; + export var O_RDWR: number; + export var S_IFMT: number; + export var S_IFREG: number; + export var S_IFDIR: number; + export var S_IFCHR: number; + export var S_IFBLK: number; + export var S_IFIFO: number; + export var S_IFSOCK: number; + export var S_IRWXU: number; + export var S_IRUSR: number; + export var S_IWUSR: number; + export var S_IXUSR: number; + export var S_IRWXG: number; + export var S_IRGRP: number; + export var S_IWGRP: number; + export var S_IXGRP: number; + export var S_IRWXO: number; + export var S_IROTH: number; + export var S_IWOTH: number; + export var S_IXOTH: number; + export var S_IFLNK: number; + export var O_CREAT: number; + export var O_EXCL: number; + export var O_NOCTTY: number; + export var O_DIRECTORY: number; + export var O_NOATIME: number; + export var O_NOFOLLOW: number; + export var O_SYNC: number; + export var O_SYMLINK: number; + export var O_DIRECT: number; + export var O_NONBLOCK: number; + export var O_TRUNC: number; + export var O_APPEND: number; + export var F_OK: number; + export var R_OK: number; + export var W_OK: number; + export var X_OK: number; + export var UV_UDP_REUSEADDR: number; + export var SIGQUIT: number; + export var SIGTRAP: number; + export var SIGIOT: number; + export var SIGBUS: number; + export var SIGUSR1: number; + export var SIGUSR2: number; + export var SIGPIPE: number; + export var SIGALRM: number; + export var SIGCHLD: number; + export var SIGSTKFLT: number; + export var SIGCONT: number; + export var SIGSTOP: number; + export var SIGTSTP: number; + export var SIGTTIN: number; + export var SIGTTOU: number; + export var SIGURG: number; + export var SIGXCPU: number; + export var SIGXFSZ: number; + export var SIGVTALRM: number; + export var SIGPROF: number; + export var SIGIO: number; + export var SIGPOLL: number; + export var SIGPWR: number; + export var SIGSYS: number; + export var SIGUNUSED: number; + export var defaultCoreCipherList: string; + export var defaultCipherList: string; + export var ENGINE_METHOD_RSA: number; + export var ALPN_ENABLED: number; +} + +declare module "process" { + export = process; +} + +declare module "v8" { + interface HeapSpaceInfo { + space_name: string; + space_size: number; + space_used_size: number; + space_available_size: number; + physical_space_size: number; + } + export function getHeapStatistics(): { total_heap_size: number, total_heap_size_executable: number, total_physical_size: number, total_avaialble_size: number, used_heap_size: number, heap_size_limit: number }; + export function getHeapSpaceStatistics(): HeapSpaceInfo[]; + export function setFlagsFromString(flags: string): void; +} + +declare module "timers" { + export function setTimeout(callback: (...args: any[]) => void, ms: number, ...args: any[]): NodeJS.Timer; + export function clearTimeout(timeoutId: NodeJS.Timer): void; + export function setInterval(callback: (...args: any[]) => void, ms: number, ...args: any[]): NodeJS.Timer; + export function clearInterval(intervalId: NodeJS.Timer): void; + export function setImmediate(callback: (...args: any[]) => void, ...args: any[]): any; + export function clearImmediate(immediateId: any): void; +} + +declare module "console" { + export = console; +} \ No newline at end of file diff --git a/Tasks/Common/kubernetes-common/globals/node/typings.json b/Tasks/Common/kubernetes-common/globals/node/typings.json new file mode 100644 index 000000000000..bff38e407d26 --- /dev/null +++ b/Tasks/Common/kubernetes-common/globals/node/typings.json @@ -0,0 +1,8 @@ +{ + "resolution": "main", + "tree": { + "src": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/ab8d917787092fdfb16390f2bee6de8ab5c1783c/node/node.d.ts", + "raw": "registry:dt/node#6.0.0+20160920093002", + "typings": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/ab8d917787092fdfb16390f2bee6de8ab5c1783c/node/node.d.ts" + } + } \ No newline at end of file diff --git a/Tasks/Common/kubernetes-common/index.d.ts b/Tasks/Common/kubernetes-common/index.d.ts new file mode 100644 index 000000000000..ae5424df2e6f --- /dev/null +++ b/Tasks/Common/kubernetes-common/index.d.ts @@ -0,0 +1 @@ +/// \ No newline at end of file diff --git a/Tasks/Common/utility-common/kubectl-object-model.ts b/Tasks/Common/kubernetes-common/kubectl-object-model.ts similarity index 82% rename from Tasks/Common/utility-common/kubectl-object-model.ts rename to Tasks/Common/kubernetes-common/kubectl-object-model.ts index 61f025e5a944..627882faf2ad 100644 --- a/Tasks/Common/utility-common/kubectl-object-model.ts +++ b/Tasks/Common/kubernetes-common/kubectl-object-model.ts @@ -48,6 +48,24 @@ export class Kubectl { return command.execSync(); } + public createSecret(args: string, force?: boolean, secretName?: string): IExecSyncResult { + if (!!force && !!secretName) { + let command = tl.tool(this.kubectlPath); + command.arg("delete"); + command.arg("secret"); + command.arg(["--namespace", this.namespace]); + command.arg(secretName); + command.execSync(); + } + + var command = tl.tool(this.kubectlPath); + command.arg("create"); + command.arg("secret"); + command.arg(["--namespace", this.namespace]); + command.line(args); + return command.execSync(); + } + public describe(resourceType, resourceName, silent?: boolean): IExecSyncResult { var command = tl.tool(this.kubectlPath); command.arg("describe"); @@ -57,13 +75,16 @@ export class Kubectl { } public getNewReplicaSet(deployment): string { - let stdout = this.describe("deployment", deployment, true).stdout.split("\n"); let newReplicaSet = ""; - stdout.forEach((line: string) => { - if (!!line && line.toLowerCase().indexOf("newreplicaset") > -1) { - newReplicaSet = line.substr(14).trim().split(" ")[0]; - } - }); + let result = this.describe("deployment", deployment, true); + if (result != null && result.stdout != null) { + let stdout = result.stdout.split("\n"); + stdout.forEach((line: string) => { + if (!!line && line.toLowerCase().indexOf("newreplicaset") > -1) { + newReplicaSet = line.substr(14).trim().split(" ")[0]; + } + }); + } return newReplicaSet; } @@ -91,7 +112,6 @@ export class Kubectl { command.arg(resourceType + "/" + name); command.arg(["--namespace", this.namespace]); command.arg(["-o", "json"]) - command.arg("--export=true"); return command.execSync(); } diff --git a/Tasks/Common/kubernetes-common/make.json b/Tasks/Common/kubernetes-common/make.json new file mode 100644 index 000000000000..61852d54ff6e --- /dev/null +++ b/Tasks/Common/kubernetes-common/make.json @@ -0,0 +1,11 @@ +{ + "externals": { + "archivePackages": [ + { + "archiveName": "7zip.zip", + "url": "https://vstsagenttools.blob.core.windows.net/tools/7zip/1/7zip.zip", + "dest": "./" + } + ] + } +} \ No newline at end of file diff --git a/Tasks/Common/kubernetes-common/module.json b/Tasks/Common/kubernetes-common/module.json new file mode 100644 index 000000000000..544b7b4ddde0 --- /dev/null +++ b/Tasks/Common/kubernetes-common/module.json @@ -0,0 +1,3 @@ +{ + +} \ No newline at end of file diff --git a/Tasks/Common/kubernetes-common/package-lock.json b/Tasks/Common/kubernetes-common/package-lock.json new file mode 100644 index 000000000000..baae47240c28 --- /dev/null +++ b/Tasks/Common/kubernetes-common/package-lock.json @@ -0,0 +1,73 @@ +{ + "name": "kubernetes-common", + "version": "1.0.0", + "lockfileVersion": 1, + "requires": true, + "dependencies": { + "balanced-match": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.0.tgz", + "integrity": "sha1-ibTRmasr7kneFk6gK4nORi1xt2c=" + }, + "brace-expansion": { + "version": "1.1.11", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", + "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==", + "requires": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=" + }, + "minimatch": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz", + "integrity": "sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==", + "requires": { + "brace-expansion": "^1.1.7" + } + }, + "mockery": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/mockery/-/mockery-1.7.0.tgz", + "integrity": "sha1-9O3g2HUMHJcnwnLqLGBiniyaHE8=" + }, + "q": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/q/-/q-1.5.1.tgz", + "integrity": "sha1-fjL3W0E4EpHQRhHxvxQQmsAGUdc=" + }, + "semver": { + "version": "5.6.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-5.6.0.tgz", + "integrity": "sha512-RS9R6R35NYgQn++fkDWaOmqGoj4Ek9gGs+DPxNUZKuwE183xjJroKvyo1IzVFeXvUrvmALy6FWD5xrdJT25gMg==" + }, + "shelljs": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/shelljs/-/shelljs-0.3.0.tgz", + "integrity": "sha1-NZbmMHp4FUT1kfN9phg2DzHbV7E=" + }, + "uuid": { + "version": "3.3.2", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-3.3.2.tgz", + "integrity": "sha512-yXJmeNaw3DnnKAOKJE51sL/ZaYfWJRl1pK9dr19YFCu0ObS231AB1/LbqTKRAQ5kw8A90rA6fr4riOUpTZvQZA==" + }, + "vsts-task-lib": { + "version": "2.6.0", + "resolved": "https://registry.npmjs.org/vsts-task-lib/-/vsts-task-lib-2.6.0.tgz", + "integrity": "sha512-ja2qX4BIUvswcNbGtIoGo1SM5mRVc3Yaf7oM4oY64bNHs04chKfvH6f3cDDG0pd44OrZIGQE9LgECzeau6z2wA==", + "requires": { + "minimatch": "3.0.4", + "mockery": "^1.7.0", + "q": "^1.1.2", + "semver": "^5.1.0", + "shelljs": "^0.3.0", + "uuid": "^3.0.1" + } + } + } +} diff --git a/Tasks/Common/kubernetes-common/package.json b/Tasks/Common/kubernetes-common/package.json new file mode 100644 index 000000000000..e22b3c01afe0 --- /dev/null +++ b/Tasks/Common/kubernetes-common/package.json @@ -0,0 +1,18 @@ +{ + "name": "kubernetes-common", + "version": "1.0.0", + "description": "Common Library for Kubernetes", + "repository": { + "type": "git", + "url": "git+ssh://git@github.com/Microsoft/azure-pipelines-tasks.git" + }, + "author": "Microsoft Corporation", + "license": "MIT", + "bugs": { + "url": "https://github.com/Microsoft/azure-pipelines-tasks/issues" + }, + "homepage": "https://github.com/Microsoft/azure-pipelines-tasks#readme", + "dependencies": { + "vsts-task-lib": "2.6.0" + } +} diff --git a/Tasks/Common/kubernetes-common/tsconfig.json b/Tasks/Common/kubernetes-common/tsconfig.json new file mode 100644 index 000000000000..bf3139d06f75 --- /dev/null +++ b/Tasks/Common/kubernetes-common/tsconfig.json @@ -0,0 +1,9 @@ +{ + "compilerOptions": { + "module": "commonjs", + "target": "es6", + "declaration": true, + "noImplicitAny": false, + "sourceMap": false + } +} \ No newline at end of file diff --git a/Tasks/Common/kubernetes-common/typings.json b/Tasks/Common/kubernetes-common/typings.json new file mode 100644 index 000000000000..f47f6e298d90 --- /dev/null +++ b/Tasks/Common/kubernetes-common/typings.json @@ -0,0 +1,5 @@ +{ + "globalDependencies": { + "node": "registry:dt/node#6.0.0+20160920093002" + } +} \ No newline at end of file diff --git a/Tasks/Common/kubernetes-common/typings/index.d.ts b/Tasks/Common/kubernetes-common/typings/index.d.ts new file mode 100644 index 000000000000..3aa41c6f609e --- /dev/null +++ b/Tasks/Common/kubernetes-common/typings/index.d.ts @@ -0,0 +1 @@ +/// \ No newline at end of file diff --git a/Tasks/Common/kubernetes-common/typings/modules/semver/index.d.ts b/Tasks/Common/kubernetes-common/typings/modules/semver/index.d.ts new file mode 100644 index 000000000000..128768535d0f --- /dev/null +++ b/Tasks/Common/kubernetes-common/typings/modules/semver/index.d.ts @@ -0,0 +1,150 @@ +// Generated by typings +// Source: https://raw.githubusercontent.com/types/npm-semver/e98b40dcb906211d06ea8272570719777cece453/semver.d.ts +declare module 'semver' { + /** + * Return the parsed version, or null if it's not valid. + */ + export function valid (v: string, loose?: boolean): string; + + /** + * Return the version incremented by the release type (`major`, `premajor`, `minor`, `preminor`, `patch`, `prepatch`, or `prerelease`), or null if it's not valid. + */ + export function inc (v: string, release: string, loose?: boolean): string; + + /** + * Return the major version number. + */ + export function major (v: string, loose?: boolean): number; + + /** + * Return the minor version number. + */ + export function minor (v: string, loose?: boolean): number; + + /** + * Return the patch version number. + */ + export function patch (v: string, loose?: boolean): number; + + /** + * `v1 > v2`. + */ + export function gt (v1: string, v2: string, loose?: boolean): boolean; + + /** + * `v1 >= v2`. + */ + export function gte (v1: string, v2: string, loose?: boolean): boolean; + + /** + * `v1 < v2`. + */ + export function lt (v1: string, v2: string, loose?: boolean): boolean; + + /** + * v1 <= v2 + */ + export function lte (v1: string, v2: string, loose?: boolean): boolean; + + /** + * `v1 == v2`. This is true if they're logically equivalent, even if they're not the exact same string. You already know how to compare strings. + */ + export function eq (v1: string, v2: string, loose?: boolean): boolean; + + /** + * `v1 != v2`. The opposite of `eq`. + */ + export function neq (v1: string, v2: string, loose?: boolean): boolean; + + /** + * Pass in a comparison string, and it'll call the corresponding function above. `"==="` and `"!=="` do simple string comparison, but are included for completeness. Throws if an invalid comparison string is provided. + */ + export function cmp (v1: string, comparator: any, v2: string, loose?: boolean): boolean; + + /** + * Return `0` if `v1 == v2`, or `1` if `v1` is greater, or `-1` if `v2` is greater. Sorts in ascending order if passed to `Array.sort()`. + */ + export function compare (v1: string, v2: string, loose?: boolean): number; + + /** + * The reverse of compare. Sorts an array of versions in descending order when passed to `Array.sort()`. + */ + export function rcompare (v1: string, v2: string, loose?: boolean): number; + + /** + * Returns difference between two versions by the release type (`major`, `premajor`, `minor`, `preminor`, `patch`, `prepatch`, or `prerelease`), or null if the versions are the same. + */ + export function diff (v1: string, v2: string): string; + + /** + * Return the valid range or null if it's not valid + */ + export function validRange (range: string, loose?: boolean): string; + + /** + * Return true if the version satisfies the range. + */ + export function satisfies (version: string, range: string, loose?: boolean): boolean; + + /** + * Return the highest version in the list that satisfies the range, or null if none of them do. + */ + export function maxSatisfying (versions: string[], range: string, loose?: boolean): string; + + /** + * Return `true` if version is greater than all the versions possible in the range. + */ + export function gtr (version: string, range: string, loose?: boolean): boolean; + + /** + * Return `true` if version is less than all the versions possible in the range. + */ + export function ltr (version: string, range: string, loose?: boolean): boolean; + + /** + * Return `true` if the version is outside the bounds of the range in either the high or low direction. The `hilo` argument must be either the string `'>'` or `'<'`. (This is the function called by `gtr` and `ltr`.) + */ + export function outside (version: string, range: string, hilo: string, loose?: boolean): boolean; + + export class SemVerBase { + raw: string; + loose: boolean; + format (): string; + inspect (): string; + toString (): string; + } + + export class SemVer extends SemVerBase { + constructor(version: string, loose?: boolean); + + major: number; + minor: number; + patch: number; + version: string; + build: string[]; + prerelease: string[]; + + compare (other: SemVer): number; + compareMain (other: SemVer): number; + comparePre (other: SemVer): number; + inc (release: string): this; + } + + export class Comparator extends SemVerBase { + constructor (comp: string, loose?: boolean); + + semver: SemVer; + operator: string; + value: boolean; + parse (comp: string): void; + test (version: SemVer): boolean; + } + + export class Range extends SemVerBase { + constructor (range: string, loose?: boolean); + + set: Comparator[][]; + parseRange (range: string): Comparator[]; + test (version: SemVer): boolean; + } + } \ No newline at end of file diff --git a/Tasks/Common/kubernetes-common/typings/modules/semver/typings.json b/Tasks/Common/kubernetes-common/typings/modules/semver/typings.json new file mode 100644 index 000000000000..c62386986145 --- /dev/null +++ b/Tasks/Common/kubernetes-common/typings/modules/semver/typings.json @@ -0,0 +1,9 @@ +{ + "resolution": "main", + "tree": { + "src": "https://raw.githubusercontent.com/types/npm-semver/e98b40dcb906211d06ea8272570719777cece453/typings.json", + "raw": "registry:npm/semver#5.0.0+20160723033700", + "main": "semver.d.ts", + "name": "semver" + } + } \ No newline at end of file diff --git a/Tasks/Common/utility-common/kubectlutility.ts b/Tasks/Common/utility-common/kubectlutility.ts index 6dd4c6312ccd..cb6300c0d411 100644 --- a/Tasks/Common/utility-common/kubectlutility.ts +++ b/Tasks/Common/utility-common/kubectlutility.ts @@ -7,9 +7,8 @@ import * as util from "util"; import * as yaml from "js-yaml"; const uuidV4 = require('uuid/v4'); const kubectlToolName = "kubectl"; -export const stableKubectlVersion = "v1.13.2"; +export const stableKubectlVersion = "v1.14.0"; import { WebRequest, sendRequest } from "./restutilities"; -import { async } from "q"; var fs = require('fs'); diff --git a/Tasks/Common/utility-common/package-lock.json b/Tasks/Common/utility-common/package-lock.json index fab208207d90..0405589fb4bc 100644 --- a/Tasks/Common/utility-common/package-lock.json +++ b/Tasks/Common/utility-common/package-lock.json @@ -48,7 +48,7 @@ "minimatch": { "version": "3.0.4", "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz", - "integrity": "sha1-UWbihkV/AzBgZL5Ul+jbsMPTIIM=", + "integrity": "sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==", "requires": { "brace-expansion": "^1.1.7" } diff --git a/Tasks/DockerV2/task.json b/Tasks/DockerV2/task.json index cd478aab820b..42bc19e4d183 100644 --- a/Tasks/DockerV2/task.json +++ b/Tasks/DockerV2/task.json @@ -14,7 +14,7 @@ "version": { "Major": 2, "Minor": 150, - "Patch": 4 + "Patch": 5 }, "demands": [], "releaseNotes": "Simplified the task YAML by:
 - Removing the Container registry type input
 - Removing complex inputs as they can be passed as arguments to the command.", diff --git a/Tasks/DotNetCoreCLIV2/task.json b/Tasks/DotNetCoreCLIV2/task.json index e762d5c8c9cd..78d4bcecd41f 100644 --- a/Tasks/DotNetCoreCLIV2/task.json +++ b/Tasks/DotNetCoreCLIV2/task.json @@ -18,7 +18,7 @@ "version": { "Major": 2, "Minor": 150, - "Patch": 2 + "Patch": 3 }, "minimumAgentVersion": "2.115.0", "instanceNameFormat": "dotnet $(command)", diff --git a/Tasks/DownloadPackageV0/task.json b/Tasks/DownloadPackageV0/task.json index cabf3944c659..c0a2be904ed0 100644 --- a/Tasks/DownloadPackageV0/task.json +++ b/Tasks/DownloadPackageV0/task.json @@ -10,7 +10,7 @@ "version": { "Major": 0, "Minor": 150, - "Patch": 1 + "Patch": 2 }, "demands": [], "minimumAgentVersion": "1.99.0", diff --git a/Tasks/DownloadPackageV1/task.json b/Tasks/DownloadPackageV1/task.json index fd5d3da263f2..2bc7bfcf6d1a 100644 --- a/Tasks/DownloadPackageV1/task.json +++ b/Tasks/DownloadPackageV1/task.json @@ -10,7 +10,7 @@ "version": { "Major": 1, "Minor": 150, - "Patch": 1 + "Patch": 2 }, "demands": [], "minimumAgentVersion": "2.115.0", diff --git a/Tasks/DuffleInstallerV0/task.json b/Tasks/DuffleInstallerV0/task.json index 6913ab73ec2d..d8d9c068413f 100644 --- a/Tasks/DuffleInstallerV0/task.json +++ b/Tasks/DuffleInstallerV0/task.json @@ -14,7 +14,7 @@ "version": { "Major": 0, "Minor": 0, - "Patch": 2 + "Patch": 3 }, "demands": [], "groups": [], diff --git a/Tasks/GitHubReleaseV0/task.json b/Tasks/GitHubReleaseV0/task.json index 8c7f8ab7b45a..3811b03a85ab 100644 --- a/Tasks/GitHubReleaseV0/task.json +++ b/Tasks/GitHubReleaseV0/task.json @@ -15,7 +15,7 @@ "version": { "Major": 0, "Minor": 150, - "Patch": 1 + "Patch": 2 }, "demands": [], "minimumAgentVersion": "2.0.0", diff --git a/Tasks/GradleV2/task.json b/Tasks/GradleV2/task.json index 733e400d1081..a42f4d2c49a6 100644 --- a/Tasks/GradleV2/task.json +++ b/Tasks/GradleV2/task.json @@ -17,7 +17,7 @@ "version": { "Major": 2, "Minor": 149, - "Patch": 2 + "Patch": 3 }, "releaseNotes": "Configuration of the SonarQube analysis was moved to the [SonarQube](https://marketplace.visualstudio.com/items?itemName=SonarSource.sonarqube) or [SonarCloud](https://marketplace.visualstudio.com/items?itemName=SonarSource.sonarcloud) extensions, in task `Prepare Analysis Configuration`", "demands": [ diff --git a/Tasks/HelmDeployV0/task.json b/Tasks/HelmDeployV0/task.json index 7249e46824ab..6cd5c8dfbde3 100644 --- a/Tasks/HelmDeployV0/task.json +++ b/Tasks/HelmDeployV0/task.json @@ -14,7 +14,7 @@ "version": { "Major": 0, "Minor": 150, - "Patch": 2 + "Patch": 3 }, "demands": [], "groups": [ diff --git a/Tasks/HelmInstallerV0/task.json b/Tasks/HelmInstallerV0/task.json index 2dd0afe8294e..bbfbca1aa503 100644 --- a/Tasks/HelmInstallerV0/task.json +++ b/Tasks/HelmInstallerV0/task.json @@ -14,7 +14,7 @@ "version": { "Major": 0, "Minor": 150, - "Patch": 0 + "Patch": 1 }, "demands": [], "satisfies": [ diff --git a/Tasks/KubernetesManifestV0/Strings/resources.resjson/en-US/resources.resjson b/Tasks/KubernetesManifestV0/Strings/resources.resjson/en-US/resources.resjson index 8974e9f94542..1b7664d49b29 100644 --- a/Tasks/KubernetesManifestV0/Strings/resources.resjson/en-US/resources.resjson +++ b/Tasks/KubernetesManifestV0/Strings/resources.resjson/en-US/resources.resjson @@ -1,25 +1,25 @@ { - "loc.friendlyName": "Manifest based Kubernetes deployments", + "loc.friendlyName": "Kubernetes manifests", "loc.helpMarkDown": "[More Information](https://go.microsoft.com/fwlink/?linkid=851275)", - "loc.description": "Manifest based deployments to kubernetes", + "loc.description": "Manifest based deployments to Kubernetes", "loc.instanceNameFormat": "$(action)", "loc.group.displayName.config": "Config", "loc.group.displayName.kubernetesCluster": "Kubernetes Cluster", - "loc.input.label.connectionType": "Service connection type", - "loc.input.help.connectionType": "Select a service connection type.", - "loc.input.label.kubernetesServiceEndpoint": "Kubernetes service connection", - "loc.input.help.kubernetesServiceEndpoint": "Select a Kubernetes service connection.", + "loc.input.label.kubernetesServiceConnection": "Kubernetes service connection", + "loc.input.help.kubernetesServiceConnection": "Select a Kubernetes service connection.", "loc.input.label.namespace": "Namespace", "loc.input.help.namespace": "Sets the namespace for the commands by using the –namespace flag. If the namespace is not provided, the commands will run in the default namespace.", "loc.input.label.action": "Action", "loc.input.help.action": "Choose the action to be performed.", - "loc.input.label.deploymentStrategy": "Strategy", - "loc.input.help.deploymentStrategy": "Strategy for deployment", + "loc.input.label.strategy": "Strategy", + "loc.input.help.strategy": "Deployment strategy to be used", "loc.input.label.percentage": "Percentage", "loc.input.label.manifests": "Manifests", "loc.input.help.manifests": "Manifests to deploy", "loc.input.label.containers": "Containers", "loc.input.help.containers": "Containers", + "loc.input.label.imagePullSecrets": "ImagePullSecrets", + "loc.input.help.imagePullSecrets": "ImagePullSecret to pull image from private registry", "loc.input.label.renderType": "Render Engine", "loc.input.help.renderType": "Tool to generate manifest", "loc.input.label.helmChart": "Helm Chart", @@ -40,10 +40,18 @@ "loc.input.help.replicas": "Number of replicas to scale to", "loc.input.label.mergeStrategy": "Merge Strategy", "loc.input.help.mergeStrategy": "The type of patch being provided; one of [json merge strategic]", - "loc.input.label.args": "Arguments", - "loc.input.help.args": "Arguments for `kubectl delete` command", + "loc.input.label.arguments": "Arguments", + "loc.input.help.arguments": "Arguments for `kubectl delete` command", "loc.input.label.patch": "Patch", "loc.input.help.patch": "Contents of patch", + "loc.input.label.secretType": "Type of secret", + "loc.input.help.secretType": "Create/update a generic or docker imagepullsecret. Select dockerRegistry to create/update the imagepullsecret of the selected registry. An imagePullSecret is a way to pass a secret that contains a container registry password to the Kubelet so it can pull a private image on behalf of your Pod.", + "loc.input.label.secretName": "Secret name", + "loc.input.help.secretName": "Name of the secret. You can use this secret name in the Kubernetes YAML configuration file.", + "loc.input.label.secretArguments": "Arguments", + "loc.input.help.secretArguments": "Specify keys and literal values to insert in secret.For example, --from-literal=key1=value1 --from-literal=key2=\"top secret\".", + "loc.input.label.dockerRegistryEndpoint": "Docker registry service connection", + "loc.input.help.dockerRegistryEndpoint": "Select a Docker registry service connection. Required for commands that need to authenticate with a registry.", "loc.messages.DownloadPathForStableTxt": "Download path for stable.txt: %s", "loc.messages.DownloadKubeCtlFailed": "Can not download the kubectl client of version %s. Check if the version is correct https://github.com/kubernetes/kubernetes/releases", "loc.messages.DownloadStableVersionFailed": "Can not download kubernetes stable version file from %s. Falling back to %s", @@ -54,6 +62,9 @@ "loc.messages.UnknownRenderType": "Unknown render engine", "loc.messages.ResourceKindNotDefined": "Resource kind is null", "loc.messages.NullInputObject": "Input object is null.", + "loc.messages.ArgumentsInputNotSupplied": "Arguments are not supplied.", "loc.messages.NullInputObjectMetadata": "Input object metadata is null.", - "loc.messages.CanaryDeploymentAlreadyExistErrorMessage": "Canary deployment already exists. Rejecting this deployment" + "loc.messages.CanaryDeploymentAlreadyExistErrorMessage": "Canary deployment already exists. Rejecting this deployment.", + "loc.messages.InvalidRejectActionDeploymentStrategy": "Reject action works only with strategy: canary", + "loc.messages.InvalidPromotetActionDeploymentStrategy": "Promote action works only with strategy: canary" } \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/Tests/L0.ts b/Tasks/KubernetesManifestV0/Tests/L0.ts new file mode 100644 index 000000000000..58b2d5f0888d --- /dev/null +++ b/Tasks/KubernetesManifestV0/Tests/L0.ts @@ -0,0 +1,131 @@ +import * as path from 'path'; +import * as assert from 'assert'; +import * as ttm from 'vsts-task-lib/mock-test'; +import tl = require('vsts-task-lib'); +import * as shared from './TestShared'; + +describe('Kubernetes Manifests Suite', function () { + this.timeout(30000); + before((done) => { + process.env[shared.TestEnvVars.operatingSystem] = tl.osType().match(/^Win/) ? shared.OperatingSystems.Windows : shared.OperatingSystems.Other; + process.env[shared.TestEnvVars.isKubectlPresentOnMachine] = "true"; + process.env[shared.TestEnvVars.manifests] = shared.ManifestFilesPath; + done(); + }); + beforeEach(() => { + delete process.env[shared.TestEnvVars.action]; + delete process.env[shared.TestEnvVars.strategy]; + delete process.env[shared.TestEnvVars.percentage]; + delete process.env[shared.TestEnvVars.isStableDeploymentPresent]; + delete process.env[shared.TestEnvVars.isCanaryDeploymentPresent]; + delete process.env[shared.TestEnvVars.isBaselineDeploymentPresent]; + delete process.env[shared.TestEnvVars.arguments]; + }); + after(function () { + }); + + it('Run successfuly for deploy with none strategy', (done: MochaDone) => { + let tp = path.join(__dirname, 'TestSetup.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + process.env[shared.TestEnvVars.action] = shared.Actions.deploy; + process.env[shared.TestEnvVars.strategy] = shared.Strategy.none; + process.env[shared.TestEnvVars.imagePullSecrets] = "test-key1\ntest-key2"; + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + console.log(tr.stdout); + done(); + }); + it('Run successfully for deploy canary', (done: MochaDone) => { + let tp = path.join(__dirname, 'TestSetup.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + process.env[shared.TestEnvVars.action] = shared.Actions.deploy; + process.env[shared.TestEnvVars.strategy] = shared.Strategy.canary; + process.env[shared.TestEnvVars.percentage] = "30"; + process.env[shared.TestEnvVars.isStableDeploymentPresent] = "true"; + process.env[shared.TestEnvVars.isCanaryDeploymentPresent] = "false"; + process.env[shared.TestEnvVars.isBaselineDeploymentPresent] = "false"; + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + assert(tr.stderr.indexOf("\"nginx-deployment-canary\" not found") != -1, "Canary deployment is not present"); + assert(tr.stdout.indexOf("nginx-deployment-canary created") != -1, "Canary deployment is created"); + assert(tr.stdout.indexOf("nginx-deployment-baseline created") != -1, "Baseline deployment is created"); + assert(tr.stdout.indexOf("deployment \"nginx-deployment-canary\" successfully rolled out") != -1, "Canary deployment is successfully rolled out"); + assert(tr.stdout.indexOf("deployment \"nginx-deployment-baseline\" successfully rolled out") != -1, "Baseline deployment is successfully rolled out"); + assert(tr.stdout.indexOf("nginx-deployment-canary annotated") != -1, "Canary deployment is annotated"); + assert(tr.stdout.indexOf("nginx-deployment-baseline annotated") != -1, "Baseline deployment is annotated"); + done(); + }); + it('Run should fail when canary deployment already exits', (done: MochaDone) => { + let tp = path.join(__dirname, 'TestSetup.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + process.env[shared.TestEnvVars.action] = shared.Actions.deploy; + process.env[shared.TestEnvVars.strategy] = shared.Strategy.canary; + process.env[shared.TestEnvVars.percentage] = "30"; + process.env[shared.TestEnvVars.isStableDeploymentPresent] = "true"; + process.env[shared.TestEnvVars.isCanaryDeploymentPresent] = "true"; + process.env[shared.TestEnvVars.isBaselineDeploymentPresent] = "true"; + tr.run(); + assert(tr.failed, 'task should have failed'); + done(); + }); + it('Run should fail for promote with none strategy', (done: MochaDone) => { + let tp = path.join(__dirname, 'TestSetup.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + process.env[shared.TestEnvVars.action] = shared.Actions.promote; + process.env[shared.TestEnvVars.strategy] = shared.Strategy.none; + process.env[shared.TestEnvVars.imagePullSecrets] = "test-key"; + tr.run(); + assert(tr.failed, 'task should have failed'); + done(); + }); + it('Run successfuly for promote with canary strategy', (done: MochaDone) => { + let tp = path.join(__dirname, 'TestSetup.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + process.env[shared.TestEnvVars.action] = shared.Actions.promote; + process.env[shared.TestEnvVars.strategy] = shared.Strategy.canary; + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + assert(tr.stdout.indexOf("nginx-deployment created") != -1, "deployment is created"); + assert(tr.stdout.indexOf("deployment \"nginx-deployment\" successfully rolled out") != -1, "deployment is successfully rolled out"); + assert(tr.stdout.indexOf("nginx-deployment annotated") != -1, "nginx-deployment created."); + assert(tr.stdout.indexOf("\"nginx-deployment-canary\" deleted. \"nginx-deployment-baseline\" deleted") != -1, "Baseline and canary workloads are deleted"); + done(); + }); + it('Run successfuly for reject with canary strategy', (done: MochaDone) => { + let tp = path.join(__dirname, 'TestSetup.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + process.env[shared.TestEnvVars.action] = shared.Actions.reject; + process.env[shared.TestEnvVars.strategy] = shared.Strategy.canary; + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + assert(tr.stdout.indexOf("\"nginx-deployment-canary\" deleted. \"nginx-deployment-baseline\" deleted") != -1, "Baseline and canary workloads are deleted"); + done(); + }); + it('Run should fail for reject with none strategy', (done: MochaDone) => { + let tp = path.join(__dirname, 'TestSetup.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + process.env[shared.TestEnvVars.action] = shared.Actions.reject; + process.env[shared.TestEnvVars.strategy] = shared.Strategy.none; + tr.run(); + assert(tr.failed, 'task should have failed'); + done(); + }); + it('Run successfuly for delete with arguments', (done: MochaDone) => { + let tp = path.join(__dirname, 'TestSetup.js'); + process.env[shared.TestEnvVars.arguments] = "deployment nginx-deployment" + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + process.env[shared.TestEnvVars.action] = shared.Actions.delete; + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + assert(tr.stdout.indexOf("deleted successfuly") != -1, "Deleted successfuly"); + done(); + }); + it('Run should fail for delete with no arguments', (done: MochaDone) => { + let tp = path.join(__dirname, 'TestSetup.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + process.env[shared.TestEnvVars.action] = shared.Actions.delete; + tr.run(); + assert(tr.failed, 'task should have failed'); + done(); + }); +}); \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/Tests/TestSetup.ts b/Tasks/KubernetesManifestV0/Tests/TestSetup.ts new file mode 100644 index 000000000000..aa90ea579ab0 --- /dev/null +++ b/Tasks/KubernetesManifestV0/Tests/TestSetup.ts @@ -0,0 +1,241 @@ +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import * as shared from './TestShared'; + +const BuildNumber = "1"; +const BuildId = "1"; +const TeamProject = "project1"; +const CollectionId = "collection1"; +const DefinitionName = "test"; +const DefinitionId = "123"; +const TeamFoundationCollectionUri = "https://abc.visualstudio.com/"; +const JobName = "jobName"; + +const DefaultWorkingDirectory: string = shared.formatPath("a/w"); +const KubectlPath = shared.formatPath("newUserDir/kubectl.exe"); + +let taskPath = path.join(__dirname, '../src', 'run.js'); +let tr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tr.setInput('kubernetesServiceConnection', 'kubernetesConnection'); +tr.setInput('namespace', process.env[shared.TestEnvVars.namespace] || 'default'); +tr.setInput('action', process.env[shared.TestEnvVars.action] || 'deploy'); +tr.setInput('strategy', process.env[shared.TestEnvVars.strategy] || 'None'); +tr.setInput('percentage', process.env[shared.TestEnvVars.percentage] || ''); +tr.setInput('manifests', process.env[shared.TestEnvVars.manifests] || shared.ManifestFilesPath); +tr.setInput('containers', process.env[shared.TestEnvVars.containers] || ''); +tr.setInput('imagePullSecrets', process.env[shared.TestEnvVars.imagePullSecrets] || ''); +tr.setInput('renderType', process.env[shared.TestEnvVars.renderType] || ''); +tr.setInput('helmChart', process.env[shared.TestEnvVars.helmChart] || ''); +tr.setInput('overrideFiles', process.env[shared.TestEnvVars.overrideFiles] || ''); +tr.setInput('overrides', process.env[shared.TestEnvVars.overrides] || ''); +tr.setInput('resourceToPatch', process.env[shared.TestEnvVars.resourceToPatch] || ''); +tr.setInput('resourceFileToPatch', process.env[shared.TestEnvVars.resourceFileToPatch] || ''); +tr.setInput('kind', process.env[shared.TestEnvVars.kind] || ''); +tr.setInput('name', process.env[shared.TestEnvVars.name] || ''); +tr.setInput('replicas', process.env[shared.TestEnvVars.replicas] || ''); +tr.setInput('mergeStrategy', process.env[shared.TestEnvVars.mergeStrategy] || ''); +tr.setInput('arguments', process.env[shared.TestEnvVars.arguments] || ''); +tr.setInput('patch', process.env[shared.TestEnvVars.patch] || ''); + +process.env["SYSTEM_DEFAULTWORKINGDIRECTORY"] = DefaultWorkingDirectory; +process.env["SYSTEM_TEAMFOUNDATIONCOLLECTIONURI"] = TeamFoundationCollectionUri; +process.env["SYSTEM_TEAMPROJECT"] = TeamProject; +process.env["SYSTEM_COLLECTIONID"] = CollectionId; +process.env["SYSTEM_DEFINITIONID"] = DefinitionId; + +process.env["BUILD_BUILDID"] = BuildId; +process.env["BUILD_BUILDNUMBER"] = BuildNumber; +process.env["BUILD_DEFINITIONNAME"] = DefinitionName; + +process.env["AGENT_JOBNAME"] = JobName; +process.env["TF_BUILD"] = "True"; + +process.env[shared.TestEnvVars.manifests] = process.env[shared.TestEnvVars.manifests] || shared.ManifestFilesPath; +process.env["ENDPOINT_DATA_kubernetesConnection_AUTHORIZATIONTYPE"] = process.env[shared.TestEnvVars.endpointAuthorizationType] || shared.AuthorizationType.Kubeconfig; +process.env["ENDPOINT_AUTH_PARAMETER_kubernetesConnection_KUBECONFIG"] = "{\"apiVersion\":\"v1\", \"clusters\": [{\"cluster\": {\"insecure-skip-tls-verify\":\"true\", \"server\":\"https://5.6.7.8\", \"name\" : \"scratch\"}}], \"contexts\": [{\"context\" : {\"cluster\": \"scratch\", \"namespace\" : \"default\", \"user\": \"experimenter\", \"name\" : \"exp-scratch\"}], \"current-context\" : \"exp-scratch\", \"kind\": \"Config\", \"users\" : [{\"user\": {\"password\": \"regpassword\", \"username\" : \"test\"}]}"; + +let a: ma.TaskLibAnswers = { + "checkPath": {}, + "exec": {}, + "findMatch": {}, + "which": {} +}; + +if (process.env[shared.TestEnvVars.isKubectlPresentOnMachine] && JSON.parse(process.env[shared.TestEnvVars.isKubectlPresentOnMachine])) { + a.which["kubectl"] = KubectlPath; +} + +a.checkPath[KubectlPath] = true; +a.findMatch[process.env[shared.TestEnvVars.manifests]] = [process.env[shared.TestEnvVars.manifests]]; + +if (process.env[shared.TestEnvVars.isStableDeploymentPresent] && JSON.parse(process.env[shared.TestEnvVars.isStableDeploymentPresent])) { + a.exec[`${KubectlPath} get Deployment/nginx-deployment --namespace default -o json`] = { + "code": 0, + "stdout": "{\"apiVersion\": \"extensions\/v1beta1\",\r\n \"kind\": \"Deployment\",\r\n \"metadata\": {\r\n \"annotations\": {\r\n \"azure-pipelines\/execution\": \"11937a13\",\r\n \"azure-pipelines\/executionuri\": \"http:\/\/nishu-65\/DefaultCollection\/_build\/results?buildId=11937a13b667c4bc609ac98dde4c4d10cbd1f499\",\r\n \"azure-pipelines\/org\": \"51050983-0664-4716-9ac7-6b6e6ea7e5e8\",\r\n \"azure-pipelines\/pipeline\": \"\\\"project1\\\"\",\r\n \"azure-pipelines\/project\": \"project1\",\r\n \"deployment.kubernetes.io\/revision\": \"1\",\r\n \"kubectl.kubernetes.io\/last-applied-configuration\": \"{\\\"apiVersion\\\":\\\"apps\/v1\\\",\\\"kind\\\":\\\"Deployment\\\",\\\"metadata\\\":{\\\"annotations\\\":{},\\\"labels\\\":{\\\"app\\\":\\\"nginx\\\"},\\\"name\\\":\\\"nginx-deployment\\\",\\\"namespace\\\":\\\"default\\\"},\\\"spec\\\":{\\\"replicas\\\":3,\\\"selector\\\":{\\\"matchLabels\\\":{\\\"app\\\":\\\"nginx\\\"}},\\\"template\\\":{\\\"metadata\\\":{\\\"labels\\\":{\\\"app\\\":\\\"nginx\\\"}},\\\"spec\\\":{\\\"containers\\\":[{\\\"image\\\":\\\"nginx:1.7.9\\\",\\\"name\\\":\\\"nginx\\\",\\\"ports\\\":[{\\\"containerPort\\\":80}]}]}}}}\\n\"\r\n },\r\n \"creationTimestamp\": \"2019-03-22T13:10:38Z\",\r\n \"generation\": 2,\r\n \"labels\": {\r\n \"app\": \"nginx\"\r\n },\r\n \"name\": \"nginx-deployment\",\r\n \"namespace\": \"default\",\r\n \"resourceVersion\": \"125935\",\r\n \"selfLink\": \"\/apis\/extensions\/v1beta1\/namespaces\/default\/deployments\/nginx-deployment\",\r\n \"uid\": \"e2e3e6c2-4ca3-11e9-bdff-2a073485f16f\"\r\n },\r\n \"spec\": {\r\n \"progressDeadlineSeconds\": 600,\r\n \"replicas\": 3,\r\n \"revisionHistoryLimit\": 10,\r\n \"selector\": {\r\n \"matchLabels\": {\r\n \"app\": \"nginx\"\r\n }\r\n },\r\n \"strategy\": {\r\n \"rollingUpdate\": {\r\n \"maxSurge\": \"25%\",\r\n \"maxUnavailable\": \"25%\"\r\n },\r\n \"type\": \"RollingUpdate\"\r\n },\r\n \"template\": {\r\n \"metadata\": {\r\n \"creationTimestamp\": null,\r\n \"labels\": {\r\n \"app\": \"nginx\"\r\n }\r\n },\r\n \"spec\": {\r\n \"containers\": [\r\n {\r\n \"image\": \"nginx:1.7.9\",\r\n \"imagePullPolicy\": \"IfNotPresent\",\r\n \"name\": \"nginx\",\r\n \"ports\": [\r\n {\r\n \"containerPort\": 80,\r\n \"protocol\": \"TCP\"\r\n }\r\n ],\r\n \"resources\": {},\r\n \"terminationMessagePath\": \"\/dev\/termination-log\",\r\n \"terminationMessagePolicy\": \"File\"\r\n }\r\n ],\r\n \"dnsPolicy\": \"ClusterFirst\",\r\n \"restartPolicy\": \"Always\",\r\n \"schedulerName\": \"default-scheduler\",\r\n \"securityContext\": {},\r\n \"terminationGracePeriodSeconds\": 30\r\n }\r\n }\r\n },\r\n \"status\": {\r\n \"availableReplicas\": 3,\r\n \"conditions\": [\r\n {\r\n \"lastTransitionTime\": \"2019-03-22T13:10:38Z\",\r\n \"lastUpdateTime\": \"2019-03-22T13:10:55Z\",\r\n \"message\": \"ReplicaSet \\\"nginx-deployment-5c689d88bb\\\" has successfully progressed.\",\r\n \"reason\": \"NewReplicaSetAvailable\",\r\n \"status\": \"True\",\r\n \"type\": \"Progressing\"\r\n },\r\n {\r\n \"lastTransitionTime\": \"2019-03-23T01:31:12Z\",\r\n \"lastUpdateTime\": \"2019-03-23T01:31:12Z\",\r\n \"message\": \"Deployment has minimum availability.\",\r\n \"reason\": \"MinimumReplicasAvailable\",\r\n \"status\": \"True\",\r\n \"type\": \"Available\"\r\n }\r\n ],\r\n \"observedGeneration\": 2,\r\n \"readyReplicas\": 3,\r\n \"replicas\": 3,\r\n \"updatedReplicas\": 3\r\n }\r\n}\r\n" + }; +} +else { + a.exec[`${KubectlPath} get Deployment/nginx-deployment --namespace default -o json`] = { + "code": 1, + "stderr": "Error from server (NotFound): deployments.extensions \"nginx-deployment\" not found" + }; +} + +if (process.env[shared.TestEnvVars.isCanaryDeploymentPresent] && JSON.parse(process.env[shared.TestEnvVars.isCanaryDeploymentPresent])) { + a.exec[`${KubectlPath} get Deployment/nginx-deployment-canary --namespace default -o json`] = { + "code": 0, + "stdout": "{\r\n \"apiVersion\": \"extensions/v1beta1\",\r\n \"kind\": \"Deployment\",\r\n \"metadata\": {\r\n \"annotations\": {\r\n \"azure-pipelines/execution\": \"11937a13\",\r\n \"azure-pipelines/executionuri\": \"http://nishu-65/DefaultCollection/_build/results?buildId=11937a13b667c4bc609ac98dde4c4d10cbd1f499\",\r\n \"azure-pipelines/org\": \"51050983-0664-4716-9ac7-6b6e6ea7e5e8\",\r\n \"azure-pipelines/pipeline\": \"\\\"project1\\\"\",\r\n \"azure-pipelines/project\": \"project1\",\r\n \"azure-pipelines/version\": \"canary\",\r\n \"deployment.kubernetes.io/revision\": \"1\",\r\n \"kubectl.kubernetes.io/last-applied-configuration\": \"{\\\"apiVersion\\\":\\\"apps/v1\\\",\\\"kind\\\":\\\"Deployment\\\",\\\"metadata\\\":{\\\"annotations\\\":{\\\"azure-pipelines/version\\\":\\\"canary\\\"},\\\"labels\\\":{\\\"app\\\":\\\"nginx\\\",\\\"azure-pipelines/version\\\":\\\"canary\\\"},\\\"name\\\":\\\"nginx-deployment-canary\\\",\\\"namespace\\\":\\\"default\\\"},\\\"spec\\\":{\\\"replicas\\\":1,\\\"selector\\\":{\\\"matchLabels\\\":{\\\"app\\\":\\\"nginx\\\",\\\"azure-pipelines/version\\\":\\\"canary\\\"}},\\\"template\\\":{\\\"metadata\\\":{\\\"labels\\\":{\\\"app\\\":\\\"nginx\\\",\\\"azure-pipelines/version\\\":\\\"canary\\\"}},\\\"spec\\\":{\\\"containers\\\":[{\\\"image\\\":\\\"nginx:1.7.9\\\",\\\"name\\\":\\\"nginx\\\",\\\"ports\\\":[{\\\"containerPort\\\":80}]}]}}}}\\n\"\r\n },\r\n \"creationTimestamp\": \"2019-03-28T08:36:36Z\",\r\n \"generation\": 2,\r\n \"labels\": {\r\n \"app\": \"nginx\",\r\n \"azure-pipelines/version\": \"canary\"\r\n },\r\n \"name\": \"nginx-deployment-canary\",\r\n \"namespace\": \"default\",\r\n \"resourceVersion\": \"911614\",\r\n \"selfLink\": \"/apis/extensions/v1beta1/namespaces/default/deployments/nginx-deployment-canary\",\r\n \"uid\": \"9949c869-5134-11e9-8617-8a66bb81ec3a\"\r\n },\r\n \"spec\": {\r\n \"progressDeadlineSeconds\": 600,\r\n \"replicas\": 1,\r\n \"revisionHistoryLimit\": 10,\r\n \"selector\": {\r\n \"matchLabels\": {\r\n \"app\": \"nginx\",\r\n \"azure-pipelines/version\": \"canary\"\r\n }\r\n },\r\n \"strategy\": {\r\n \"rollingUpdate\": {\r\n \"maxSurge\": \"25%\",\r\n \"maxUnavailable\": \"25%\"\r\n },\r\n \"type\": \"RollingUpdate\"\r\n },\r\n \"template\": {\r\n \"metadata\": {\r\n \"creationTimestamp\": null,\r\n \"labels\": {\r\n \"app\": \"nginx\",\r\n \"azure-pipelines/version\": \"canary\"\r\n }\r\n },\r\n \"spec\": {\r\n \"containers\": [\r\n {\r\n \"image\": \"nginx:1.7.9\",\r\n \"imagePullPolicy\": \"IfNotPresent\",\r\n \"name\": \"nginx\",\r\n \"ports\": [\r\n {\r\n \"containerPort\": 80,\r\n \"protocol\": \"TCP\"\r\n }\r\n ],\r\n \"resources\": {},\r\n \"terminationMessagePath\": \"/dev/termination-log\",\r\n \"terminationMessagePolicy\": \"File\"\r\n }\r\n ],\r\n \"dnsPolicy\": \"ClusterFirst\",\r\n \"restartPolicy\": \"Always\",\r\n \"schedulerName\": \"default-scheduler\",\r\n \"securityContext\": {},\r\n \"terminationGracePeriodSeconds\": 30\r\n }\r\n }\r\n },\r\n \"status\": {\r\n \"availableReplicas\": 1,\r\n \"conditions\": [\r\n {\r\n \"lastTransitionTime\": \"2019-03-28T08:36:40Z\",\r\n \"lastUpdateTime\": \"2019-03-28T08:36:40Z\",\r\n \"message\": \"Deployment has minimum availability.\",\r\n \"reason\": \"MinimumReplicasAvailable\",\r\n \"status\": \"True\",\r\n \"type\": \"Available\"\r\n },\r\n {\r\n \"lastTransitionTime\": \"2019-03-28T08:36:36Z\",\r\n \"lastUpdateTime\": \"2019-03-28T08:36:40Z\",\r\n \"message\": \"ReplicaSet \\\"nginx-deployment-canary-6b967f76d6\\\" has successfully progressed.\",\r\n \"reason\": \"NewReplicaSetAvailable\",\r\n \"status\": \"True\",\r\n \"type\": \"Progressing\"\r\n }\r\n ],\r\n \"observedGeneration\": 2,\r\n \"readyReplicas\": 1,\r\n \"replicas\": 1,\r\n \"updatedReplicas\": 1\r\n }\r\n}" + }; +} +else { + a.exec[`${KubectlPath} get Deployment/nginx-deployment-canary --namespace default -o json`] = { + "code": 1, + "stderr": "Error from server (NotFound): deployments.extensions \"nginx-deployment-canary\" not found" + }; +} + +if (process.env[shared.TestEnvVars.isBaselineDeploymentPresent] && JSON.parse(process.env[shared.TestEnvVars.isBaselineDeploymentPresent])) { + a.exec[`${KubectlPath} get Deployment/nginx-deployment-baseline --namespace default -o json`] = { + "code": 0, + "stdout": "{\r\n \"apiVersion\": \"extensions/v1beta1\",\r\n \"kind\": \"Deployment\",\r\n \"metadata\": {\r\n \"annotations\": {\r\n \"azure-pipelines/execution\": \"11937a13\",\r\n \"azure-pipelines/executionuri\": \"http://nishu-65/DefaultCollection/_build/results?buildId=11937a13b667c4bc609ac98dde4c4d10cbd1f499\",\r\n \"azure-pipelines/org\": \"51050983-0664-4716-9ac7-6b6e6ea7e5e8\",\r\n \"azure-pipelines/pipeline\": \"\\\"project1\\\"\",\r\n \"azure-pipelines/project\": \"project1\",\r\n \"azure-pipelines/version\": \"baseline\",\r\n \"deployment.kubernetes.io/revision\": \"1\",\r\n \"kubectl.kubernetes.io/last-applied-configuration\": \"{\\\"apiVersion\\\":\\\"apps/v1\\\",\\\"kind\\\":\\\"Deployment\\\",\\\"metadata\\\":{\\\"annotations\\\":{\\\"azure-pipelines/version\\\":\\\"baseline\\\"},\\\"labels\\\":{\\\"app\\\":\\\"nginx\\\",\\\"azure-pipelines/version\\\":\\\"baseline\\\"},\\\"name\\\":\\\"nginx-deployment-baseline\\\",\\\"namespace\\\":\\\"default\\\"},\\\"spec\\\":{\\\"replicas\\\":1,\\\"selector\\\":{\\\"matchLabels\\\":{\\\"app\\\":\\\"nginx\\\",\\\"azure-pipelines/version\\\":\\\"baseline\\\"}},\\\"template\\\":{\\\"metadata\\\":{\\\"labels\\\":{\\\"app\\\":\\\"nginx\\\",\\\"azure-pipelines/version\\\":\\\"baseline\\\"}},\\\"spec\\\":{\\\"containers\\\":[{\\\"image\\\":\\\"nginx:1.7.9\\\",\\\"name\\\":\\\"nginx\\\",\\\"ports\\\":[{\\\"containerPort\\\":80}]}]}}}}\\n\"\r\n },\r\n \"creationTimestamp\": \"2019-03-28T08:36:36Z\",\r\n \"generation\": 2,\r\n \"labels\": {\r\n \"app\": \"nginx\",\r\n \"azure-pipelines/version\": \"baseline\"\r\n },\r\n \"name\": \"nginx-deployment-baseline\",\r\n \"namespace\": \"default\",\r\n \"resourceVersion\": \"911614\",\r\n \"selfLink\": \"/apis/extensions/v1beta1/namespaces/default/deployments/nginx-deployment-baseline\",\r\n \"uid\": \"9949c869-5134-11e9-8617-8a66bb81ec3a\"\r\n },\r\n \"spec\": {\r\n \"progressDeadlineSeconds\": 600,\r\n \"replicas\": 1,\r\n \"revisionHistoryLimit\": 10,\r\n \"selector\": {\r\n \"matchLabels\": {\r\n \"app\": \"nginx\",\r\n \"azure-pipelines/version\": \"baseline\"\r\n }\r\n },\r\n \"strategy\": {\r\n \"rollingUpdate\": {\r\n \"maxSurge\": \"25%\",\r\n \"maxUnavailable\": \"25%\"\r\n },\r\n \"type\": \"RollingUpdate\"\r\n },\r\n \"template\": {\r\n \"metadata\": {\r\n \"creationTimestamp\": null,\r\n \"labels\": {\r\n \"app\": \"nginx\",\r\n \"azure-pipelines/version\": \"baseline\"\r\n }\r\n },\r\n \"spec\": {\r\n \"containers\": [\r\n {\r\n \"image\": \"nginx:1.7.9\",\r\n \"imagePullPolicy\": \"IfNotPresent\",\r\n \"name\": \"nginx\",\r\n \"ports\": [\r\n {\r\n \"containerPort\": 80,\r\n \"protocol\": \"TCP\"\r\n }\r\n ],\r\n \"resources\": {},\r\n \"terminationMessagePath\": \"/dev/termination-log\",\r\n \"terminationMessagePolicy\": \"File\"\r\n }\r\n ],\r\n \"dnsPolicy\": \"ClusterFirst\",\r\n \"restartPolicy\": \"Always\",\r\n \"schedulerName\": \"default-scheduler\",\r\n \"securityContext\": {},\r\n \"terminationGracePeriodSeconds\": 30\r\n }\r\n }\r\n },\r\n \"status\": {\r\n \"availableReplicas\": 1,\r\n \"conditions\": [\r\n {\r\n \"lastTransitionTime\": \"2019-03-28T08:36:40Z\",\r\n \"lastUpdateTime\": \"2019-03-28T08:36:40Z\",\r\n \"message\": \"Deployment has minimum availability.\",\r\n \"reason\": \"MinimumReplicasAvailable\",\r\n \"status\": \"True\",\r\n \"type\": \"Available\"\r\n },\r\n {\r\n \"lastTransitionTime\": \"2019-03-28T08:36:36Z\",\r\n \"lastUpdateTime\": \"2019-03-28T08:36:40Z\",\r\n \"message\": \"ReplicaSet \\\"nginx-deployment-baseline-6b967f76d6\\\" has successfully progressed.\",\r\n \"reason\": \"NewReplicaSetAvailable\",\r\n \"status\": \"True\",\r\n \"type\": \"Progressing\"\r\n }\r\n ],\r\n \"observedGeneration\": 2,\r\n \"readyReplicas\": 1,\r\n \"replicas\": 1,\r\n \"updatedReplicas\": 1\r\n }\r\n}" + }; +} +else { + a.exec[`${KubectlPath} get Deployment/nginx-deployment-baseline --namespace default -o json`] = { + "code": 1, + "stderr": "Error from server (NotFound): deployments.extensions nginx-deployment-baseline not found" + }; +} + +a.exec[`${KubectlPath} apply -f ${process.env[shared.TestEnvVars.manifests]} --namespace default`] = { + "code": 0, + "stdout": "deployment.apps/nginx-deployment created." +}; + +a.exec[`${KubectlPath} apply -f ${shared.CanaryManifestFilesPath},${shared.BaselineManifestFilesPath} --namespace default`] = { + "code": 0, + "stdout": "deployment.apps/nginx-deployment-canary created. deployment.extensions/nginx-deployment-baseline created " +}; + +a.exec[`${KubectlPath} rollout status Deployment/nginx-deployment --namespace default`] = { + "code": 0, + "stdout": "deployment \"nginx-deployment\" successfully rolled out" +}; + +a.exec[`${KubectlPath} rollout status Deployment/nginx-deployment-canary --namespace default`] = { + "code": 0, + "stdout": "deployment \"nginx-deployment-canary\" successfully rolled out" +}; + +a.exec[`${KubectlPath} rollout status Deployment/nginx-deployment-baseline --namespace default`] = { + "code": 0, + "stdout": "deployment \"nginx-deployment-baseline\" successfully rolled out" +}; + +a.exec[`${KubectlPath} get pods --namespace default -o json`] = { + "code": 0, + "stdout": "{\r\n \"apiVersion\": \"v1\",\r\n \"kind\": \"List\",\r\n \"metadata\": {\r\n \"resourceVersion\": \"\",\r\n \"selfLink\": \"\"\r\n },\r\n \"items\": [\r\n {\r\n \"apiVersion\": \"v1\",\r\n \"kind\": \"Pod\",\r\n \"metadata\": {\r\n \"creationTimestamp\": \"2019-03-22T13:10:38Z\",\r\n \"generateName\": \"nginx-deployment-5c689d88bb-\",\r\n \"labels\": {\r\n \"app\": \"nginx\",\r\n \"pod-template-hash\": \"5c689d88bb\"\r\n },\r\n \"name\": \"nginx-deployment-5c689d88bb-btlgf\",\r\n \"namespace\": \"default\",\r\n \"ownerReferences\": [\r\n {\r\n \"apiVersion\": \"apps\/v1\",\r\n \"blockOwnerDeletion\": true,\r\n \"controller\": true,\r\n \"kind\": \"ReplicaSet\",\r\n \"name\": \"nginx-deployment-5c689d88bb\",\r\n \"uid\": \"e2e6b9b8-4ca3-11e9-bdff-2a073485f16f\"\r\n }\r\n ],\r\n \"resourceVersion\": \"49418\",\r\n \"selfLink\": \"\/api\/v1\/namespaces\/default\/pods\/nginx-deployment-5c689d88bb-btlgf\",\r\n \"uid\": \"e2f4690c-4ca3-11e9-bdff-2a073485f16f\"\r\n },\r\n \"spec\": {\r\n \"containers\": [\r\n {\r\n \"env\": [\r\n {\r\n \"name\": \"KUBERNETES_PORT_443_TCP_ADDR\",\r\n \"value\": \"desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io\"\r\n },\r\n {\r\n \"name\": \"KUBERNETES_PORT\",\r\n \"value\": \"tcp:\/\/desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io:443\"\r\n },\r\n {\r\n \"name\": \"KUBERNETES_PORT_443_TCP\",\r\n \"value\": \"tcp:\/\/desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io:443\"\r\n },\r\n {\r\n \"name\": \"KUBERNETES_SERVICE_HOST\",\r\n \"value\": \"desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io\"\r\n }\r\n ],\r\n \"image\": \"nginx:1.7.9\",\r\n \"imagePullPolicy\": \"IfNotPresent\",\r\n \"name\": \"nginx\",\r\n \"ports\": [\r\n {\r\n \"containerPort\": 80,\r\n \"protocol\": \"TCP\"\r\n }\r\n ],\r\n \"resources\": {},\r\n \"terminationMessagePath\": \"\/dev\/termination-log\",\r\n \"terminationMessagePolicy\": \"File\",\r\n \"volumeMounts\": [\r\n {\r\n \"mountPath\": \"\/var\/run\/secrets\/kubernetes.io\/serviceaccount\",\r\n \"name\": \"default-token-rcrjf\",\r\n \"readOnly\": true\r\n }\r\n ]\r\n }\r\n ],\r\n \"dnsPolicy\": \"ClusterFirst\",\r\n \"nodeName\": \"aks-agentpool-14980324-0\",\r\n \"priority\": 0,\r\n \"restartPolicy\": \"Always\",\r\n \"schedulerName\": \"default-scheduler\",\r\n \"securityContext\": {},\r\n \"serviceAccount\": \"default\",\r\n \"serviceAccountName\": \"default\",\r\n \"terminationGracePeriodSeconds\": 30,\r\n \"tolerations\": [\r\n {\r\n \"effect\": \"NoExecute\",\r\n \"key\": \"node.kubernetes.io\/not-ready\",\r\n \"operator\": \"Exists\",\r\n \"tolerationSeconds\": 300\r\n },\r\n {\r\n \"effect\": \"NoExecute\",\r\n \"key\": \"node.kubernetes.io\/unreachable\",\r\n \"operator\": \"Exists\",\r\n \"tolerationSeconds\": 300\r\n }\r\n ],\r\n \"volumes\": [\r\n {\r\n \"name\": \"default-token-rcrjf\",\r\n \"secret\": {\r\n \"defaultMode\": 420,\r\n \"secretName\": \"default-token-rcrjf\"\r\n }\r\n }\r\n ]\r\n },\r\n \"status\": {\r\n \"conditions\": [\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:38Z\",\r\n \"status\": \"True\",\r\n \"type\": \"Initialized\"\r\n },\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:54Z\",\r\n \"status\": \"True\",\r\n \"type\": \"Ready\"\r\n },\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:54Z\",\r\n \"status\": \"True\",\r\n \"type\": \"ContainersReady\"\r\n },\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:38Z\",\r\n \"status\": \"True\",\r\n \"type\": \"PodScheduled\"\r\n }\r\n ],\r\n \"containerStatuses\": [\r\n {\r\n \"containerID\": \"docker:\/\/5e87acbad211218f3b1e383f2a83bc300095a032e87540c201e8e413b0518eeb\",\r\n \"image\": \"nginx:1.7.9\",\r\n \"imageID\": \"docker-pullable:\/\/nginx@sha256:e3456c851a152494c3e4ff5fcc26f240206abac0c9d794affb40e0714846c451\",\r\n \"lastState\": {},\r\n \"name\": \"nginx\",\r\n \"ready\": true,\r\n \"restartCount\": 0,\r\n \"state\": {\r\n \"running\": {\r\n \"startedAt\": \"2019-03-22T13:10:53Z\"\r\n }\r\n }\r\n }\r\n ],\r\n \"hostIP\": \"10.240.0.4\",\r\n \"phase\": \"Running\",\r\n \"podIP\": \"10.240.0.15\",\r\n \"qosClass\": \"BestEffort\",\r\n \"startTime\": \"2019-03-22T13:10:38Z\"\r\n }\r\n },\r\n {\r\n \"apiVersion\": \"v1\",\r\n \"kind\": \"Pod\",\r\n \"metadata\": {\r\n \"creationTimestamp\": \"2019-03-22T13:10:38Z\",\r\n \"generateName\": \"nginx-deployment-5c689d88bb-\",\r\n \"labels\": {\r\n \"app\": \"nginx\",\r\n \"pod-template-hash\": \"5c689d88bb\"\r\n },\r\n \"name\": \"nginx-deployment-5c689d88bb-gnwrt\",\r\n \"namespace\": \"default\",\r\n \"ownerReferences\": [\r\n {\r\n \"apiVersion\": \"apps\/v1\",\r\n \"blockOwnerDeletion\": true,\r\n \"controller\": true,\r\n \"kind\": \"ReplicaSet\",\r\n \"name\": \"nginx-deployment-5c689d88bb\",\r\n \"uid\": \"e2e6b9b8-4ca3-11e9-bdff-2a073485f16f\"\r\n }\r\n ],\r\n \"resourceVersion\": \"125932\",\r\n \"selfLink\": \"\/api\/v1\/namespaces\/default\/pods\/nginx-deployment-5c689d88bb-gnwrt\",\r\n \"uid\": \"e2ece835-4ca3-11e9-bdff-2a073485f16f\"\r\n },\r\n \"spec\": {\r\n \"containers\": [\r\n {\r\n \"env\": [\r\n {\r\n \"name\": \"KUBERNETES_PORT_443_TCP_ADDR\",\r\n \"value\": \"desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io\"\r\n },\r\n {\r\n \"name\": \"KUBERNETES_PORT\",\r\n \"value\": \"tcp:\/\/desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io:443\"\r\n },\r\n {\r\n \"name\": \"KUBERNETES_PORT_443_TCP\",\r\n \"value\": \"tcp:\/\/desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io:443\"\r\n },\r\n {\r\n \"name\": \"KUBERNETES_SERVICE_HOST\",\r\n \"value\": \"desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io\"\r\n }\r\n ],\r\n \"image\": \"nginx:1.7.9\",\r\n \"imagePullPolicy\": \"IfNotPresent\",\r\n \"name\": \"nginx\",\r\n \"ports\": [\r\n {\r\n \"containerPort\": 80,\r\n \"protocol\": \"TCP\"\r\n }\r\n ],\r\n \"resources\": {},\r\n \"terminationMessagePath\": \"\/dev\/termination-log\",\r\n \"terminationMessagePolicy\": \"File\",\r\n \"volumeMounts\": [\r\n {\r\n \"mountPath\": \"\/var\/run\/secrets\/kubernetes.io\/serviceaccount\",\r\n \"name\": \"default-token-rcrjf\",\r\n \"readOnly\": true\r\n }\r\n ]\r\n }\r\n ],\r\n \"dnsPolicy\": \"ClusterFirst\",\r\n \"nodeName\": \"aks-agentpool-14980324-1\",\r\n \"priority\": 0,\r\n \"restartPolicy\": \"Always\",\r\n \"schedulerName\": \"default-scheduler\",\r\n \"securityContext\": {},\r\n \"serviceAccount\": \"default\",\r\n \"serviceAccountName\": \"default\",\r\n \"terminationGracePeriodSeconds\": 30,\r\n \"tolerations\": [\r\n {\r\n \"effect\": \"NoExecute\",\r\n \"key\": \"node.kubernetes.io\/not-ready\",\r\n \"operator\": \"Exists\",\r\n \"tolerationSeconds\": 300\r\n },\r\n {\r\n \"effect\": \"NoExecute\",\r\n \"key\": \"node.kubernetes.io\/unreachable\",\r\n \"operator\": \"Exists\",\r\n \"tolerationSeconds\": 300\r\n }\r\n ],\r\n \"volumes\": [\r\n {\r\n \"name\": \"default-token-rcrjf\",\r\n \"secret\": {\r\n \"defaultMode\": 420,\r\n \"secretName\": \"default-token-rcrjf\"\r\n }\r\n }\r\n ]\r\n },\r\n \"status\": {\r\n \"conditions\": [\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:38Z\",\r\n \"status\": \"True\",\r\n \"type\": \"Initialized\"\r\n },\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:54Z\",\r\n \"status\": \"True\",\r\n \"type\": \"Ready\"\r\n },\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:54Z\",\r\n \"status\": \"True\",\r\n \"type\": \"ContainersReady\"\r\n },\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:38Z\",\r\n \"status\": \"True\",\r\n \"type\": \"PodScheduled\"\r\n }\r\n ],\r\n \"containerStatuses\": [\r\n {\r\n \"containerID\": \"docker:\/\/a2bf617633e412760806e06e02dc5f81b5dad6f4f5ce8fe17955cdf72013ba04\",\r\n \"image\": \"nginx:1.7.9\",\r\n \"imageID\": \"docker-pullable:\/\/nginx@sha256:e3456c851a152494c3e4ff5fcc26f240206abac0c9d794affb40e0714846c451\",\r\n \"lastState\": {},\r\n \"name\": \"nginx\",\r\n \"ready\": true,\r\n \"restartCount\": 0,\r\n \"state\": {\r\n \"running\": {\r\n \"startedAt\": \"2019-03-22T13:10:53Z\"\r\n }\r\n }\r\n }\r\n ],\r\n \"hostIP\": \"10.240.0.35\",\r\n \"phase\": \"Running\",\r\n \"podIP\": \"10.240.0.43\",\r\n \"qosClass\": \"BestEffort\",\r\n \"startTime\": \"2019-03-22T13:10:38Z\"\r\n }\r\n },\r\n {\r\n \"apiVersion\": \"v1\",\r\n \"kind\": \"Pod\",\r\n \"metadata\": {\r\n \"creationTimestamp\": \"2019-03-22T13:10:38Z\",\r\n \"generateName\": \"nginx-deployment-5c689d88bb-\",\r\n \"labels\": {\r\n \"app\": \"nginx\",\r\n \"pod-template-hash\": \"5c689d88bb\"\r\n },\r\n \"name\": \"nginx-deployment-5c689d88bb-qmh97\",\r\n \"namespace\": \"default\",\r\n \"ownerReferences\": [\r\n {\r\n \"apiVersion\": \"apps\/v1\",\r\n \"blockOwnerDeletion\": true,\r\n \"controller\": true,\r\n \"kind\": \"ReplicaSet\",\r\n \"name\": \"nginx-deployment-5c689d88bb\",\r\n \"uid\": \"e2e6b9b8-4ca3-11e9-bdff-2a073485f16f\"\r\n }\r\n ],\r\n \"resourceVersion\": \"49429\",\r\n \"selfLink\": \"\/api\/v1\/namespaces\/default\/pods\/nginx-deployment-5c689d88bb-qmh97\",\r\n \"uid\": \"e2f4630d-4ca3-11e9-bdff-2a073485f16f\"\r\n },\r\n \"spec\": {\r\n \"containers\": [\r\n {\r\n \"env\": [\r\n {\r\n \"name\": \"KUBERNETES_PORT_443_TCP_ADDR\",\r\n \"value\": \"desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io\"\r\n },\r\n {\r\n \"name\": \"KUBERNETES_PORT\",\r\n \"value\": \"tcp:\/\/desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io:443\"\r\n },\r\n {\r\n \"name\": \"KUBERNETES_PORT_443_TCP\",\r\n \"value\": \"tcp:\/\/desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io:443\"\r\n },\r\n {\r\n \"name\": \"KUBERNETES_SERVICE_HOST\",\r\n \"value\": \"desattir-virtual-dns-9381c228.hcp.eastus.azmk8s.io\"\r\n }\r\n ],\r\n \"image\": \"nginx:1.7.9\",\r\n \"imagePullPolicy\": \"IfNotPresent\",\r\n \"name\": \"nginx\",\r\n \"ports\": [\r\n {\r\n \"containerPort\": 80,\r\n \"protocol\": \"TCP\"\r\n }\r\n ],\r\n \"resources\": {},\r\n \"terminationMessagePath\": \"\/dev\/termination-log\",\r\n \"terminationMessagePolicy\": \"File\",\r\n \"volumeMounts\": [\r\n {\r\n \"mountPath\": \"\/var\/run\/secrets\/kubernetes.io\/serviceaccount\",\r\n \"name\": \"default-token-rcrjf\",\r\n \"readOnly\": true\r\n }\r\n ]\r\n }\r\n ],\r\n \"dnsPolicy\": \"ClusterFirst\",\r\n \"nodeName\": \"aks-agentpool-14980324-2\",\r\n \"priority\": 0,\r\n \"restartPolicy\": \"Always\",\r\n \"schedulerName\": \"default-scheduler\",\r\n \"securityContext\": {},\r\n \"serviceAccount\": \"default\",\r\n \"serviceAccountName\": \"default\",\r\n \"terminationGracePeriodSeconds\": 30,\r\n \"tolerations\": [\r\n {\r\n \"effect\": \"NoExecute\",\r\n \"key\": \"node.kubernetes.io\/not-ready\",\r\n \"operator\": \"Exists\",\r\n \"tolerationSeconds\": 300\r\n },\r\n {\r\n \"effect\": \"NoExecute\",\r\n \"key\": \"node.kubernetes.io\/unreachable\",\r\n \"operator\": \"Exists\",\r\n \"tolerationSeconds\": 300\r\n }\r\n ],\r\n \"volumes\": [\r\n {\r\n \"name\": \"default-token-rcrjf\",\r\n \"secret\": {\r\n \"defaultMode\": 420,\r\n \"secretName\": \"default-token-rcrjf\"\r\n }\r\n }\r\n ]\r\n },\r\n \"status\": {\r\n \"conditions\": [\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:38Z\",\r\n \"status\": \"True\",\r\n \"type\": \"Initialized\"\r\n },\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:55Z\",\r\n \"status\": \"True\",\r\n \"type\": \"Ready\"\r\n },\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:55Z\",\r\n \"status\": \"True\",\r\n \"type\": \"ContainersReady\"\r\n },\r\n {\r\n \"lastProbeTime\": null,\r\n \"lastTransitionTime\": \"2019-03-22T13:10:38Z\",\r\n \"status\": \"True\",\r\n \"type\": \"PodScheduled\"\r\n }\r\n ],\r\n \"containerStatuses\": [\r\n {\r\n \"containerID\": \"docker:\/\/3509c82a27b63f7fdb93746a74cb91862126c2cb66bae307904b2a89dcdf7152\",\r\n \"image\": \"nginx:1.7.9\",\r\n \"imageID\": \"docker-pullable:\/\/nginx@sha256:e3456c851a152494c3e4ff5fcc26f240206abac0c9d794affb40e0714846c451\",\r\n \"lastState\": {},\r\n \"name\": \"nginx\",\r\n \"ready\": true,\r\n \"restartCount\": 0,\r\n \"state\": {\r\n \"running\": {\r\n \"startedAt\": \"2019-03-22T13:10:54Z\"\r\n }\r\n }\r\n }\r\n ],\r\n \"hostIP\": \"10.240.0.66\",\r\n \"phase\": \"Running\",\r\n \"podIP\": \"10.240.0.79\",\r\n \"qosClass\": \"BestEffort\",\r\n \"startTime\": \"2019-03-22T13:10:38Z\"\r\n }\r\n }\r\n ]\r\n}" +}; + +a.exec[`${KubectlPath} describe deployment nginx-deployment --namespace default`] = { + "code": 0, + "stdout": "Name: nginx-deployment" +}; + +a.exec[`${KubectlPath} describe deployment nginx-deployment-canary --namespace default`] = { + "code": 0, + "stdout": "Name: nginx-deployment-canary" +}; + +a.exec[`${KubectlPath} describe deployment nginx-deployment-baseline --namespace default`] = { + "code": 0, + "stdout": "Name: nginx-deployment-baseline" +}; + +a.exec[`${KubectlPath} delete Deployment nginx-deployment-canary nginx-deployment-baseline`] = { + "code": 0, + "stdout": " \"nginx-deployment-canary\" deleted. \"nginx-deployment-baseline\" deleted" +}; + +var pipelineAnnotations: string = [ + `azure-pipelines/execution=${BuildNumber}`, + `azure-pipelines/pipeline="${DefinitionName}"`, + `azure-pipelines/pipelineId="${DefinitionId}"`, + `azure-pipelines/jobName="${JobName}"`, + `azure-pipelines/executionuri=${TeamFoundationCollectionUri}${TeamProject}/_build/results?buildId=${BuildId}`, + `azure-pipelines/project=${TeamProject}`, + `azure-pipelines/org=${CollectionId}` +].join(" "); +var annotateCanaryCmd = `${KubectlPath} annotate -f ${shared.CanaryManifestFilesPath},${shared.BaselineManifestFilesPath} --namespace default ` + pipelineAnnotations + ` --overwrite`; + +a.exec[annotateCanaryCmd] = { + "code": 0, + "stdout": "deployment.apps/nginx-deployment-canary annotated. deployment.apps/nginx-deployment-baseline annotated" +}; + +var annotateStableCmd = `${KubectlPath} annotate -f ${process.env[shared.TestEnvVars.manifests]} --namespace default ` + pipelineAnnotations + ` --overwrite`; +a.exec[annotateStableCmd] = { + "code": 0, + "stdout": "deployment.extensions/nginx-deployment annotated" +}; + +if (process.env[shared.TestEnvVars.arguments]) { + var deleteCmd = `${KubectlPath} delete ${process.env[shared.TestEnvVars.arguments]}`; + a.exec[deleteCmd] = { + "code": 0, + "stdout": "deleted successfuly" + }; +} + +tr.setAnswers(a); +tr.registerMock('vsts-task-lib/toolrunner', require('vsts-task-lib/mock-toolrunner')); + +// Create mock for fs module +let fs = require('fs'); +let fsClone = Object.assign({}, fs); +fsClone.existsSync = function (filePath) { + switch (filePath) { + case KubectlPath: + if (JSON.parse(process.env[shared.TestEnvVars.isKubectlPresentOnMachine])) { + return true; + } + else { + return false; + } + default: + return fs.existsSync(filePath); + } +}; + +tr.registerMock('fs', fsClone); + +var fh = require('../src/utils/FileHelper'); +tr.registerMock('../utils/FileHelper', { + writeObjectsToFile: function (inputObjects: any[]) { + let newFilePaths = []; + + inputObjects.forEach(inputObject => { + if (!!inputObject && !!inputObject.metadata && !!inputObject.metadata.name) { + if (inputObject.metadata.name.indexOf("canary") != -1) { + newFilePaths.push(shared.CanaryManifestFilesPath); + } + else if (inputObject.metadata.name.indexOf("baseline") != -1) { + newFilePaths.push(shared.BaselineManifestFilesPath); + } + } + }); + + if (newFilePaths.length == 0) { + newFilePaths.push(shared.ManifestFilesPath); + } + return newFilePaths; + }, + getTempDirectory: fh.getTempDirectory, + getNewUserDirPath: fh.getNewUserDirPath, + ensureDirExists: fh.ensureDirExists, + assertFileExists: fh.assertFileExists +}); + +tr.run(); diff --git a/Tasks/KubernetesManifestV0/Tests/TestShared.ts b/Tasks/KubernetesManifestV0/Tests/TestShared.ts new file mode 100644 index 000000000000..77c26ea4a72b --- /dev/null +++ b/Tasks/KubernetesManifestV0/Tests/TestShared.ts @@ -0,0 +1,77 @@ +import path = require('path'); + +export let TestEnvVars = { + operatingSystem: "__operating_system__", + connectionType: "__connectionType__", + kubernetesServiceEndpoint: "__kubernetesServiceEndpoint__", + namespace: "__namespace__", + action: "__action__", + strategy: "__strategy__", + percentage: "__percentage__", + configuration: "__configuration__", + manifests: "__manifests__", + containers: "__containers__", + imagePullSecrets: "__imagePullSecrets__", + renderType: "__renderType__", + helmChart: "__helmChart__", + secretName: "__secretName__", + overrideFiles: "__overrideFiles__", + overrides: "__overrides__", + resourceToPatch: "__resourceToPatch__", + resourceFileToPatch: "__resourceFileToPatch__", + kind: "__kind__", + name: "__name__", + replicas: "__replicas__", + mergeStrategy: "__mergeStrategy__", + arguments: "__arguments__", + patch: "__patch__", + resourceName: "__resourceName__", + isKubectlPresentOnMachine: "__isKubectlPresentOnMachine__", + endpointAuthorizationType: "__endpointAuthorizationType__", + isStableDeploymentPresent: "__isStableDeploymentPresent__", + isCanaryDeploymentPresent: "__isCanaryDeploymentPresent__", + isBaselineDeploymentPresent: "__isBaselineDeploymentPresent__" +}; + +export let OperatingSystems = { + Windows: "Windows", + Other: "Other" +}; + +export let AuthorizationType = { + Kubeconfig : "Kubeconfig", + ServiceAccount : "ServiceAccount", + AzureSubscription : "AzureSubscription" +}; + +export let Actions = { + bake: "bake", + deploy: "deploy", + patch: "patch", + scale: "scale", + delete: "delete", + reject: "reject", + promote: "promote" +}; + +export let Strategy = { + canary: "canary", + none: "none" +}; + +export const ManifestFilesPath = path.join(__dirname, 'manifests', 'deployment.yaml'); +export const CanaryManifestFilesPath = path.join(__dirname, 'manifests', 'deployment-canary.yaml'); +export const BaselineManifestFilesPath = path.join(__dirname, 'manifests', 'deployment-baseline.yaml'); +export const DeleteCmdArguments = "deployment nginx-deployment"; + +/** + * Formats the given path to be appropriate for the operating system. + * @param canonicalPath A non-rooted path using a forward slash (/) as a directory separator. + */ +export function formatPath(canonicalPath: string) { + if (process.env[TestEnvVars.operatingSystem] === OperatingSystems.Windows) { + return "F:\\" + canonicalPath.replace('/', '\\'); + } else { + return "/" + canonicalPath; + } +}; \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/Tests/manifests/deployment-baseline.yaml b/Tasks/KubernetesManifestV0/Tests/manifests/deployment-baseline.yaml new file mode 100644 index 000000000000..7edb156ab326 --- /dev/null +++ b/Tasks/KubernetesManifestV0/Tests/manifests/deployment-baseline.yaml @@ -0,0 +1,21 @@ +apiVersion: apps/v1 +kind: Deployment +metadata: + name: nginx-deployment-baseline + labels: + app: nginx +spec: + replicas: 1 + selector: + matchLabels: + app: nginx + template: + metadata: + labels: + app: nginx + spec: + containers: + - name: nginx + image: nginx:1.7.9 + ports: + - containerPort: 80 \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/Tests/manifests/deployment-canary.yaml b/Tasks/KubernetesManifestV0/Tests/manifests/deployment-canary.yaml new file mode 100644 index 000000000000..0cc843c520a9 --- /dev/null +++ b/Tasks/KubernetesManifestV0/Tests/manifests/deployment-canary.yaml @@ -0,0 +1,21 @@ +apiVersion: apps/v1 +kind: Deployment +metadata: + name: nginx-deployment-canary + labels: + app: nginx +spec: + replicas: 1 + selector: + matchLabels: + app: nginx + template: + metadata: + labels: + app: nginx + spec: + containers: + - name: nginx + image: nginx:1.7.9 + ports: + - containerPort: 80 \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/Tests/manifests/deployment.yaml b/Tasks/KubernetesManifestV0/Tests/manifests/deployment.yaml new file mode 100644 index 000000000000..41df31909c65 --- /dev/null +++ b/Tasks/KubernetesManifestV0/Tests/manifests/deployment.yaml @@ -0,0 +1,23 @@ +apiVersion: apps/v1 +kind: Deployment +metadata: + name: nginx-deployment + labels: + app: nginx +spec: + replicas: 3 + selector: + matchLabels: + app: nginx + template: + metadata: + labels: + app: nginx + spec: + containers: + - name: nginx + image: nginx:1.7.9 + ports: + - containerPort: 80 + imagePullSecrets: + - name: key1 \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/make.json b/Tasks/KubernetesManifestV0/make.json index 8e3170951681..fa781a19d8af 100644 --- a/Tasks/KubernetesManifestV0/make.json +++ b/Tasks/KubernetesManifestV0/make.json @@ -5,11 +5,18 @@ "type": "node", "dest" : "./", "compile" : true + }, + { + "module": "../Common/kubernetes-common", + "type": "node", + "dest" : "./", + "compile" : true } ], "rm": [ { "items": [ + "node_modules/kubernetes-common/node_modules/vsts-task-lib", "node_modules/utility-common/node_modules/vsts-task-lib", "node_modules/vsts-task-tool-lib/node_modules/vsts-task-lib" ], diff --git a/Tasks/KubernetesManifestV0/package-lock.json b/Tasks/KubernetesManifestV0/package-lock.json index c023a2295bae..842c83dad294 100644 --- a/Tasks/KubernetesManifestV0/package-lock.json +++ b/Tasks/KubernetesManifestV0/package-lock.json @@ -183,6 +183,12 @@ "esprima": "^2.6.0" } }, + "kubernetes-common": { + "version": "file:../../_build/Tasks/Common/kubernetes-common-1.0.0.tgz", + "requires": { + "vsts-task-lib": "2.6.0" + } + }, "minimatch": { "version": "3.0.4", "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz", diff --git a/Tasks/KubernetesManifestV0/package.json b/Tasks/KubernetesManifestV0/package.json index e5bd927d0b44..b0a64f9cc3b0 100644 --- a/Tasks/KubernetesManifestV0/package.json +++ b/Tasks/KubernetesManifestV0/package.json @@ -6,6 +6,7 @@ "@types/node": "^6.0.101", "@types/q": "^1.5.0", "del": "2.2.0", + "kubernetes-common": "file:../../_build/Tasks/Common/kubernetes-common-1.0.0.tgz", "moment": "2.21.0", "utility-common": "file:../../_build/Tasks/Common/utility-common-1.0.2.tgz", "vsts-task-lib": "2.6.0", diff --git a/Tasks/KubernetesManifestV0/src/actions/createSecret.ts b/Tasks/KubernetesManifestV0/src/actions/createSecret.ts new file mode 100644 index 000000000000..c091cdf71d9f --- /dev/null +++ b/Tasks/KubernetesManifestV0/src/actions/createSecret.ts @@ -0,0 +1,29 @@ +"use strict"; + +import tl = require('vsts-task-lib/task'); +import { Kubectl } from "kubernetes-common/kubectl-object-model"; +import * as utils from "../utils/utilities"; +import * as TaskInputParameters from '../models/TaskInputParameters'; + +export async function createSecret() { + let args = ""; + if (utils.isEqual(TaskInputParameters.secretType, "dockerRegistry", utils.StringComparer.OrdinalIgnoreCase)) { + args = getDockerRegistrySecretArgs(); + } + else { + args = getGenericSecretArgs(); + } + + let kubectl = new Kubectl(await utils.getKubectl(), TaskInputParameters.namespace); + var result = kubectl.createSecret(args, true, TaskInputParameters.secretName.trim()); + utils.checkForErrors([result]); +} + +let getDockerRegistrySecretArgs = () => { + let dockerRegistryAuth = tl.getEndpointAuthorization(TaskInputParameters.dockerRegistryEndpoint, false).parameters; + return `docker-registry ${TaskInputParameters.secretName.trim()} --docker-username=${dockerRegistryAuth["username"]} --docker-password=${dockerRegistryAuth["password"]} --docker-server=${dockerRegistryAuth["registry"]} --docker-email=${dockerRegistryAuth["email"]}` +} + +let getGenericSecretArgs = () => { + return `generic ${TaskInputParameters.secretName.trim()} ${TaskInputParameters.secretArguments}` +} \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/src/actions/delete.ts b/Tasks/KubernetesManifestV0/src/actions/delete.ts index 0ef9a7888205..565245e7293c 100644 --- a/Tasks/KubernetesManifestV0/src/actions/delete.ts +++ b/Tasks/KubernetesManifestV0/src/actions/delete.ts @@ -1,12 +1,17 @@ -"use strict"; +"use strict"; -import tl = require('vsts-task-lib/task'); -import { Kubectl } from "utility-common/kubectl-object-model"; +import tl = require('vsts-task-lib/task'); +import { Kubectl } from "kubernetes-common/kubectl-object-model"; import * as utils from "../utils/utilities"; import * as TaskInputParameters from '../models/TaskInputParameters'; export async function deleteResources() { let args = TaskInputParameters.args; + + if (args == null || args.length == 0) { + throw (tl.loc("ArgumentsInputNotSupplied")); + } + let kubectl = new Kubectl(await utils.getKubectl(), TaskInputParameters.namespace); var result = kubectl.delete(args); utils.checkForErrors([result]); diff --git a/Tasks/KubernetesManifestV0/src/actions/deploy.ts b/Tasks/KubernetesManifestV0/src/actions/deploy.ts index e1aa348f5ce1..a8d4bff6ada4 100644 --- a/Tasks/KubernetesManifestV0/src/actions/deploy.ts +++ b/Tasks/KubernetesManifestV0/src/actions/deploy.ts @@ -1,147 +1,12 @@ "use strict"; -import fs = require("fs"); -import path = require('path'); -import tl = require('vsts-task-lib/task'); -import yaml = require('js-yaml'); -import * as canaryDeploymentHelper from '../utils/CanaryDeploymentHelper'; -import * as KubernetesObjectUtility from '../utils/KubernetesObjectUtility'; -import * as constants from '../models/constants'; +import * as deploymentHelper from '../utils/DeploymentHelper'; import * as TaskInputParameters from '../models/TaskInputParameters'; -import * as models from '../models/constants'; -import * as fileHelper from "../utils/FileHelper"; import * as utils from "../utils/utilities"; -import { IExecSyncResult } from 'vsts-task-lib/toolrunner'; -import { Kubectl, Resource } from "utility-common/kubectl-object-model"; - -const CANARY_DEPLOYMENT_STRATEGY = "CANARY"; +import { Kubectl } from "kubernetes-common/kubectl-object-model"; export async function deploy() { - var inputManifestFiles: string[] = getManifestFiles(); - let kubectl = new Kubectl(await utils.getKubectl(), TaskInputParameters.namespace); - var deployedManifestFiles = deployManifests(inputManifestFiles, kubectl); - let resourceTypes: Resource[] = KubernetesObjectUtility.getResources(deployedManifestFiles, models.recognizedWorkloadTypes); - checkManifestStability(kubectl, resourceTypes); - annotateResources(deployedManifestFiles, kubectl, resourceTypes); -} - -function getManifestFiles(): string[] { - var files: string[] = tl.findMatch(tl.getVariable("System.DefaultWorkingDirectory") || process.cwd(), TaskInputParameters.manifests); - - if (files.length == 0) { - throw (tl.loc("ManifestFileNotFound")); - } - - files = updateContainerImagesInConfigFiles(files, TaskInputParameters.containers); - return files; -} - -function deployManifests(files: string[], kubectl: Kubectl): string[] { - var deploymentStrategy = TaskInputParameters.deploymentStrategy; - let result; - if (deploymentStrategy && deploymentStrategy.toUpperCase() === CANARY_DEPLOYMENT_STRATEGY) { - var canaryDeploymentOutput = canaryDeployment(files, kubectl); - result = canaryDeploymentOutput.result; - files = canaryDeploymentOutput.newFilePaths; - } else { - result = kubectl.apply(files); - } - utils.checkForErrors([result]); - return files; -} - -function checkManifestStability(kubectl: Kubectl, resourceTypes: Resource[]) { - let rolloutStatusResults = []; - resourceTypes.forEach(resource => { - if (models.recognizedWorkloadTypesWithRolloutStatus.indexOf(resource.type.toLowerCase()) >= 0) { - rolloutStatusResults.push(kubectl.checkRolloutStatus(resource.type, resource.name)); - } - }); - utils.checkForErrors(rolloutStatusResults); -} - -function annotateResources(files: string[], kubectl: Kubectl, resourceTypes: Resource[]) { - let annotateResults: IExecSyncResult[] = []; - var allPods = JSON.parse((kubectl.getAllPods()).stdout); - annotateResults.push(kubectl.annotateFiles(files, constants.pipelineAnnotations, true)); - resourceTypes.forEach(resource => { - if (resource.type.toUpperCase() != models.KubernetesWorkload.Pod.toUpperCase()) { - utils.annotateChildPods(kubectl, resource.type, resource.name, allPods) - .forEach(execResult => annotateResults.push(execResult)); - } - }); - utils.checkForErrors(annotateResults, true); -} - -function canaryDeployment(filePaths: string[], kubectl: Kubectl) { - var newObjectsList = []; - var percentage = parseInt(TaskInputParameters.canaryPercentage); - - filePaths.forEach((filePath: string) => { - var fileContents = fs.readFileSync(filePath); - yaml.safeLoadAll(fileContents, function (inputObject) { - - var name = inputObject.metadata.name; - var kind = inputObject.kind; - if (canaryDeploymentHelper.isDeploymentEntity(kind)) { - var existing_canary_object = canaryDeploymentHelper.fetchCanaryResource(kubectl, kind, name); - - if (!!existing_canary_object) { - throw (tl.loc("CanaryDeploymentAlreadyExistErrorMessage")); - } - - var canaryReplicaCount = canaryDeploymentHelper.calculateReplicaCountForCanary(inputObject, percentage); - // Get stable object - var stable_object = canaryDeploymentHelper.fetchResource(kubectl, kind, name); - if (!stable_object) { - // If stable object not found, create canary deployment. - var newCanaryObject = canaryDeploymentHelper.getNewCanaryResource(inputObject, canaryReplicaCount); - newObjectsList.push(newCanaryObject); - } else { - // If canary object not found, create canary and baseline object. - var newCanaryObject = canaryDeploymentHelper.getNewCanaryResource(inputObject, canaryReplicaCount); - var newBaselineObject = canaryDeploymentHelper.getNewBaselineResource(stable_object, canaryReplicaCount); - newObjectsList.push(newCanaryObject); - newObjectsList.push(newBaselineObject); - } - } else { - // Updating non deployment entity as it is. - newObjectsList.push(inputObject); - } - }); - }); - - var manifestFiles = fileHelper.writeObjectsToFile(newObjectsList); - var result = kubectl.apply(manifestFiles); - return { "result": result, "newFilePaths": manifestFiles }; -} - -function updateContainerImagesInConfigFiles(filePaths: string[], containers): string[] { - if (containers != []) { - let newFilePaths = []; - const tempDirectory = fileHelper.getTempDirectory(); - filePaths.forEach((filePath: string) => { - var contents = fs.readFileSync(filePath).toString(); - containers.forEach((container: string) => { - let imageName = container.split(":")[0]; - if (imageName.indexOf("@") > 0) - imageName = imageName.split("@")[0]; - if (contents.indexOf(imageName) > 0) { - contents = utils.substituteImageNameInSpecFile(contents, imageName, container); - } - }); - - let fileName = path.join(tempDirectory, path.basename(filePath)); - fs.writeFileSync( - path.join(fileName), - contents - ); - - newFilePaths.push(fileName); - }); - - return newFilePaths; - } - - return filePaths; -} + var kubectlPath = await utils.getKubectl(); + let kubectl = new Kubectl(kubectlPath, TaskInputParameters.namespace); + deploymentHelper.deploy(kubectl, TaskInputParameters.manifests, TaskInputParameters.deploymentStrategy); +} \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/src/actions/patch.ts b/Tasks/KubernetesManifestV0/src/actions/patch.ts index 47d76ff11879..c52ebfd757f4 100644 --- a/Tasks/KubernetesManifestV0/src/actions/patch.ts +++ b/Tasks/KubernetesManifestV0/src/actions/patch.ts @@ -1,7 +1,7 @@ "use strict"; import tl = require('vsts-task-lib/task'); -import { Kubectl } from "utility-common/kubectl-object-model"; +import { Kubectl } from "kubernetes-common/kubectl-object-model"; import * as utils from "../utils/utilities"; import * as constants from "../models/constants"; diff --git a/Tasks/KubernetesManifestV0/src/actions/promote.ts b/Tasks/KubernetesManifestV0/src/actions/promote.ts new file mode 100644 index 000000000000..04efab770cf2 --- /dev/null +++ b/Tasks/KubernetesManifestV0/src/actions/promote.ts @@ -0,0 +1,28 @@ +"use strict"; +import tl = require('vsts-task-lib/task'); +import * as deploymentHelper from '../utils/DeploymentHelper'; +import * as canaryDeploymentHelper from '../utils/CanaryDeploymentHelper'; +import { Kubectl } from "kubernetes-common/kubectl-object-model"; +import * as utils from "../utils/utilities"; +import * as TaskInputParameters from '../models/TaskInputParameters'; + +export async function promote() { + + let kubectl = new Kubectl(await utils.getKubectl(), TaskInputParameters.namespace); + + if (canaryDeploymentHelper.isCanaryDeploymentStrategy()) { + // Deploy input manifests + tl.debug("Deploying input manifests"); + deploymentHelper.deploy(kubectl, TaskInputParameters.manifests, "None"); + tl.debug("Deployment strategy selected is Canary. Deleting canary and baseline workloads."); + try { + canaryDeploymentHelper.deleteCanaryDeployment(kubectl, TaskInputParameters.manifests); + } catch (ex) { + tl.warning("Exception occurred while deleting canary and baseline workloads. Exception: " + ex); + } + } + else { + tl.debug("Strategy is not canary deployment. Invalid request."); + throw (tl.loc("InvalidPromotetActionDeploymentStrategy")); + } +} \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/src/actions/reject.ts b/Tasks/KubernetesManifestV0/src/actions/reject.ts new file mode 100644 index 000000000000..24b0c655c36c --- /dev/null +++ b/Tasks/KubernetesManifestV0/src/actions/reject.ts @@ -0,0 +1,20 @@ +"use strict"; +import tl = require('vsts-task-lib/task'); +import * as canaryDeploymentHelper from '../utils/CanaryDeploymentHelper'; +import { Kubectl } from "kubernetes-common/kubectl-object-model"; +import * as utils from "../utils/utilities"; +import * as TaskInputParameters from '../models/TaskInputParameters'; + +export async function reject() { + + let kubectl = new Kubectl(await utils.getKubectl(), TaskInputParameters.namespace); + + if (canaryDeploymentHelper.isCanaryDeploymentStrategy()) { + tl.debug("Deployment strategy selected is Canary. Deleting baseline and canary workloads."); + canaryDeploymentHelper.deleteCanaryDeployment(kubectl, TaskInputParameters.manifests); + } + else { + tl.debug("Strategy is not canary deployment. Invalid request."); + throw (tl.loc("InvalidRejectActionDeploymentStrategy")); + } +} \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/src/actions/scale.ts b/Tasks/KubernetesManifestV0/src/actions/scale.ts index 8f2cd0d0ab52..560aa03ed9c7 100644 --- a/Tasks/KubernetesManifestV0/src/actions/scale.ts +++ b/Tasks/KubernetesManifestV0/src/actions/scale.ts @@ -1,7 +1,7 @@ "use strict"; import tl = require('vsts-task-lib/task'); -import { Kubectl } from "utility-common/kubectl-object-model"; +import { Kubectl } from "kubernetes-common/kubectl-object-model"; import * as utils from "../utils/utilities"; import * as constants from "../models/constants"; diff --git a/Tasks/KubernetesManifestV0/src/connection.ts b/Tasks/KubernetesManifestV0/src/connection.ts index eb4470958e47..bd1557a17d33 100644 --- a/Tasks/KubernetesManifestV0/src/connection.ts +++ b/Tasks/KubernetesManifestV0/src/connection.ts @@ -6,25 +6,17 @@ import kubectlutility = require("utility-common/kubectlutility"); export class Connection { - constructor(skipAuth?: boolean) { - this._skipAuth = !!skipAuth; - } - public open() { - let connectionType = tl.getInput("connectionType", true); - if (connectionType === "None" || this._skipAuth) { - return; - } - let kubeconfig: string, kubeconfigFile: string; - let kubernetesServiceEndpoint = tl.getInput("kubernetesServiceEndpoint", true); - let authorizationType = tl.getEndpointDataParameter(kubernetesServiceEndpoint, 'authorizationType', true); + let kubernetesServiceConnection = tl.getInput("kubernetesServiceConnection", true); + + let authorizationType = tl.getEndpointDataParameter(kubernetesServiceConnection, 'authorizationType', true); if (!authorizationType || authorizationType === "Kubeconfig") { - kubeconfig = kubectlutility.getKubeconfigForCluster(kubernetesServiceEndpoint); + kubeconfig = kubectlutility.getKubeconfigForCluster(kubernetesServiceConnection); } else if (authorizationType === "ServiceAccount" || authorizationType === "AzureSubscription") { - kubeconfig = kubectlutility.createKubeconfig(kubernetesServiceEndpoint); + kubeconfig = kubectlutility.createKubeconfig(kubernetesServiceConnection); } kubeconfigFile = path.join(utils.getNewUserDirPath(), "config"); @@ -33,10 +25,8 @@ export class Connection { } public close() { - if (!this._skipAuth && tl.getVariable("KUBECONFIG")) { + if (tl.getVariable("KUBECONFIG")) { tl.setVariable("KUBECONFIG", ""); } } - - private _skipAuth: boolean; } diff --git a/Tasks/KubernetesManifestV0/src/models/TaskInputParameters.ts b/Tasks/KubernetesManifestV0/src/models/TaskInputParameters.ts index 9dfc944a0b2e..169591ccfb5c 100644 --- a/Tasks/KubernetesManifestV0/src/models/TaskInputParameters.ts +++ b/Tasks/KubernetesManifestV0/src/models/TaskInputParameters.ts @@ -4,7 +4,12 @@ import tl = require('vsts-task-lib/task'); export const namespace: string = tl.getInput("namespace", false); export const containers: string[] = tl.getDelimitedInput("containers", "\n"); +export const imagePullSecrets: string[] = tl.getDelimitedInput("imagePullSecrets", "\n"); export const manifests = tl.getInput("manifests", false); export const canaryPercentage: string = tl.getInput("percentage"); -export const deploymentStrategy: string = tl.getInput("deploymentStrategy", false); -export const args: string = tl.getInput("args", false); \ No newline at end of file +export const deploymentStrategy: string = tl.getInput("strategy", false); +export const args: string = tl.getInput("arguments", false); +export const secretArguments: string = tl.getInput("secretArguments", false); +export const secretType: string = tl.getInput("secretType", false); +export const secretName: string = tl.getInput("secretName", false); +export const dockerRegistryEndpoint: string = tl.getInput("dockerRegistryEndpoint", false); \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/src/models/constants.ts b/Tasks/KubernetesManifestV0/src/models/constants.ts index 2693ca29f354..ffad1d9be793 100644 --- a/Tasks/KubernetesManifestV0/src/models/constants.ts +++ b/Tasks/KubernetesManifestV0/src/models/constants.ts @@ -1,6 +1,7 @@ "use strict"; import tl = require('vsts-task-lib/task'); +import utils = require('../utils/utilities'); export class KubernetesWorkload { static Pod: string = "Pod"; @@ -12,10 +13,29 @@ export class KubernetesWorkload { export const recognizedWorkloadTypes: string[] = ["deployment", "replicaset", "daemonset", "pod", "statefulset"]; export const recognizedWorkloadTypesWithRolloutStatus: string[] = ["deployment", "daemonset", "statefulset"]; -export const pipelineAnnotations: string[] = [ - `azure-pipelines/execution=${tl.getVariable("Build.BuildNumber")}`, - `azure-pipelines/pipeline="${tl.getVariable("Build.DefinitionName")}"`, - `azure-pipelines/executionuri=${tl.getVariable("System.TeamFoundationCollectionUri")}_build/results?buildId=${tl.getVariable("Build.BuildId")}`, - `azure-pipelines/project=${tl.getVariable("System.TeamProject")}`, - `azure-pipelines/org=${tl.getVariable("System.CollectionId")}` -]; \ No newline at end of file + +let isBuild = tl.getVariable("TF_BUILD"); + +export let pipelineAnnotations: string[] = []; +if (isBuild && utils.isEqual(isBuild, "true", utils.StringComparer.OrdinalIgnoreCase)) { + pipelineAnnotations = [ + `azure-pipelines/execution=${tl.getVariable("Build.BuildNumber")}`, + `azure-pipelines/pipeline="${tl.getVariable("Build.DefinitionName")}"`, + `azure-pipelines/pipelineId="${tl.getVariable("System.DefinitionId")}"`, + `azure-pipelines/jobName="${tl.getVariable("Agent.JobName")}"`, + `azure-pipelines/executionuri=${tl.getVariable("System.TeamFoundationCollectionUri")}${tl.getVariable("System.TeamProject")}/_build/results?buildId=${tl.getVariable("Build.BuildId")}`, + `azure-pipelines/project=${tl.getVariable("System.TeamProject")}`, + `azure-pipelines/org=${tl.getVariable("System.CollectionId")}` + ]; +} +else { + pipelineAnnotations = [ + `azure-pipelines/execution=${tl.getVariable("Release.ReleaseId")}`, + `azure-pipelines/pipeline="${tl.getVariable("Release.DefinitionName")}"`, + `azure-pipelines/pipelineId="${tl.getVariable("Release.DefinitionId")}"`, + `azure-pipelines/jobName="${tl.getVariable("Agent.JobName")}"`, + `azure-pipelines/executionuri=${tl.getVariable("System.TeamFoundationCollectionUri")}${tl.getVariable("System.TeamProject")}/_releaseProgress?releaseId=${tl.getVariable("Release.ReleaseId")}`, + `azure-pipelines/project=${tl.getVariable("System.TeamProject")}`, + `azure-pipelines/org=${tl.getVariable("System.CollectionId")}` + ]; +} diff --git a/Tasks/KubernetesManifestV0/src/run.ts b/Tasks/KubernetesManifestV0/src/run.ts index a8f305cdb003..bc9f911d0ef5 100644 --- a/Tasks/KubernetesManifestV0/src/run.ts +++ b/Tasks/KubernetesManifestV0/src/run.ts @@ -6,6 +6,9 @@ import { bake } from "./actions/bake"; import { scale } from "./actions/scale"; import { patch } from "./actions/patch"; import { deleteResources } from './actions/delete'; +import { promote } from './actions/promote'; +import { reject } from './actions/reject'; +import { createSecret } from './actions/createSecret'; import { Connection } from "./connection"; tl.setResourcePath(path.join(__dirname, '..', 'task.json')); @@ -15,7 +18,7 @@ function run(): Promise { if (action === "bake") { return bake(); } - let connection = new Connection(!!tl.getVariable("KUBECONFIG")); + let connection = new Connection(); let action_func = null; switch (action) { case "deploy": @@ -30,8 +33,17 @@ function run(): Promise { case "delete": action_func = deleteResources; break; + case "promote": + action_func = promote; + break; + case "reject": + action_func = reject; + break; + case "createSecret": + action_func = createSecret; + break; default: - tl.setResult(tl.TaskResult.Failed, 'Not a supported action, choose from "bake", "deploy", "patch", "scale", "delete"'); + tl.setResult(tl.TaskResult.Failed, 'Not a supported action, choose from "bake", "deploy", "patch", "scale", "delete", "promote", "reject"'); process.exit(1); } connection.open() diff --git a/Tasks/KubernetesManifestV0/src/utils/CanaryDeploymentHelper.ts b/Tasks/KubernetesManifestV0/src/utils/CanaryDeploymentHelper.ts index 00017ac529ff..7f7594df4420 100644 --- a/Tasks/KubernetesManifestV0/src/utils/CanaryDeploymentHelper.ts +++ b/Tasks/KubernetesManifestV0/src/utils/CanaryDeploymentHelper.ts @@ -1,45 +1,170 @@ "use strict"; -import { Kubectl } from "utility-common/kubectl-object-model"; +import { Kubectl } from "kubernetes-common/kubectl-object-model"; import * as helper from './KubernetesObjectUtility'; -import { KubernetesWorkload, recognizedWorkloadTypes } from "../models/constants" +import { KubernetesWorkload } from "../models/constants" import * as utils from "./utilities"; import tl = require('vsts-task-lib/task'); +import fs = require("fs"); +import yaml = require('js-yaml'); +import * as TaskInputParameters from '../models/TaskInputParameters'; +import * as fileHelper from "../utils/FileHelper"; +export const CANARY_DEPLOYMENT_STRATEGY = "CANARY"; const BASELINE_SUFFIX = "-baseline"; const BASELINE_LABEL_VALUE = "baseline"; const CANARY_SUFFIX = "-canary"; const CANARY_LABEL_VALUE = "canary"; const CANARY_VERSION_LABEL = "azure-pipelines/version"; -export function calculateReplicaCountForCanary(inputObject: any, percentage: number) { - var inputReplicaCount = helper.getReplicaCount(inputObject); - return Math.round((inputReplicaCount * percentage) / 100); -} +export function deleteCanaryDeployment(kubectl: Kubectl, manifestFilesPath: string) { + + // get manifest files + var inputManifestFiles: string[] = utils.getManifestFiles(manifestFilesPath); + + if (inputManifestFiles == null || inputManifestFiles.length == 0) { + throw (tl.loc("ManifestFileNotFound")); + } -export function isDeploymentEntity(kind: string): boolean { - if (!kind) { - throw (tl.loc("ResourceKindNotDefined")); + // create delete cmd prefix + let argsPrefix: string; + argsPrefix = createCanaryObjectsArgumentString(inputManifestFiles); + + // append delete cmd args as suffix (if present) + let args = utils.getDeleteCmdArgs(argsPrefix, TaskInputParameters.args); + tl.debug("Delete cmd args : " + args); + + if (!!args && args.length > 0) { + // run kubectl delete cmd + var result = kubectl.delete(args); + utils.checkForErrors([result]); } +} - return recognizedWorkloadTypes.some(function (elem) { - return utils.isEqual(elem, kind, utils.StringComparer.OrdinalIgnoreCase); +export function deployCanary(kubectl: Kubectl, filePaths: string[]) { + var newObjectsList = []; + var percentage = parseInt(TaskInputParameters.canaryPercentage); + + filePaths.forEach((filePath: string) => { + var fileContents = fs.readFileSync(filePath); + yaml.safeLoadAll(fileContents, function (inputObject) { + + var name = inputObject.metadata.name; + var kind = inputObject.kind; + if (helper.isDeploymentEntity(kind)) { + var existing_canary_object = fetchCanaryResource(kubectl, kind, name); + + if (!!existing_canary_object) { + throw (tl.loc("CanaryDeploymentAlreadyExistErrorMessage")); + } + + tl.debug("Calculating replica count for canary"); + var canaryReplicaCount = calculateReplicaCountForCanary(inputObject, percentage); + tl.debug("Replica count is " + canaryReplicaCount); + // Get stable object + tl.debug("Querying stable object"); + var stable_object = fetchResource(kubectl, kind, name); + if (!stable_object) { + tl.debug("Stable object not found. Creating only canary object"); + // If stable object not found, create canary deployment. + var newCanaryObject = getNewCanaryResource(inputObject, canaryReplicaCount); + tl.debug("New canary object is: " + JSON.stringify(newCanaryObject)); + newObjectsList.push(newCanaryObject); + } else { + tl.debug("Stable object found. Creating canary and baseline objects"); + // If canary object not found, create canary and baseline object. + var newCanaryObject = getNewCanaryResource(inputObject, canaryReplicaCount); + var newBaselineObject = getNewBaselineResource(stable_object, canaryReplicaCount); + tl.debug("New canary object is: " + JSON.stringify(newCanaryObject)); + tl.debug("New baseline object is: " + JSON.stringify(newBaselineObject)); + newObjectsList.push(newCanaryObject); + newObjectsList.push(newBaselineObject); + } + } else { + // Updating non deployment entity as it is. + newObjectsList.push(inputObject); + } + }); }); + + var manifestFiles = fileHelper.writeObjectsToFile(newObjectsList); + var result = kubectl.apply(manifestFiles); + return { "result": result, "newFilePaths": manifestFiles }; +} + +export function isCanaryDeploymentStrategy() { + var deploymentStrategy = TaskInputParameters.deploymentStrategy; + return deploymentStrategy && deploymentStrategy.toUpperCase() === CANARY_DEPLOYMENT_STRATEGY; } -export function getNewBaselineResource(stableObject: any, replicas: number): object { +function calculateReplicaCountForCanary(inputObject: any, percentage: number) { + var inputReplicaCount = helper.getReplicaCount(inputObject); + return Math.round((inputReplicaCount * percentage) / 100); +} + +function getNewBaselineResource(stableObject: any, replicas: number): object { return getNewCanaryObject(stableObject, replicas, BASELINE_LABEL_VALUE); } -export function getNewCanaryResource(inputObject: any, replicas: number): object { +function getNewCanaryResource(inputObject: any, replicas: number): object { return getNewCanaryObject(inputObject, replicas, CANARY_LABEL_VALUE); } -export function fetchResource(kubectl: Kubectl, kind: string, name: string): object { +function getCanaryResourceName(name: string) { + return name + CANARY_SUFFIX; +} + +function getBaselineResourceName(name: string) { + return name + BASELINE_SUFFIX; +} + +function fetchResource(kubectl: Kubectl, kind: string, name: string): object { var result = kubectl.getResource(kind, name); - return result.stderr ? null : JSON.parse(result.stdout); + + if (result == null || !!result.stderr) { + return null; + } + + if (!!result.stdout) { + try { + var resource = JSON.parse(result.stdout); + UnsetsClusterSpecficDetails(resource); + return resource; + } catch (ex) { + tl.debug("Exception occurred while Parsing " + resource + " in Json object"); + return null; + } + } + return null; +} + +function UnsetsClusterSpecficDetails(resource: any) { + + if (resource == null) { + return; + } + + // Unsets the cluster specific details in the object + if (!!resource) { + var metadata = resource.metadata; + var status = resource.status; + + if (!!metadata) { + var newMetadata = { + "annotations": metadata.annotations, + "labels": metadata.labels, + "name": metadata.name + }; + + resource.metadata = newMetadata; + } + + if (!!status) { + resource.status = {}; + } + } } -export function fetchCanaryResource(kubectl: Kubectl, kind: string, name: string): object { +function fetchCanaryResource(kubectl: Kubectl, kind: string, name: string): object { return fetchResource(kubectl, kind, getCanaryResourceName(name)); } @@ -73,10 +198,29 @@ function addCanaryLabelsAndAnnotations(inputObject: any, type: string) { helper.updateSpecLabels(inputObject, newLabels, false); } -function getCanaryResourceName(name: string) { - return name + CANARY_SUFFIX; -} +function createCanaryObjectsArgumentString(files: string[]) { + let kindList = new Set(); + let nameList = new Set(); + + files.forEach((filePath: string) => { + var fileContents = fs.readFileSync(filePath); + yaml.safeLoadAll(fileContents, function (inputObject) { + var name = inputObject.metadata.name; + var kind = inputObject.kind; + if (helper.isDeploymentEntity(kind)) { + var canaryObjectName = getCanaryResourceName(name); + var baselineObjectName = getBaselineResourceName(name); + kindList.add(kind); + nameList.add(canaryObjectName); + nameList.add(baselineObjectName); + } + }); + }); -function getBaselineResourceName(name: string) { - return name + BASELINE_SUFFIX; + if (kindList.size == 0) { + tl.debug("CanaryDeploymentHelper : No deployment objects found"); + } + + var args = utils.createKubectlArgs(kindList, nameList); + return args; } \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/src/utils/DeploymentHelper.ts b/Tasks/KubernetesManifestV0/src/utils/DeploymentHelper.ts new file mode 100644 index 000000000000..d431714cdd45 --- /dev/null +++ b/Tasks/KubernetesManifestV0/src/utils/DeploymentHelper.ts @@ -0,0 +1,140 @@ +"use strict"; + +import fs = require("fs"); +import path = require('path'); +import tl = require('vsts-task-lib/task'); +import yaml = require('js-yaml'); +import * as canaryDeploymentHelper from '../utils/CanaryDeploymentHelper'; +import * as KubernetesObjectUtility from '../utils/KubernetesObjectUtility'; +import * as constants from '../models/constants'; +import * as TaskInputParameters from '../models/TaskInputParameters'; +import * as models from '../models/constants'; +import * as fileHelper from "../utils/FileHelper"; +import * as utils from "../utils/utilities"; +import { IExecSyncResult } from 'vsts-task-lib/toolrunner'; +import { Kubectl, Resource } from "kubernetes-common/kubectl-object-model"; + + +export function deploy(kubectl: Kubectl, manifestFilesPath: string, deploymentStrategy: string) { + + // get manifest files + var inputManifestFiles: string[] = getManifestFiles(manifestFilesPath); + + // artifact substitution + inputManifestFiles = updateContainerImagesInManifestFiles(inputManifestFiles, TaskInputParameters.containers); + + // imagePullSecrets addition + inputManifestFiles = updateImagePullSecretsInManifestFiles(inputManifestFiles, TaskInputParameters.imagePullSecrets); + + // deployment + var deployedManifestFiles = deployManifests(inputManifestFiles, kubectl, isCanaryDeploymentStrategy(deploymentStrategy)); + + // check manifest stability + let resourceTypes: Resource[] = KubernetesObjectUtility.getResources(deployedManifestFiles, models.recognizedWorkloadTypes); + checkManifestStability(kubectl, resourceTypes); + + // annotate resources + annotateResources(deployedManifestFiles, kubectl, resourceTypes); +} + +function getManifestFiles(manifestFilesPath: string): string[] { + var files: string[] = utils.getManifestFiles(manifestFilesPath); + + if (files == null || files.length == 0) { + throw (tl.loc("ManifestFileNotFound")); + } + + return files; +} + +function deployManifests(files: string[], kubectl: Kubectl, isCanaryDeploymentStrategy: boolean): string[] { + let result; + if (isCanaryDeploymentStrategy) { + var canaryDeploymentOutput = canaryDeploymentHelper.deployCanary(kubectl, files); + result = canaryDeploymentOutput.result; + files = canaryDeploymentOutput.newFilePaths; + } else { + result = kubectl.apply(files); + } + utils.checkForErrors([result]); + return files; +} + +function checkManifestStability(kubectl: Kubectl, resourceTypes: Resource[]) { + let rolloutStatusResults = []; + resourceTypes.forEach(resource => { + if (models.recognizedWorkloadTypesWithRolloutStatus.indexOf(resource.type.toLowerCase()) >= 0) { + rolloutStatusResults.push(kubectl.checkRolloutStatus(resource.type, resource.name)); + } + }); + utils.checkForErrors(rolloutStatusResults); +} + +function annotateResources(files: string[], kubectl: Kubectl, resourceTypes: Resource[]) { + let annotateResults: IExecSyncResult[] = []; + var allPods = JSON.parse((kubectl.getAllPods()).stdout); + annotateResults.push(kubectl.annotateFiles(files, constants.pipelineAnnotations, true)); + resourceTypes.forEach(resource => { + if (resource.type.toUpperCase() != models.KubernetesWorkload.Pod.toUpperCase()) { + utils.annotateChildPods(kubectl, resource.type, resource.name, allPods) + .forEach(execResult => annotateResults.push(execResult)); + } + }); + utils.checkForErrors(annotateResults, true); +} + +function updateContainerImagesInManifestFiles(filePaths: string[], containers: string[]): string[] { + if (!!containers && containers.length > 0) { + let newFilePaths = []; + const tempDirectory = fileHelper.getTempDirectory(); + filePaths.forEach((filePath: string) => { + var contents = fs.readFileSync(filePath).toString(); + containers.forEach((container: string) => { + let imageName = container.split(":")[0]; + if (imageName.indexOf("@") > 0) + imageName = imageName.split("@")[0]; + if (contents.indexOf(imageName) > 0) { + contents = utils.substituteImageNameInSpecFile(contents, imageName, container); + } + }); + + let fileName = path.join(tempDirectory, path.basename(filePath)); + fs.writeFileSync( + path.join(fileName), + contents + ); + + newFilePaths.push(fileName); + }); + + return newFilePaths; + } + + return filePaths; +} + +function updateImagePullSecretsInManifestFiles(filePaths: string[], imagePullSecrets: string[]): string[] { + if (!!imagePullSecrets && imagePullSecrets.length > 0) { + var newObjectsList = []; + filePaths.forEach((filePath: string) => { + var fileContents = fs.readFileSync(filePath); + yaml.safeLoadAll(fileContents, function (inputObject) { + if (!!inputObject && !!inputObject.kind) { + var kind = inputObject.kind; + if (KubernetesObjectUtility.isDeploymentEntity(kind)) { + KubernetesObjectUtility.updateImagePullSecrets(inputObject, imagePullSecrets, false); + } + newObjectsList.push(inputObject); + } + }); + }); + tl.debug("New K8s objects after addin imagePullSecrets are :"+JSON.stringify(newObjectsList)); + var newFilePaths = fileHelper.writeObjectsToFile(newObjectsList); + return newFilePaths; + } + return filePaths; +} + +function isCanaryDeploymentStrategy(deploymentStrategy: string): boolean { + return deploymentStrategy != null && deploymentStrategy.toUpperCase() == canaryDeploymentHelper.CANARY_DEPLOYMENT_STRATEGY.toUpperCase(); +} diff --git a/Tasks/KubernetesManifestV0/src/utils/FileHelper.ts b/Tasks/KubernetesManifestV0/src/utils/FileHelper.ts index e6e87be240b4..2c1d1375c5fe 100644 --- a/Tasks/KubernetesManifestV0/src/utils/FileHelper.ts +++ b/Tasks/KubernetesManifestV0/src/utils/FileHelper.ts @@ -34,20 +34,37 @@ export function assertFileExists(path: string) { export function writeObjectsToFile(inputObjects: any[]): string[] { let newFilePaths = []; - inputObjects.forEach((inputObject: any) => { - var filePath = inputObject.kind + "_" + inputObject.metadata.name + "_" + getCurrentTime().toString(); - var inputObjectString = JSON.stringify(inputObject); - const tempDirectory = getTempDirectory(); - let fileName = path.join(tempDirectory, path.basename(filePath)); - fs.writeFileSync( - path.join(fileName), - inputObjectString); - newFilePaths.push(fileName); - }); + + if (!!inputObjects) { + inputObjects.forEach((inputObject: any) => { + try { + var inputObjectString = JSON.stringify(inputObject); + + if (!!inputObject.kind && !!inputObject.metadata && !!inputObject.metadata.name) { + let fileName = getManifestFileName(inputObject.kind, inputObject.metadata.name); + fs.writeFileSync(path.join(fileName), inputObjectString); + newFilePaths.push(fileName); + } + else + { + tl.debug("Input object is not proper K8s resource object. Object: "+inputObjectString); + } + } catch (ex) { + tl.debug("Exception occurred while wrting object to file : " + inputObject + " . Exception: " + ex); + } + }); + } return newFilePaths; } +function getManifestFileName(kind: string, name: string) { + var filePath = kind + "_" + name + "_" + getCurrentTime().toString(); + const tempDirectory = getTempDirectory(); + var fileName = path.join(tempDirectory, path.basename(filePath)); + return fileName; +} + function getCurrentTime(): number { return new Date().getTime(); } diff --git a/Tasks/KubernetesManifestV0/src/utils/KubernetesObjectUtility.ts b/Tasks/KubernetesManifestV0/src/utils/KubernetesObjectUtility.ts index 62e76d69bbac..eaa619118ccf 100644 --- a/Tasks/KubernetesManifestV0/src/utils/KubernetesObjectUtility.ts +++ b/Tasks/KubernetesManifestV0/src/utils/KubernetesObjectUtility.ts @@ -2,11 +2,21 @@ import fs = require("fs"); import tl = require('vsts-task-lib/task'); import yaml = require('js-yaml'); -import { Resource } from "utility-common/kubectl-object-model"; -import { KubernetesWorkload } from "../models/constants" +import { Resource } from "kubernetes-common/kubectl-object-model"; +import { KubernetesWorkload, recognizedWorkloadTypes } from "../models/constants"; import * as utils from "../utils/utilities" import { StringComparer } from "../utils/utilities" +export function isDeploymentEntity(kind: string): boolean { + if (!kind) { + throw (tl.loc("ResourceKindNotDefined")); + } + + return recognizedWorkloadTypes.some(function (elem) { + return utils.isEqual(elem, kind, utils.StringComparer.OrdinalIgnoreCase); + }); +} + export function getReplicaCount(inputObject: any): any { if (!inputObject) { throw (tl.loc("NullInputObject")); @@ -82,6 +92,44 @@ export function updateObjectAnnotations(inputObject: any, newAnnotations: Map { + var newImagePullSecretsObject = { + "name": imagePullSecret + }; + + newImagePullSecretsObjects.push(newImagePullSecretsObject); + }); + + var existingImagePullSecretObjects: any = getImagePullSecrets(inputObject); + + if (override) { + existingImagePullSecretObjects = newImagePullSecretsObjects; + } else { + if (!existingImagePullSecretObjects) { + existingImagePullSecretObjects = new Array(); + } + + existingImagePullSecretObjects = existingImagePullSecretObjects.concat(newImagePullSecretsObjects); + } + + setImagePullSecrets(inputObject, existingImagePullSecretObjects); +} + export function updateSpecLabels(inputObject: any, newLabels: Map, override: boolean) { if (!inputObject) { throw (tl.loc("NullInputObject")); @@ -95,8 +143,7 @@ export function updateSpecLabels(inputObject: any, newLabels: Map { var fileContents = fs.readFileSync(filePath); yaml.safeLoadAll(fileContents, function (inputObject) { - - if (filterResourceTypes.filter(type => utils.isEqual(inputObject.kind, type, StringComparer.OrdinalIgnoreCase)).length > 0) { + let inputObjectKind = inputObject ? inputObject.kind : ""; + if (filterResourceTypes.filter(type => utils.isEqual(inputObjectKind, type, StringComparer.OrdinalIgnoreCase)).length > 0) { var resource = { type: inputObject.kind, name: inputObject.metadata.name @@ -173,16 +219,58 @@ export function getResources(filePaths: string[], filterResourceTypes: string[]) function getSpecLabels(inputObject: any) { - if (!!inputObject && !!inputObject.spec && !!inputObject.spec.template && !!inputObject.spec.template.metadata) { + if (!inputObject) { + return null; + } + + if (utils.isEqual(inputObject.kind, KubernetesWorkload.Pod, StringComparer.OrdinalIgnoreCase)) { + return inputObject.metadata.labels + } + if (!!inputObject.spec && !!inputObject.spec.template && !!inputObject.spec.template.metadata) { return inputObject.spec.template.metadata.labels; } return null; } +function getImagePullSecrets(inputObject: any) { + + if (!inputObject || !inputObject.spec) { + return null; + } + + if (utils.isEqual(inputObject.kind, KubernetesWorkload.Pod, StringComparer.OrdinalIgnoreCase)) { + return inputObject.spec.imagePullSecrets + } + + if (!!inputObject.spec.template && !!inputObject.spec.template.spec) { + return inputObject.spec.template.spec.imagePullSecrets; + } + + return null; +} + +function setImagePullSecrets(inputObject: any, newImagePullSecrets: any) { + if (!inputObject || !inputObject.spec || !newImagePullSecrets) { + return; + } + + if (utils.isEqual(inputObject.kind, KubernetesWorkload.Pod, StringComparer.OrdinalIgnoreCase)) { + inputObject.spec.imagePullSecrets = newImagePullSecrets; + return; + } + + if (!!inputObject.spec.template && !!inputObject.spec.template.spec) { + inputObject.spec.template.spec.imagePullSecrets = newImagePullSecrets; + return; + } + + return; +} + function setSpecLabels(inputObject: any, newLabels: any) { var specLabels = getSpecLabels(inputObject); - if (!!specLabels) { + if (!!newLabels) { specLabels = newLabels; } } diff --git a/Tasks/KubernetesManifestV0/src/utils/utilities.ts b/Tasks/KubernetesManifestV0/src/utils/utilities.ts index f5d7a3a93888..bc2327c0f676 100644 --- a/Tasks/KubernetesManifestV0/src/utils/utilities.ts +++ b/Tasks/KubernetesManifestV0/src/utils/utilities.ts @@ -1,18 +1,23 @@ "use strict"; import * as tl from "vsts-task-lib/task"; -import { ToolRunner, IExecOptions, IExecSyncResult } from 'vsts-task-lib/toolrunner'; +import { IExecSyncResult } from 'vsts-task-lib/toolrunner'; import kubectlutility = require("utility-common/kubectlutility"); -import { Kubectl } from "utility-common/kubectl-object-model"; +import { Kubectl } from "kubernetes-common/kubectl-object-model"; import { pipelineAnnotations } from "../models/constants" export enum StringComparer { Ordinal, OrdinalIgnoreCase } -export function execCommand(command: ToolRunner, options?: IExecOptions) { - command.on("errline", tl.error); - return command.execSync(options); +export function getManifestFiles(manifestFilesPath: string): string[] { + if (!manifestFilesPath || manifestFilesPath.trim().length == 0) { + tl.debug("file input is not present"); + return null; + } + + var files = tl.findMatch(tl.getVariable("System.DefaultWorkingDirectory") || process.cwd(), manifestFilesPath.trim()); + return files; } export async function getKubectl(): Promise { @@ -23,6 +28,37 @@ export async function getKubectl(): Promise { } } +export function createKubectlArgs(kinds: Set, names: Set): string { + let args = ""; + if (!!kinds && kinds.size > 0) { + args = args + createInlineArray(Array.from(kinds.values())); + } + + if (!!names && names.size > 0) { + args = args + " " + Array.from(names.values()).join(" ") + } + + return args; +} + +export function getDeleteCmdArgs(argsPrefix: string, inputArgs: string): string { + let args = ""; + + if (!!argsPrefix && argsPrefix.length > 0) { + args = argsPrefix; + } + + if (!!inputArgs && inputArgs.length > 0) { + if (args.length > 0) { + args = args + " "; + } + + args = args + inputArgs; + } + + return args; +} + export function checkForErrors(execResults: IExecSyncResult[], warnIfError?: boolean) { if (execResults.length != 0) { var stderr = ""; @@ -41,10 +77,10 @@ export function checkForErrors(execResults: IExecSyncResult[], warnIfError?: boo } } -export function annotateChildPods(kubectl: Kubectl, resourceType, resourceName, allPods): IExecSyncResult[] { +export function annotateChildPods(kubectl: Kubectl, resourceType: string, resourceName: string, allPods): IExecSyncResult[] { let commandExecutionResults = []; var owner = resourceName; - if (resourceType.indexOf("deployment") > -1) { + if (resourceType.toLowerCase().indexOf("deployment") > -1) { owner = kubectl.getNewReplicaSet(resourceName); } @@ -122,3 +158,8 @@ export function isEqual(str1: string, str2: string, stringComparer: StringCompar return str1 === str2; } } + +function createInlineArray(str: string | string[]): string { + if (typeof str === "string") return str; + return str.join(","); +} diff --git a/Tasks/KubernetesManifestV0/task.json b/Tasks/KubernetesManifestV0/task.json index 75fbae977031..3a2b10db2905 100644 --- a/Tasks/KubernetesManifestV0/task.json +++ b/Tasks/KubernetesManifestV0/task.json @@ -1,8 +1,8 @@ { "id": "DEE316A2-586F-4DEF-BE79-488A1F503DFE", "name": "KubernetesManifest", - "friendlyName": "Manifest based Kubernetes deployments", - "description": "Manifest based deployments to kubernetes", + "friendlyName": "Kubernetes manifests", + "description": "Manifest based deployments to Kubernetes", "helpUrl": "https://go.microsoft.com/fwlink/?linkid=851275", "helpMarkDown": "[More Information](https://go.microsoft.com/fwlink/?linkid=851275)", "category": "Deploy", @@ -14,8 +14,8 @@ "author": "Microsoft Corporation", "version": { "Major": 0, - "Minor": 150, - "Patch": 0 + "Minor": 151, + "Patch": 1 }, "demands": [], "groups": [ @@ -33,23 +33,9 @@ ], "inputs": [ { - "name": "connectionType", - "type": "pickList", - "label": "Service connection type", - "defaultValue": "Kubernetes Service Connection", - "required": true, - "options": { - "Kubernetes Service Connection": "Kubernetes Service Connection", - "None": "None" - }, - "groupName": "kubernetesCluster", - "helpMarkDown": "Select a service connection type." - }, - { - "name": "kubernetesServiceEndpoint", + "name": "kubernetesServiceConnection", "type": "connectedService:kubernetes", "label": "Kubernetes service connection", - "visibleRule": "connectionType = Kubernetes Service Connection", "helpMarkDown": "Select a Kubernetes service connection.", "groupName": "kubernetesCluster", "required": true @@ -72,28 +58,31 @@ "groupName": "config", "options": { "bake": "bake", + "createSecret": "create secret", + "delete": "delete", "deploy": "deploy", "patch": "patch", + "promote": "promote", "scale": "scale", - "delete": "delete" + "reject": "reject" }, "helpMarkDown": "Choose the action to be performed." }, { - "name": "deploymentStrategy", + "name": "strategy", "type": "pickList", "label": "Strategy", "required": false, "groupName": "config", - "defaultValue": "None", + "defaultValue": "none", "options": { - "canary": "Canary", - "None": "None" + "canary": "Canary", + "none": "None" }, - "helpMarkDown": "Strategy for deployment", - "visibleRule": "action = deploy" - }, - { + "helpMarkDown": "Deployment strategy to be used", + "visibleRule": "action = deploy || action = promote || action = reject" + }, + { "name": "percentage", "type": "string", "label": "Percentage", @@ -101,12 +90,12 @@ "groupName": "config", "helpMarkDown": "", "defaultValue": 0, - "visibleRule": "deploymentStrategy = Canary", + "visibleRule": "strategy = Canary && action = deploy", "validation": { - "expression": "isMatch(value, '(^(([0-9]|[1-9][0-9]|100)(\\.\\d{1,2})?)$)','Multiline')", - "message": "Enter valid percentage value i.e between 0 to 100." + "expression": "isMatch(value, '(^(([0-9]|[1-9][0-9]|100)(\\.\\d{1,2})?)$)','Multiline')", + "message": "Enter valid percentage value i.e between 0 to 100." } - }, + }, { "name": "manifests", "type": "filePath", @@ -115,7 +104,7 @@ "defaultValue": "", "groupName": "config", "helpMarkDown": "Manifests to deploy", - "visibleRule": "action = deploy" + "visibleRule": "action = deploy || action = promote || action = reject" }, { "name": "containers", @@ -125,7 +114,17 @@ "defaultValue": "", "groupName": "config", "helpMarkDown": "Containers", - "visibleRule": "action = deploy" + "visibleRule": "action = deploy || action = promote" + }, + { + "name": "imagePullSecrets", + "type": "multiLine", + "label": "ImagePullSecrets", + "required": false, + "defaultValue": "", + "groupName": "config", + "helpMarkDown": "ImagePullSecret to pull image from private registry", + "visibleRule": "action = deploy || action = promote" }, { "name": "renderType", @@ -240,14 +239,13 @@ "visibleRule": "action = patch" }, { - "name": "args", + "name": "arguments", "type": "string", "label": "Arguments", - "required": true, "defaultValue": "", "groupName": "config", "helpMarkDown": "Arguments for `kubectl delete` command", - "visibleRule": "action = delete" + "visibleRule": "action = delete || action = reject" }, { "name": "patch", @@ -257,6 +255,52 @@ "groupName": "config", "helpMarkDown": "Contents of patch", "visibleRule": "action = patch" + }, + { + "name": "secretType", + "type": "pickList", + "label": "Type of secret", + "defaultValue": "dockerRegistry", + "required": true, + "visibleRule": "action = createSecret", + "groupName": "config", + "options": { + "dockerRegistry": "dockerRegistry", + "generic": "generic" + }, + "helpMarkDown": "Create/update a generic or docker imagepullsecret. Select dockerRegistry to create/update the imagepullsecret of the selected registry. An imagePullSecret is a way to pass a secret that contains a container registry password to the Kubelet so it can pull a private image on behalf of your Pod." + }, + { + "name": "secretName", + "type": "string", + "label": "Secret name", + "required": false, + "groupName": "config", + "visibleRule": "action = createSecret", + "defaultValue": "", + "helpMarkDown": "Name of the secret. You can use this secret name in the Kubernetes YAML configuration file." + }, + { + "name": "secretArguments", + "type": "multiLine", + "groupName": "config", + "properties": { + "resizable": "true", + "rows": "2", + "editorExtension": "ms.vss-services-azure.kubernetes-parameters-grid" + }, + "label": "Arguments", + "defaultValue": "", + "helpMarkDown": "Specify keys and literal values to insert in secret.For example, --from-literal=key1=value1 --from-literal=key2=\"top secret\".", + "visibleRule": "action = createSecret && secretType = generic" + }, + { + "name": "dockerRegistryEndpoint", + "type": "connectedService:dockerregistry", + "groupName": "config", + "label": "Docker registry service connection", + "helpMarkDown": "Select a Docker registry service connection. Required for commands that need to authenticate with a registry.", + "visibleRule": "action = createSecret && secretType = dockerRegistry" } ], "dataSourceBindings": [], @@ -283,7 +327,10 @@ "UnknownRenderType": "Unknown render engine", "ResourceKindNotDefined": "Resource kind is null", "NullInputObject": "Input object is null.", + "ArgumentsInputNotSupplied": "Arguments are not supplied.", "NullInputObjectMetadata": "Input object metadata is null.", - "CanaryDeploymentAlreadyExistErrorMessage": "Canary deployment already exists. Rejecting this deployment" + "CanaryDeploymentAlreadyExistErrorMessage": "Canary deployment already exists. Rejecting this deployment.", + "InvalidRejectActionDeploymentStrategy": "Reject action works only with strategy: canary", + "InvalidPromotetActionDeploymentStrategy": "Promote action works only with strategy: canary" } } \ No newline at end of file diff --git a/Tasks/KubernetesManifestV0/task.loc.json b/Tasks/KubernetesManifestV0/task.loc.json index 6353ec8ec9c3..3ca03c0c6fa9 100644 --- a/Tasks/KubernetesManifestV0/task.loc.json +++ b/Tasks/KubernetesManifestV0/task.loc.json @@ -14,8 +14,8 @@ "author": "Microsoft Corporation", "version": { "Major": 0, - "Minor": 150, - "Patch": 0 + "Minor": 151, + "Patch": 1 }, "demands": [], "groups": [ @@ -33,24 +33,10 @@ ], "inputs": [ { - "name": "connectionType", - "type": "pickList", - "label": "ms-resource:loc.input.label.connectionType", - "defaultValue": "Kubernetes Service Connection", - "required": true, - "options": { - "Kubernetes Service Connection": "Kubernetes Service Connection", - "None": "None" - }, - "groupName": "kubernetesCluster", - "helpMarkDown": "ms-resource:loc.input.help.connectionType" - }, - { - "name": "kubernetesServiceEndpoint", + "name": "kubernetesServiceConnection", "type": "connectedService:kubernetes", - "label": "ms-resource:loc.input.label.kubernetesServiceEndpoint", - "visibleRule": "connectionType = Kubernetes Service Connection", - "helpMarkDown": "ms-resource:loc.input.help.kubernetesServiceEndpoint", + "label": "ms-resource:loc.input.label.kubernetesServiceConnection", + "helpMarkDown": "ms-resource:loc.input.help.kubernetesServiceConnection", "groupName": "kubernetesCluster", "required": true }, @@ -72,26 +58,29 @@ "groupName": "config", "options": { "bake": "bake", + "createSecret": "create secret", + "delete": "delete", "deploy": "deploy", "patch": "patch", + "promote": "promote", "scale": "scale", - "delete": "delete" + "reject": "reject" }, "helpMarkDown": "ms-resource:loc.input.help.action" }, { - "name": "deploymentStrategy", + "name": "strategy", "type": "pickList", - "label": "ms-resource:loc.input.label.deploymentStrategy", + "label": "ms-resource:loc.input.label.strategy", "required": false, "groupName": "config", - "defaultValue": "None", + "defaultValue": "none", "options": { "canary": "Canary", - "None": "None" + "none": "None" }, - "helpMarkDown": "ms-resource:loc.input.help.deploymentStrategy", - "visibleRule": "action = deploy" + "helpMarkDown": "ms-resource:loc.input.help.strategy", + "visibleRule": "action = deploy || action = promote || action = reject" }, { "name": "percentage", @@ -101,7 +90,7 @@ "groupName": "config", "helpMarkDown": "", "defaultValue": 0, - "visibleRule": "deploymentStrategy = Canary", + "visibleRule": "strategy = Canary && action = deploy", "validation": { "expression": "isMatch(value, '(^(([0-9]|[1-9][0-9]|100)(\\.\\d{1,2})?)$)','Multiline')", "message": "Enter valid percentage value i.e between 0 to 100." @@ -115,7 +104,7 @@ "defaultValue": "", "groupName": "config", "helpMarkDown": "ms-resource:loc.input.help.manifests", - "visibleRule": "action = deploy" + "visibleRule": "action = deploy || action = promote || action = reject" }, { "name": "containers", @@ -125,7 +114,17 @@ "defaultValue": "", "groupName": "config", "helpMarkDown": "ms-resource:loc.input.help.containers", - "visibleRule": "action = deploy" + "visibleRule": "action = deploy || action = promote" + }, + { + "name": "imagePullSecrets", + "type": "multiLine", + "label": "ms-resource:loc.input.label.imagePullSecrets", + "required": false, + "defaultValue": "", + "groupName": "config", + "helpMarkDown": "ms-resource:loc.input.help.imagePullSecrets", + "visibleRule": "action = deploy || action = promote" }, { "name": "renderType", @@ -240,14 +239,13 @@ "visibleRule": "action = patch" }, { - "name": "args", + "name": "arguments", "type": "string", - "label": "ms-resource:loc.input.label.args", - "required": true, + "label": "ms-resource:loc.input.label.arguments", "defaultValue": "", "groupName": "config", - "helpMarkDown": "ms-resource:loc.input.help.args", - "visibleRule": "action = delete" + "helpMarkDown": "ms-resource:loc.input.help.arguments", + "visibleRule": "action = delete || action = reject" }, { "name": "patch", @@ -257,6 +255,52 @@ "groupName": "config", "helpMarkDown": "ms-resource:loc.input.help.patch", "visibleRule": "action = patch" + }, + { + "name": "secretType", + "type": "pickList", + "label": "ms-resource:loc.input.label.secretType", + "defaultValue": "dockerRegistry", + "required": true, + "visibleRule": "action = createSecret", + "groupName": "config", + "options": { + "dockerRegistry": "dockerRegistry", + "generic": "generic" + }, + "helpMarkDown": "ms-resource:loc.input.help.secretType" + }, + { + "name": "secretName", + "type": "string", + "label": "ms-resource:loc.input.label.secretName", + "required": false, + "groupName": "config", + "visibleRule": "action = createSecret", + "defaultValue": "", + "helpMarkDown": "ms-resource:loc.input.help.secretName" + }, + { + "name": "secretArguments", + "type": "multiLine", + "groupName": "config", + "properties": { + "resizable": "true", + "rows": "2", + "editorExtension": "ms.vss-services-azure.kubernetes-parameters-grid" + }, + "label": "ms-resource:loc.input.label.secretArguments", + "defaultValue": "", + "helpMarkDown": "ms-resource:loc.input.help.secretArguments", + "visibleRule": "action = createSecret && secretType = generic" + }, + { + "name": "dockerRegistryEndpoint", + "type": "connectedService:dockerregistry", + "groupName": "config", + "label": "ms-resource:loc.input.label.dockerRegistryEndpoint", + "helpMarkDown": "ms-resource:loc.input.help.dockerRegistryEndpoint", + "visibleRule": "action = createSecret && secretType = dockerRegistry" } ], "dataSourceBindings": [], @@ -283,7 +327,10 @@ "UnknownRenderType": "ms-resource:loc.messages.UnknownRenderType", "ResourceKindNotDefined": "ms-resource:loc.messages.ResourceKindNotDefined", "NullInputObject": "ms-resource:loc.messages.NullInputObject", + "ArgumentsInputNotSupplied": "ms-resource:loc.messages.ArgumentsInputNotSupplied", "NullInputObjectMetadata": "ms-resource:loc.messages.NullInputObjectMetadata", - "CanaryDeploymentAlreadyExistErrorMessage": "ms-resource:loc.messages.CanaryDeploymentAlreadyExistErrorMessage" + "CanaryDeploymentAlreadyExistErrorMessage": "ms-resource:loc.messages.CanaryDeploymentAlreadyExistErrorMessage", + "InvalidRejectActionDeploymentStrategy": "ms-resource:loc.messages.InvalidRejectActionDeploymentStrategy", + "InvalidPromotetActionDeploymentStrategy": "ms-resource:loc.messages.InvalidPromotetActionDeploymentStrategy" } } \ No newline at end of file diff --git a/Tasks/KubernetesV0/Tests/TestSetup.ts b/Tasks/KubernetesV0/Tests/TestSetup.ts index e46f05eadc56..e21366cd5a98 100644 --- a/Tasks/KubernetesV0/Tests/TestSetup.ts +++ b/Tasks/KubernetesV0/Tests/TestSetup.ts @@ -62,7 +62,7 @@ process.env["ENDPOINT_DATA_AzureRMSpn_SUBSCRIPTIONID"] = "sId"; process.env["ENDPOINT_DATA_AzureRMSpn_SPNOBJECTID"] = "oId"; // provide answers for task mock -let a = { +let a: ma.TaskLibAnswers = { "which" : { }, "checkPath": { @@ -154,8 +154,10 @@ a.exec[`kubectl --kubeconfig ${KubconfigFile} logs nginx`] = { "code": 0 }; +process.env["MOCK_NORMALIZE_SLASHES"] = "true"; tr.setAnswers(a); +tr.registerMock('vsts-task-lib/toolrunner', require('vsts-task-lib/mock-toolrunner')); // Create mock for fs module let fs = require('fs'); let fsClone = Object.assign({}, fs); @@ -219,7 +221,6 @@ fsClone.statSync = (s: string) => { return stat; } - tr.registerMock('fs', fsClone); var ut = require('../src/utilities'); diff --git a/Tasks/KubernetesV1/task.json b/Tasks/KubernetesV1/task.json index 40fd9fe0e57f..072e39b26ef5 100644 --- a/Tasks/KubernetesV1/task.json +++ b/Tasks/KubernetesV1/task.json @@ -14,7 +14,7 @@ "version": { "Major": 1, "Minor": 150, - "Patch": 5 + "Patch": 6 }, "demands": [], "releaseNotes": "What's new in Version 1.0:
 Added new service connection type input for easy selection of Azure AKS cluster.
 Replaced output variable input with output variables section that we had added in all tasks.", diff --git a/Tasks/NpmV1/task.json b/Tasks/NpmV1/task.json index 66790c982c77..18b53f2f3835 100644 --- a/Tasks/NpmV1/task.json +++ b/Tasks/NpmV1/task.json @@ -10,7 +10,7 @@ "version": { "Major": 1, "Minor": 150, - "Patch": 1 + "Patch": 2 }, "runsOn": [ "Agent", diff --git a/Tasks/NuGetCommandV2/task.json b/Tasks/NuGetCommandV2/task.json index dd9c7b901175..a46676fa259f 100644 --- a/Tasks/NuGetCommandV2/task.json +++ b/Tasks/NuGetCommandV2/task.json @@ -10,7 +10,7 @@ "version": { "Major": 2, "Minor": 150, - "Patch": 1 + "Patch": 2 }, "runsOn": [ "Agent", diff --git a/Tasks/NuGetV0/task.json b/Tasks/NuGetV0/task.json index eeaf007c398b..ce43200031e2 100644 --- a/Tasks/NuGetV0/task.json +++ b/Tasks/NuGetV0/task.json @@ -11,7 +11,7 @@ "version": { "Major": 0, "Minor": 150, - "Patch": 1 + "Patch": 2 }, "runsOn": [ "Agent", diff --git a/Tasks/PipAuthenticateV0/task.json b/Tasks/PipAuthenticateV0/task.json index 5c1b4069dc89..291cd9fc085c 100644 --- a/Tasks/PipAuthenticateV0/task.json +++ b/Tasks/PipAuthenticateV0/task.json @@ -10,7 +10,7 @@ "version": { "Major": 0, "Minor": 150, - "Patch": 1 + "Patch": 2 }, "runsOn": [ "Agent", diff --git a/Tasks/TwineAuthenticateV0/task.json b/Tasks/TwineAuthenticateV0/task.json index 084958ab42d0..a2ba02b5a93e 100644 --- a/Tasks/TwineAuthenticateV0/task.json +++ b/Tasks/TwineAuthenticateV0/task.json @@ -10,7 +10,7 @@ "version": { "Major": 0, "Minor": 150, - "Patch": 1 + "Patch": 2 }, "runsOn": [ "Agent", diff --git a/Tasks/UniversalPackagesV0/task.json b/Tasks/UniversalPackagesV0/task.json index 2d00270214f9..63897d1d7c83 100644 --- a/Tasks/UniversalPackagesV0/task.json +++ b/Tasks/UniversalPackagesV0/task.json @@ -10,7 +10,7 @@ "version": { "Major": 0, "Minor": 150, - "Patch": 1 + "Patch": 2 }, "runsOn": [ "Agent", diff --git a/package-lock.json b/package-lock.json index 654c4b4948e4..813cafed150c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -25,7 +25,7 @@ "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", "dev": true, "requires": { - "sprintf-js": "1.0.3" + "sprintf-js": "~1.0.2" } }, "asap": { @@ -52,7 +52,7 @@ "integrity": "sha1-wHshHHyVLsH479Uad+8NHTmQopI=", "dev": true, "requires": { - "balanced-match": "1.0.0", + "balanced-match": "^1.0.0", "concat-map": "0.0.1" } }, @@ -92,9 +92,9 @@ "integrity": "sha1-CqxmL9Ur54lk1VMvaUeE5wEQrPc=", "dev": true, "requires": { - "inherits": "2.0.3", - "readable-stream": "2.3.3", - "typedarray": "0.0.6" + "inherits": "^2.0.3", + "readable-stream": "^2.2.2", + "typedarray": "^0.0.6" }, "dependencies": { "isarray": { @@ -109,13 +109,13 @@ "integrity": "sha1-No8lEtefnUb9/HE0mueHi7weuVw=", "dev": true, "requires": { - "core-util-is": "1.0.2", - "inherits": "2.0.3", - "isarray": "1.0.0", - "process-nextick-args": "1.0.7", - "safe-buffer": "5.1.1", - "string_decoder": "1.0.3", - "util-deprecate": "1.0.2" + "core-util-is": "~1.0.0", + "inherits": "~2.0.3", + "isarray": "~1.0.0", + "process-nextick-args": "~1.0.6", + "safe-buffer": "~5.1.1", + "string_decoder": "~1.0.3", + "util-deprecate": "~1.0.1" } }, "string_decoder": { @@ -124,7 +124,7 @@ "integrity": "sha1-D8Z9fBQYJd6UKC3VNr7GubzoYKs=", "dev": true, "requires": { - "safe-buffer": "5.1.1" + "safe-buffer": "~5.1.0" } } } @@ -174,7 +174,7 @@ "integrity": "sha1-opnv/TNf4nIeuujiV+x5ZE/IUzc=", "dev": true, "requires": { - "fill-range": "2.2.3" + "fill-range": "^2.1.0" }, "dependencies": { "fill-range": { @@ -183,11 +183,11 @@ "integrity": "sha1-ULd9/X5Gm8dJJHCWNpn+eoSFpyM=", "dev": true, "requires": { - "is-number": "2.1.0", - "isobject": "2.1.0", - "randomatic": "1.1.7", - "repeat-element": "1.1.2", - "repeat-string": "1.6.1" + "is-number": "^2.1.0", + "isobject": "^2.0.0", + "randomatic": "^1.1.3", + "repeat-element": "^1.1.2", + "repeat-string": "^1.5.2" } }, "is-number": { @@ -196,7 +196,7 @@ "integrity": "sha1-Afy7s5NGOlSPL0ZszhbezknbkI8=", "dev": true, "requires": { - "kind-of": "3.2.2" + "kind-of": "^3.0.2" } }, "isarray": { @@ -220,7 +220,7 @@ "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=", "dev": true, "requires": { - "is-buffer": "1.1.6" + "is-buffer": "^1.1.5" } } } @@ -231,7 +231,7 @@ "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=", "dev": true, "requires": { - "is-extendable": "0.1.1" + "is-extendable": "^0.1.0" } }, "for-in": { @@ -246,11 +246,11 @@ "integrity": "sha1-MELZrewqHe1qdwep7SOA+KF6Qw4=", "dev": true, "requires": { - "ansi-red": "0.1.1", - "coffee-script": "1.12.7", - "extend-shallow": "2.0.1", - "js-yaml": "3.10.0", - "toml": "2.3.3" + "ansi-red": "^0.1.1", + "coffee-script": "^1.12.4", + "extend-shallow": "^2.0.1", + "js-yaml": "^3.8.1", + "toml": "^2.3.2" } }, "growl": { @@ -265,9 +265,9 @@ "integrity": "sha1-jORHvbW2xXf4pj4/p4BW7Eu02/s=", "dev": true, "requires": { - "caseless": "0.11.0", - "concat-stream": "1.6.0", - "http-response-object": "1.1.0" + "caseless": "~0.11.0", + "concat-stream": "^1.4.6", + "http-response-object": "^1.0.0" } }, "http-response-object": { @@ -300,7 +300,7 @@ "integrity": "sha1-JP1iAaR4LPUFYcgQJ2r8fRLXEZU=", "dev": true, "requires": { - "kind-of": "3.2.2" + "kind-of": "^3.0.2" }, "dependencies": { "kind-of": { @@ -309,7 +309,7 @@ "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=", "dev": true, "requires": { - "is-buffer": "1.1.6" + "is-buffer": "^1.1.5" } } } @@ -320,7 +320,7 @@ "integrity": "sha1-LBY7P6+xtgbZ0Xko8FwqHDjgdnc=", "dev": true, "requires": { - "isobject": "3.0.1" + "isobject": "^3.0.1" } }, "isobject": { @@ -359,8 +359,8 @@ "integrity": "sha512-O2v52ffjLa9VeM43J4XocZE//WT9N0IiwDa3KSHH7Tu8CtH+1qM8SIZvnsTh6v+4yFy5KUY3BHUVwjpfAWsjIA==", "dev": true, "requires": { - "argparse": "1.0.10", - "esprima": "4.0.0" + "argparse": "^1.0.7", + "esprima": "^4.0.0" } }, "lazy-cache": { @@ -369,7 +369,7 @@ "integrity": "sha1-uRkKT5EzVGlIQIWfio9whNiCImQ=", "dev": true, "requires": { - "set-getter": "0.1.0" + "set-getter": "^0.1.0" } }, "list-item": { @@ -378,10 +378,10 @@ "integrity": "sha1-DGXQDih8tmPMs8s4Sad+iewmilY=", "dev": true, "requires": { - "expand-range": "1.8.2", - "extend-shallow": "2.0.1", - "is-number": "2.1.0", - "repeat-string": "1.6.1" + "expand-range": "^1.8.1", + "extend-shallow": "^2.0.1", + "is-number": "^2.1.0", + "repeat-string": "^1.5.2" }, "dependencies": { "is-number": { @@ -390,7 +390,7 @@ "integrity": "sha1-Afy7s5NGOlSPL0ZszhbezknbkI8=", "dev": true, "requires": { - "kind-of": "3.2.2" + "kind-of": "^3.0.2" } }, "kind-of": { @@ -399,7 +399,7 @@ "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=", "dev": true, "requires": { - "is-buffer": "1.1.6" + "is-buffer": "^1.1.5" } } } @@ -422,18 +422,18 @@ "integrity": "sha512-eOsq7EGd3asV0oBfmyqngeEIhrbkc7XVP63OwcJBIhH2EpG2PzFcbZdhy1jutXSlRBBVMNXHvMtSr5LAxSUvUg==", "dev": true, "requires": { - "concat-stream": "1.6.0", - "diacritics-map": "0.1.0", - "gray-matter": "2.1.1", - "lazy-cache": "2.0.2", - "list-item": "1.1.1", - "markdown-link": "0.1.1", - "minimist": "1.2.0", - "mixin-deep": "1.3.1", - "object.pick": "1.3.0", - "remarkable": "1.7.1", - "repeat-string": "1.6.1", - "strip-color": "0.1.0" + "concat-stream": "^1.5.2", + "diacritics-map": "^0.1.0", + "gray-matter": "^2.1.0", + "lazy-cache": "^2.0.2", + "list-item": "^1.1.1", + "markdown-link": "^0.1.1", + "minimist": "^1.2.0", + "mixin-deep": "^1.1.3", + "object.pick": "^1.2.0", + "remarkable": "^1.7.1", + "repeat-string": "^1.6.1", + "strip-color": "^0.1.0" }, "dependencies": { "minimist": { @@ -450,9 +450,9 @@ "integrity": "sha1-U6s41f48iJG6RlMp6iP6wFQBJvk=", "dev": true, "requires": { - "charenc": "0.0.2", - "crypt": "0.0.2", - "is-buffer": "1.1.6" + "charenc": "~0.0.1", + "crypt": "~0.0.1", + "is-buffer": "~1.1.1" } }, "minimatch": { @@ -461,7 +461,7 @@ "integrity": "sha1-DzmKcwDqRB6cNIyD2Yq4ydv5xAo=", "dev": true, "requires": { - "brace-expansion": "1.1.8" + "brace-expansion": "^1.0.0" } }, "minimist": { @@ -476,8 +476,8 @@ "integrity": "sha512-8ZItLHeEgaqEvd5lYBXfm4EZSFCX29Jb9K+lAHhDKzReKBQKj3R+7NOF6tjqYi9t4oI8VUfaWITJQm86wnXGNQ==", "dev": true, "requires": { - "for-in": "1.0.2", - "is-extendable": "1.0.1" + "for-in": "^1.0.2", + "is-extendable": "^1.0.1" }, "dependencies": { "is-extendable": { @@ -486,7 +486,7 @@ "integrity": "sha512-arnXMxT1hhoKo9k1LZdmlNyJdDDfy2v0fXjFlmok4+i8ul/6WlbVge9bhM74OpNPQPMGUToDtz+KXa1PneJxOA==", "dev": true, "requires": { - "is-plain-object": "2.0.4" + "is-plain-object": "^2.0.4" } } } @@ -546,9 +546,9 @@ "integrity": "sha1-4xPusknHr/qlxHUoaw4RW1mDlGc=", "dev": true, "requires": { - "graceful-fs": "2.0.3", - "inherits": "2.0.3", - "minimatch": "0.2.14" + "graceful-fs": "~2.0.0", + "inherits": "2", + "minimatch": "~0.2.11" } }, "graceful-fs": { @@ -563,8 +563,8 @@ "integrity": "sha1-x054BXT2PG+aCQ6Q775u9TpqdWo=", "dev": true, "requires": { - "lru-cache": "2.7.3", - "sigmund": "1.0.1" + "lru-cache": "2", + "sigmund": "~1.0.0" } }, "minimist": { @@ -602,11 +602,11 @@ "integrity": "sha1-LlFJ7UD8XS48px5C21qx/snG2Fw=", "dev": true, "requires": { - "debug": "2.6.9", - "md5": "2.2.1", - "mkdirp": "0.5.1", - "strip-ansi": "4.0.0", - "xml": "1.0.1" + "debug": "^2.2.0", + "md5": "^2.1.0", + "mkdirp": "~0.5.1", + "strip-ansi": "^4.0.0", + "xml": "^1.0.0" }, "dependencies": { "ansi-regex": { @@ -621,7 +621,7 @@ "integrity": "sha1-qEeQIusaw2iocTibY1JixQXuNo8=", "dev": true, "requires": { - "ansi-regex": "3.0.0" + "ansi-regex": "^3.0.0" } } } @@ -644,7 +644,7 @@ "integrity": "sha1-h6EKxMFpS9Lhy/U1kaZhQftd10c=", "dev": true, "requires": { - "isobject": "3.0.1" + "isobject": "^3.0.1" } }, "process-nextick-args": { @@ -659,7 +659,7 @@ "integrity": "sha1-BktyYCsY+Q8pGSuLG8QY/9Hr078=", "dev": true, "requires": { - "asap": "2.0.6" + "asap": "~2.0.3" } }, "q": { @@ -680,8 +680,8 @@ "integrity": "sha1-x6vpzIuHwLqodrGf3oP9RkeX44w=", "dev": true, "requires": { - "is-number": "3.0.0", - "kind-of": "4.0.0" + "is-number": "^3.0.0", + "kind-of": "^4.0.0" }, "dependencies": { "kind-of": { @@ -690,7 +690,7 @@ "integrity": "sha1-IIE989cSkosgc3hpGkUGb65y3Vc=", "dev": true, "requires": { - "is-buffer": "1.1.6" + "is-buffer": "^1.1.5" } } } @@ -701,8 +701,8 @@ "integrity": "sha1-qspJchALZqZCpjoQIcpLrBvjv/Y=", "dev": true, "requires": { - "argparse": "0.1.16", - "autolinker": "0.15.3" + "argparse": "~0.1.15", + "autolinker": "~0.15.0" }, "dependencies": { "argparse": { @@ -711,8 +711,8 @@ "integrity": "sha1-z9AeD7uj1srtBJ+9dY1A9lGW9Xw=", "dev": true, "requires": { - "underscore": "1.7.0", - "underscore.string": "2.4.0" + "underscore": "~1.7.0", + "underscore.string": "~2.4.0" } } } @@ -747,7 +747,7 @@ "integrity": "sha1-12nBgsnVpR9AkUXy+6guXoboA3Y=", "dev": true, "requires": { - "to-object-path": "0.3.0" + "to-object-path": "^0.3.0" } }, "shelljs": { @@ -780,9 +780,9 @@ "integrity": "sha1-yqEjWq+Im6UBB2oYNMQ2gwqC+3M=", "dev": true, "requires": { - "concat-stream": "1.6.0", - "http-response-object": "1.1.0", - "then-request": "2.2.0" + "concat-stream": "^1.4.7", + "http-response-object": "^1.0.1", + "then-request": "^2.0.1" } }, "then-request": { @@ -791,12 +791,12 @@ "integrity": "sha1-ZnizL6DKIY/laZgbvYhxtZQGDYE=", "dev": true, "requires": { - "caseless": "0.11.0", - "concat-stream": "1.6.0", - "http-basic": "2.5.1", - "http-response-object": "1.1.0", - "promise": "7.3.1", - "qs": "6.5.1" + "caseless": "~0.11.0", + "concat-stream": "^1.4.7", + "http-basic": "^2.5.1", + "http-response-object": "^1.1.0", + "promise": "^7.1.1", + "qs": "^6.1.0" } }, "to-object-path": { @@ -805,7 +805,7 @@ "integrity": "sha1-KXWIt7Dn4KwI4E5nL4XB9JmeF68=", "dev": true, "requires": { - "kind-of": "3.2.2" + "kind-of": "^3.0.2" }, "dependencies": { "kind-of": { @@ -814,7 +814,7 @@ "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=", "dev": true, "requires": { - "is-buffer": "1.1.6" + "is-buffer": "^1.1.5" } } }