Cloud Instance Manager is web based managed solution that allows admins to provision and manage Amazon EC2 Instances quite easily and efficiently. In other words, it is a wrapper on AWS for managing EC2 instances.

It provides an easy to use interface through which admins can create users, assigns & un-assign instances to users and upload ssh keys. Users can start and stop assigned instances on demand and view usage bill.

Following are the features of Cloud Instance Manager:

• Separate Interfaces for Admin and User
• Users management
• Stop / Start Capability
• SSH key for VM access
• View Bills
• Simple deployment

For deployment, Cloud Instance Manager can be setup in two different ways.

To be able to run Cloud Instance Manager on your local environment you have to meet the following dependencies:

sudo apt update
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update
sudo apt-get install python3.8 -y
sudo apt-get install python3-pip
sudo apt install -y python3-venv

sudo apt update
sudo apt install postgresql postgresql-contrib

sudo su - postgres  
postgres=# create database <db_name>;  
postgres=# create user <pg_username> with encrypted password <'pg_pass'>;  
postgres=# grant all privileges on database <db_name> to <pg_username>;

• Make sure to clone this repository first.
• Switch to project root directory.
• Create virtual environment

   python3 -m venv venv
   source venv/bin/activate
  

• Install pip dependency requirements pip3 install -r requirement.txt
• Rename .env-sample to .env in $ /PROJECT_ROOT/cloud-instance-manager/
• Paste value against each environment variable in .env file.

AWS_ACCESS_KEY_ID=<aws_access_key_id>
AWS_SECRET_ACCESS_KEY=<aws_secret_key_id>
REGION_NAME=<default_region>
SECRET_KEY=my_secret_key
POSTGRES_USER=<pg_username>
POSTGRES_PASSWORD=<pg_pass>
POSTGRES_DB=<db_name>
DATABASE_URL=postgres://<pg_username>:<pg_pass>@localhost:5432/<db_name>

• Run database migrations python3 manage.py db upgrade

• RUN export FLASK_APP=app.py
• RUN export FLASK_ENV=development
• RUN flask run

Cloud Instance Manager server should now up on localhost:5000

============

============

To be able to run Cloud Instance Manager you have to meet following dependencies:

• Install Docker
• Install docker-compose

• Make sure to clone this repository first.
• Switch to project root directory.
• Rename .env-sample to .env in $ /PROJECT_ROOT/cloud-instance-manager/
• Paste value against each environment variable in .env file.

AWS_ACCESS_KEY_ID=<aws_access_key_id>
AWS_SECRET_ACCESS_KEY=<aws_secret_key_id>
REGION_NAME=<default_region>
SECRET_KEY=my_secret_key
POSTGRES_USER=<pg_username>
POSTGRES_PASSWORD=<pg_pass>
POSTGRES_DB=<pg_db_name>
DATABASE_URL=postgres://<pg_username>:<pg_pass>@database:5432/<db_db_name>

• RUN sudo docker-compose build
• RUN sudo docker-compose up -d

Cloud Instance Manager should now up on <server-IP>:5000

=============