這篇文章會簡單的介紹如何從官方的 Eclipse Ditto 專案建置,部署及運行,並且利用其提供的 Rest API 建立一個 Thing。

為了使用 Maven 建置 Ditto 專案,以下環境需要先建立好

  1. Docker >= 18.06 CE
  2. Apache Maven 3.x
  3. JDK 8 >= 1.8.0_92

首先由官方的 Eclipse Ditto GitHub 把整包專案下載回來

接著 cd 至專案根目錄後,執行 maven 指令後建置並產生 docker image

mvn clean install -Pdocker-build-image -Ddocker.daemon.url=unix:///var/run/docker.sock

building 需要一點時間, 完成之後 cd 至 deployment/docker 目錄後 再運行 docker 指令

docker-compose up -d

接著打開瀏覽器, 進入以下位址

http://localhost:8080/

若能看到以下畫面,就代表 Ditto 成功 run 起來囉~

Ditto static HTTP page
Ditto static HTTP page

最後用 curl 敲一下 API 來建立一個 Thing

curl -u ditto:ditto -X PUT -d '{
    "attributes": {
      "manufacturer": "ACME",
      "VIN": "0815666337"
    },
    "features": {
      "transmission": {
        "properties": {
          "automatic": true,
          "mode": "eco",
          "cur_speed": 90,
          "gear": 5
        }
      },
      "environment-scanner": {
          "properties": {
          "temperature": 20.8,
          "humidity": 73,
          "barometricPressure": 970.7,
          "location": {
            "longitude": 47.682170,
            "latitude": 9.386372
          },
          "altitude": 399
        }
      }
    }
  }' 'http://localhost:8080/api/1/things/org.eclipse.ditto:fancy-car'

Eclipse Ditto 相關文章

Eclipse Ditto Document