Eclipse Ditto Project
Clone or download
ffendt Merge pull request #257 from bsinno/feature/adjustable-max-parallelism
Made max-parallelism for things-aggregation configurable
Latest commit 16f8c35 Oct 12, 2018
Permalink
Failed to load latest commit information.
bom removed/excluded netty3 dependency Oct 10, 2018
deployment fixed relative paths in docker-compose.yml files to images, openAPI, .. Oct 12, 2018
documentation Merge pull request #253 from bsinno/feature/request-placeholders Oct 12, 2018
json moved deployment related stuff (docker, kubernetes) to deployment/ Sep 26, 2018
legal removed/excluded netty3 dependency Oct 10, 2018
model review: fixed Exception deserialization issues Oct 11, 2018
protocol-adapter moved deployment related stuff (docker, kubernetes) to deployment/ Sep 26, 2018
services Merge pull request #257 from bsinno/feature/adjustable-max-parallelism Oct 12, 2018
signals review: fixed Exception deserialization issues Oct 11, 2018
src moved deployment related stuff (docker, kubernetes) to deployment/ Sep 26, 2018
utils moved deployment related stuff (docker, kubernetes) to deployment/ Sep 26, 2018
.gitignore moved deployment related stuff (docker, kubernetes) to deployment/ Sep 26, 2018
.travis.settings.xml moved deployment related stuff (docker, kubernetes) to deployment/ Sep 26, 2018
.travis.yml moved Dockerfile to services/src as new docker-maven-plugin automatic… Oct 10, 2018
CONTRIBUTING.md fixed typo Oct 8, 2017
Jenkinsfile Merge branch 'feature/ci-friendly' into feature/stream-modified-entities Jan 2, 2018
LICENSE added LICENSE Sep 26, 2018
NOTICE.md added NOTICE.md Sep 26, 2018
README.md moved deployment related stuff (docker, kubernetes) to deployment/ Sep 26, 2018
pom.xml removed/excluded netty3 dependency Oct 10, 2018

README.md

Ditto Logo

Eclipse Ditto

Join the chat at https://gitter.im/eclipse/ditto Build Status Maven Central License Lines of code

Eclipse Ditto is the open-source project of Eclipse IoT that provides a ready-to-use functionality to manage the state of Digital Twins. It provides access to them and mediates between the physical world and this digital representation.

Documentation

Find the documentation on the project site: https://eclipse.org/ditto/

Getting started

In order to start up Ditto, you'll need

  • a running Docker daemon (at least version 18.06 CE)
  • Docker Compose installed (at least version 1.22)

Start Ditto

In order to start the latest built Docker images from Docker Hub, simply execute:

cd deployment/docker/
docker-compose up -d

Check the logs after starting up:

docker-compose logs -f

Open following URL to get started: http://localhost:8080
Or have a look at the "Hello World"

Build and start Ditto

In order to build Ditto, you'll need

  • JDK 8 >= 1.8.0_92 (due to a bug in older versions of the JDK you'll get a compile error)
  • Apache Maven 3.x installed

In order to first build Ditto and then start the built Docker images

# if you have the docker daemon running with remote access enabled (e.g. in a Vagrant box or on localhost):
mvn clean install -Pdocker-build-image -Ddocker.daemon.hostname=<ip/host of your docker daemon>
# if you have the docker daemon running on your machine and you are running on Unix, you can also connect against the docker socket:
mvn clean install -Pdocker-build-image -Ddocker.daemon.url=unix:///var/run/docker.sock

cd deployment/docker/
# the "dev.env" file contains the SNAPSHOT number of Ditto, copy it to ".env" so that docker compose uses it:
cp dev.env .env
docker-compose up -d

Check the logs after starting up:

docker-compose logs -f

You have now running:

  • a MongoDB as backing datastore of Ditto (not part of Ditto but started via Docker)
  • Ditto microservices:
    • Policies
    • Things
    • Thing-Search
    • Gateway
    • Connectivity
    • Concierge
  • an nginx acting as a reverse proxy performing a simple "basic authentication" listening on port 8080