presidium 0.15.35 → 0.16.1

package/AutoScaling.js

@@ -0,0 +1,117 @@
+const rubico = require('rubico')
+const AWSAutoscaling = require('aws-sdk/clients/autoscaling')
+const AWSAutoScalingDescribeAutoScalingGroupsFilters =
+  require('./internal/AWSAutoScalingDescribeAutoScalingGroupsFilters')
+const filterExistsAndNotEmpty = require('./internal/filterExistsAndNotEmpty')
+const filterExists = require('./internal/filterExists')
+
+const {
+  pipe, tap,
+  switchCase, tryCatch,
+  fork, assign, get, set, pick, omit,
+  map, filter, reduce, transform, flatMap,
+  and, or, not, any, all,
+  eq, gt, lt, gte, lte,
+  thunkify, always,
+  curry, __,
+} = rubico
+
+/**
+ * @name AutoScaling
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * new AutoScaling(options {
+ *   ...({
+ *     accessKeyId: string,
+ *     secretAccessKey: string,
+ *     region: string,
+ *   })|({
+ *     endpoint: string,
+ *     region: string,
+ *   })
+ * }) -> AutoScaling object
+ * ```
+ */
+const AutoScaling = function (options) {
+  this.awsAutoScaling = new AWSAutoscaling({
+    apiVersion: '2011-01-01',
+    ...pick([
+      'accessKeyId',
+      'secretAccessKey',
+      'region',
+      'endpoint',
+    ])(options),
+  })
+  return this
+}
+
+/**
+ * @name AutoScaling.prototype.listAutoScalingGroups
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * import AutoScalingListGroupsDescribeFilterOptions
+ *   from './internal/AutoScalingListGroupsDescribeFilterOptions.ss'
+ *
+ * new AutoScaling(...).listAutoScalingGroups(options? {
+ *   ...AutoScalingListGroupsDescribeFilterOptions.map(value => value|Array<value>),
+ *   limit?: 5-100, // default 100
+ *   nextToken?: string, // last result's NextToken
+ * }) -> Promise<{
+ *   AutoScalingGroups: Array<{
+ *     AutoScalingGroupName: string, // 'presidium-test'
+ *     AutoScalingGroupARN: string, // 'arn:aws:autoscaling:us-west-1:095798571722:autoScalingGroup:934690c8-d95d-46be-ac49-54950de41ef5:autoScalingGroupName/presidium-test'
+ *     LaunchTemplate: Object,
+ *     MinSize: number, // 1
+ *     MaxSize: number, // 1
+ *     DesiredCapacity: number, // 1
+ *     DefaultCooldown: number, // 300
+ *     AvailabilityZones: Array,
+ *     LoadBalancerNames: Array,
+ *     TargetGroupARNs: Array,
+ *     HealthCheckType: string, // 'EC2'
+ *     HealthCheckGracePeriod: number, // 300
+ *     Instances: Array,
+ *     CreatedTime: Date, // 2022-04-28T20:26:13.289Z
+ *     SuspendedProcesses: Array,
+ *     VPCZoneIdentifier: string, // 'subnet-916bb8f7,subnet-677c933d'
+ *     EnabledMetrics: Array,
+ *     Tags: Array,
+ *     TerminationPolicies: Array,
+ *     NewInstancesProtectedFromScaleIn: boolean,
+ *     ServiceLinkedRoleARN: string, // 'arn:aws:iam::095798571722:role/aws-service-role/autoscaling.amazonaws.com/AWSServiceRoleForAutoScaling'
+ *   }>,
+ *   NextToken: string|null,
+ * }>
+ * ```
+ */
+AutoScaling.prototype.listAutoScalingGroups = function (options = {}) {
+  return this.awsAutoScaling.describeAutoScalingGroups(filterExistsAndNotEmpty({
+    Filters: AWSAutoScalingDescribeAutoScalingGroupsFilters(options),
+    MaxRecords: options.limit ?? 100,
+    NextToken: options.nextToken,
+  })).promise()
+}
+
+/**
+ * @name AutoScaling.prototype.setDesiredCapacity
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * new AutoScaling(...).setDesiredCapacity(options {
+ *   autoScalingGroupName: string,
+ *   desiredCapacity: number,
+ *   honorCooldown?: boolean, // whether Amazon EC2 Auto Scaling waits for the cooldown period to complete before initializing a scaling activity to set your Auto Scaling group to its new capacity, default false
+ * }) -> Promise<{}>
+ * ```
+ */
+AutoScaling.prototype.setDesiredCapacity = function (options) {
+  return this.awsAutoScaling.setDesiredCapacity(filterExists({
+    AutoScalingGroupName: options.autoScalingGroupName,
+    DesiredCapacity: options.desiredCapacity,
+    HonorCooldown: options.honorCooldown,
+  })).promise()
+}
+
+module.exports = AutoScaling

