Atlas is a web application handling inbound events from Internet of Things (IoT) devices.
The events describe the state of the devices and may result to an auto-executed action.
- Java 11
- Spring Boot 2
- PostgreSQL 9.4
- MQTT Broker
- Maven 3
From a machine with docker installed + internet access, execute:
docker build -t atlas-db-image -f Dockerfile-db .
docker run -p 5432:5432 --name rdbms -d atlas-db-image
Make sure your hosts file maps rdbms to localhost
127.0.0.1 localhost rdbms
Init or migrate the database schema
Init the database
mvn clean install -DskipTests -Ddb.host=rdbms -Ddb.port=5432 -Ddb.module.database.name=atlas -Ddb.module.userId=atlas -Ddb.module.password=atlas -Ddb.root.password=postgres -Dinit.database.skip=false flyway:migrate
Migrate an existing database
mvn clean install -DskipTests -Ddb.host=rdbms -Ddb.port=5432 -Ddb.module.database.name=atlas -Ddb.module.userId=atlas -Ddb.module.password=atlas flyway:migrate
From a machine with docker installed + internet access, download image 'peez/hivemq' or create a new one using DockerFile-HiveMQ:
docker run -p 1883:1883 --name broker -d peez/hivemq
docker build -t atlas-broker-image -f Dockerfile-HiveMQ .
docker run -p 1883:1883 --name broker -d atlas-broker-image
Make sure your hosts file maps broker to localhost
127.0.0.1 localhost broker
- Default : {PROJECT_HOME}/src/main/resources/atlas-application.yml
- Runtime : {SPRING_CONFIG_LOCATION}/atlas-application.yml (if not found, the app defaults to the one in the classpath)
Atlas is a Spring Boot application thus can be executed as a standalone application, inside a servlet container (Tomcat 9) or running a docker container:
Default configuration may be overridden using the 'spring.config.location' property setting the dirpath of the 'atlas-application.yml':
mvn spring-boot:run --spring.config.location=/path/to/conf/
$CATALINA_HOME/bin/startup.sh --Dspring.config.location=/path/to/conf/
docker build -t atlas-webapp-image .
docker run -p 8080:8080 -p 443:443 -p 80:80 --name atlas --link rdbms --link broker -d atlas-webapp-image
or simply execute to run all containers:
docker-compose up -d
Use heroku to deploy the develop branch to https://iotac.herokuapp.com as follows:
git remote add heroku https://git.heroku.com/iotac.git
git push heroku develop:master