Cloudspace NPM

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();