serverless/lib/actions/RegionRemove.js

'use strict';

/**
 * Action: RegionRemove
 * - Removes a region from your project in a provided stage. If project only
 *   has one stage, no stage needs to be provided.
 * - Removes env and CF files from the project's S3 bucket for the provided stage and region
 * - Removes CF stack by default, unless noExeCf option is set to true
 *
 * Options:
 * - region               (String) the name of the new region
 * - stage                (String) the name of the stage you want to create a region in.  Optional if only one stage in project.
 * - noExeCf:             (Boolean) Don't execute CloudFormation
 */

module.exports = function(SPlugin, serverlessPath) {

  const path     = require('path'),
    SError     = require(path.join(serverlessPath, 'Error')),
    SCli       = require(path.join(serverlessPath, 'utils/cli')),
    BbPromise  = require('bluebird'),
    fs         = BbPromise.promisifyAll(require('fs')),
    SUtils     = require(path.join(serverlessPath, 'utils')),
    _          = require('lodash');

  /**
   * RegionCreate Class
   */

  class RegionRemove extends SPlugin {

    constructor(S, config) {
      super(S, config);
    }

    static getName() {
      return 'serverless.core.' + RegionRemove.name;
    }

    registerActions() {
      this.S.addAction(this.regionRemove.bind(this), {
        handler:       'regionRemove',
        description:   `Removes a region from a stage in a project
usage: serverless region remove`,

        context:       'region',
        contextAction: 'remove',
        options:       [
          {
            option:      'region',
            shortcut:    'r',
            description: 'The region you want to remove'
          },
          {
            option:      'stage',
            shortcut:    's',
            description: 'The stage you want to remove a region from'
          },
          {
            option:      'noExeCf',
            shortcut:    'c',
            description: 'Optional - Don\'t execute CloudFormation, just remove it. Default: false'
          }
        ]
      });
      return BbPromise.resolve();
    }

    /**
     * Action
     */

    regionRemove(evt) {
      this.evt = evt;

      return this._prompt()
        .bind(this)
        .then(this._validateAndPrepare)
        .then(() => { SCli.log(`Removing region "${this.evt.options.region}" in stage "${this.evt.options.stage}"...`); })
        .then(this._listS3Objects)
        .then(this._removeS3Objects)
        .then(this._removeResources)
        .then(this._removeMeta)
        .then(this._removeVariables)
        .then((reply) => {
          SCli.log(`Successfully removed region "${this.evt.options.region}" within stage "${this.evt.options.stage}"`);
          this.evt.data.region = this.evt.options.region;
          return this.evt;
        });
    }


    /**
     * Prompt stage and region
     */

    _prompt() {
      // Skip if non-interactive or stage is provided
      if (!this.S.config.interactive || (this.evt.options.stage && this.evt.options.region)) return BbPromise.resolve();

      if (!this.S.getProject().getAllStages().length) return BbPromise.reject(new SError('No existing stages in the project'));

      return this.cliPromptSelectStage('Select an existing stage: ', this.evt.options.stage, false)
        .then(stage => { this.evt.options.stage = stage; })
        .then(() => {
          if (this.S.getProject().getAllRegions(this.evt.options.stage).length)
            return this.cliPromptSelectRegion('Select a region to remove: ', false, true, this.evt.options.region, this.evt.options.stage);
          else
            return BbPromise.reject(new SError(`No existing regions in "${this.evt.options.stage}" stage`));
        })
        .then(region => { this.evt.options.region = region; });
    }

    /**
     * Validate & Prepare
     * - Validate all data from event, interactive CLI or non interactive CLI
     *   and prepare data
     */

    _validateAndPrepare() {

      // Check Params
      if (!this.evt.options.stage || !this.evt.options.region) {
        return BbPromise.reject(new SError('Missing stage or region'));
      }

      // Validate stage: make sure stage exists
      if (!this.S.getProject().validateStageExists(this.evt.options.stage)) {
        return BbPromise.reject(new SError('Stage ' + this.evt.options.stage + ' does not exist in your project', SError.errorCodes.UNKNOWN));
      }

      // Validate region: make sure region exists in stage
      if (!this.S.getProject().validateRegionExists(this.evt.options.stage, this.evt.options.region)) {
        return BbPromise.reject(new SError('Region "' + this.evt.options.region + '" does not exists in stage "' + this.evt.options.stage + '"'));
      }

    }

    _listS3Objects() {
      SUtils.sDebug("List related S3 objects");

      let prefix   = ['serverless', this.S.getProject().getName(), this.evt.options.stage, this.evt.options.region].join('/'),
          projectBucket = this.S.getProject().getVariablesObject().projectBucket,
          projectBucketRegion = this.S.getProject().getVariablesObject().projectBucketRegion,
          params   = {
            Bucket: projectBucket,
            Prefix: prefix
          };
      return this.S.getProvider('aws').request('S3', 'listObjects', params, this.evt.options.stage, projectBucketRegion)
        .then(reply => _.map(reply.Contents, (item) => ({Key: item.Key})));
    }

    _removeS3Objects(objects) {
      SUtils.sDebug("Removing related S3 objects");
      let projectBucket = this.S.getProject().getVariablesObject().projectBucket,
          projectBucketRegion = this.S.getProject().getVariablesObject().projectBucketRegion;

      if (objects.length) {
        let params = {
            Bucket: projectBucket,
            Delete: {
              Objects: objects
            }
          };
        return this.S.getProvider('aws').request('S3', 'deleteObjects', params, this.evt.options.stage, projectBucketRegion);
      } else {
        SUtils.sDebug("S3 objects are not found. Skipping.");
        return BbPromise.resolve();
      }
    }

    _removeMeta() {
      // Update and save Meta
      this.S.getProject().getStage(this.evt.options.stage).removeRegion(this.evt.options.region);
      return this.S.getProject().getStage(this.evt.options.stage).save();
    }

    _removeVariables() {
      let fileName = `s-variables-${this.evt.options.stage}-${this.evt.options.region.replace(/-/g, '')}.json`;
      return fs.unlinkAsync(this.S.getProject().getFilePath( '_meta', 'variables', fileName ));
    }


    /**
     * Remove Resources from Stage/Region
     */

    _removeResources() {
      return this.S.actions.resourcesRemove({
        options: {
          stage:   this.evt.options.stage,
          region:  this.evt.options.region,
          noExeCf: !!this.evt.options.noExeCf
        }
      });
    }
  }

  return RegionRemove;
};