awslabs / simpleiot

Installer source for SimpleIOT back-end.

SimpleIOT

This repo contains the source to the back-end of the SimpleIOT framework. It is here for those who want to install the system from source or work on the source.

Installation Instructions

• Start here

Install from Source

To install from source, clone this repository, then install the following pre-requisite components:

• Docker Desktop
• AWS CLI
• CDK
• NPM
• NPM dependencies (via npm install) in directories containing package.json files.
• Python 3.9+
• Python dependencies in virtual envs, via
  • python3 -m venv venv
  • source venv/bin/activate
  • pip install -r requirements.txt

Once these are installed, you can manually run the installer by going into the simpleiot/sources/iotapi directory, and running invoke --list to see the list of commands.

The three stages of installation are:

• invoke bootstrap
• invoke deploy {team-name}
• invoke dbsetup {team-name}

To clean up the back-end infrastructure and delete all generated settings, run:

• invoke clean {team-name}

For more detailed information, consult simpleiot/sources/iotapi/README.md.