package/AutoScaling.test.js

@@ -0,0 +1,57 @@
+const Test = require('thunk-test')
+const assert = require('assert')
+const AwsCredentials = require('./internal/AwsCredentials')
+const AutoScaling = require('./AutoScaling')
+
+const test = new Test('AutoScaling', async function () {
+  const awsCreds = await AwsCredentials('default').catch(error => {
+    if (error.code == 'ENOENT') {
+      const accessKeyId = process.env.AWS_ACCESS_KEY_ID
+      const secretAccessKey = process.env.AWS_SECRET_ACCESS_KEY
+      if (accessKeyId == null || secretAccessKey == null) {
+        throw new Error('No AWS credential file or environment variables')
+      }
+      return { accessKeyId, secretAccessKey }
+    }
+    throw error
+  })
+  awsCreds.region = 'us-west-1'
+
+  const autoScaling = new AutoScaling({
+    ...awsCreds,
+  })
+
+  // there is one auto scaling group named presidium-test with one ec2 instance in this region
+
+  { // listInstances all instances
+    const response = await autoScaling.listAutoScalingGroups()
+    assert(
+      response.AutoScalingGroups.map(group => group.AutoScalingGroupName).includes('presidium-test'),
+      'There is no presidium-test autoscaling group, check the aws account'
+    )
+    assert.equal(response.NextToken, null)
+  }
+
+  { // listAutoScalingGroups with tag
+    const response = await autoScaling.listAutoScalingGroups({
+      'tag:Env': 'test',
+    })
+    assert(
+      response.AutoScalingGroups.map(group => group.AutoScalingGroupName).includes('presidium-test'),
+      'There is no presidium-test autoscaling group, check the aws account'
+    )
+    assert.equal(response.NextToken, null)
+  }
+
+  // setDesiredCapacity (errors if not auto scaling group not found)
+  await autoScaling.setDesiredCapacity({
+    autoScalingGroupName: 'presidium-test',
+    desiredCapacity: 1,
+  })
+}).case()
+
+if (process.argv[1] == __filename) {
+  test()
+}
+
+module.exports = test

package/Docker.js

@@ -1136,6 +1136,18 @@ Docker.prototype.updateService = function dockerUpdateService(service, options)
   })
 }
 
+/**
+ * @name Docker.prototype.deleteService
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * new Docker().deleteService(id string) -> Promise<HttpResponse>
+ * ```
+ */
+Docker.prototype.deleteService = function deleteService(id) {
+  return this.http.delete(`/services/${id}`)
+}
+
 /**
  * @name Docker.prototype.listServices
  *
@@ -1189,6 +1201,23 @@ Docker.prototype.getServiceLogs = async function getServiceLogs(serviceId, optio
   }`)
 }
 
+/**
+ * @name Docker.prototype.listTasks
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * new Docker().listTasks(options {
+ *   service?: string,
+ *   node?: string,
+ * }) -> Promise<HttpResponse>
+ * ```
+ */
+Docker.prototype.listTasks = async function listTasks(options) {
+  return this.http.get(`/tasks?${
+    querystring.stringify(pick(['service', 'node'])(options))
+  }`)
+}
+
 /**
  * @name Docker.prototype.pruneImages
  *