CloudSpace

Free yourself from your Desktop, and reserve some cloud space just for yourself. Don't be grounded by your hardware.

Usage

• npm install -g cloudspace

Cloudspace Commands

• cloudspace --help : Lists the available commands
• cloudspace create : Creates a new instance in the current region.
• cloudspace list : Lists all cloudspace instances in all regions.
• cloudspace ssh : Get the first IpAddress of running instances, for piping to ssh command. This is the default command.
• cloudspace terminate : Terminates all cloudspace instances in all regions.
• cloudspace on : Turns on an existing cloudspace instance, if none exists it will create one.
• cloudspace off : Turns off the existing cloudspace instance.

Example flow:

• cloudspace create : Create the VM
• cloudspace ssh : Load the credentials once the machine is running
• ssh cloudspace: Launch ssh using the cloudspace alias

Prerequisites

• AWS SDK Crendetials must be configured.
• Must have a user that contains the necessary permissions
• Create VPC (if necessary)
  • Set Tag:Name as Cloudspace
  • Set Edit DNS Hostnames to Yes
• Create VPC Subnet

  • Name the VPC Subnet Cloudspace

  • Set Enable auto-assign Public IP to true

  • Use ACL Restrictions for VPC to manage security:

    • Inbound Rules

      | Rule # | Type | Protocol | Port Range | Source | Allow / Deny | | :--------------: |----------------:|--------------:|--------------:|-----------:|-------------:| | 100 | ALL Traffic | ALL | ALL | Private IP | ALLOW | | 110 | Custom TCP Rule | TCP (6) | 1024-65535 | 0.0.0.0/0 | ALLOW |

    • Outbound Rules

      | Rule # | Type | Protocol | Port Range | Source | Allow / Deny | | :--------------: |--------------:|--------------:|--------------:|----------:|-------------:| | 100 | ALL Traffic | ALL | ALL | 0.0.0.0/0 | ALLOW |

  • Update the Security Group automatically created (called default) for the VPC

    • Create the tag Name:Cloudspace for the VPC, using this tag Cloudspace cli will automatically use it.

    • Inbound Rules

      | Type | Protocol | Port Range | Source | |-------------:|--------------:|--------------:|-----------:| | ALL Traffic | ALL | ALL | Private IP |

    • Outbound Rules

      | Type | Protocol | Port Range | Source | |-------------:|--------------:|--------------:|----------:| | ALL Traffic | ALL | ALL | 0.0.0.0/0 |

• Create Internet Gateway named Cloudspace and attach to the VPC
  • Update the Route Table for the Subnet for the destination 0.0.0.0/0 to target the new Internet Gateway.

Use Cloudspace as a library

Cloudspace cli is a wrapper for the cloudspace library, which can be invoked directly.

const pathToAwsUserData = path.join(__dirname, 'userdata.sh');
const ami = {
	'us-east-1': 'ami-ddf13fb0',
	'us-west-1': 'ami-b20542d2'
};

const cloudspace = new Cloudspace(pathToAwsUserData, ami);
cloudspace.Create();