DOCKER.md

Running temper.py as a service in docker container

The container provides the sensor metrics via web API

• Default port: 2610
• endpoint /list: List available USB devices in JSON format
• endpoint /metrics: Send metrics from available temper devices in JSON format

Running the service as a commandline

docker run --rm -it -p 2610:2610 temper/service:latest

Snippet of config in docker-compose.yml

---
version: '3'

services:
  temper:
    container_name: temper
    hostname: temper
    image: temper/service:latest
    restart: always
    ports:
      - 2610:2610

Running the docker as a service using docker-compose config.

docker-compose up -d

Checking the service from another terminal

# List available USB devices (including temper devices)
http localhost:2610/list | jq -C

# Query temper metrics
http localhost:2610/metrics | jq -C 

Running the script temper.py from docker container

You can run temper.py as a docker container by overriding the entrypoint.

docker run --rm -it --entrypoint /opt/temper/bin/temper.py temper/service:latest --help
usage: temper.py [-h] [-l] [--json] [--force VENDOR_ID:PRODUCT_ID] [--verbose]

temper

options:
  -h, --help            show this help message and exit
  -l, --list            List all USB devices
  --json                Provide output as JSON
  --force VENDOR_ID:PRODUCT_ID
                        Force the use of the hex id; ignore other ids
  --verbose             Output binary data from thermometer

Note: This dockerization effort was sponsored by Greenfly SAU LLC.