Docker Agent

The Docker Agent has the same idea and functionality like the Native Agent, with some key differences:

• It does not execute directly on the OS but runs within a Docker container

• It does not have credentials baked in, you need to configure the corresponding environmental variables correctly to connect it with your platform

• You need to use standard Docker features to reach networks, USB devices, persist data, etc.

• You can run in on any platform - especially on "Edge Gateways" - that support Docker.

Where to get it?

We provide our docker agent as a publicly downloadable docker Eimage called

heisenware/docker-agent:<version>

Check here to see the all available versions

How to use it?

Easy, no frills docker stuff. To start you need to configure the following environmental variables:

docker run -it \
-e HW_DOMAIN=<account>.<workspace> \
-e HW_BROKER=mqtts://<account>.heisenware.cloud \
-e HW_USERNAME=<username> \
-e HW_PASSWORD=<password> \
-e HW_AGENT_ID=<unique id> \
heisenware/docker-agent:v88

In order to retrieve a valid username and password, add a VRPC Integration in the App Manager.

Example

For an account named my-company, an integration with username agentRunner and a password called secret the call would be:

docker run -it \
-e HW_DOMAIN=my-company.default \
-e HW_BROKER=mqtts://my-company.heisenware.cloud \
-e HW_USERNAME=agentRunner \
-e HW_PASSWORD=secret \
-e HW_AGENT_ID=my-agent-1 \
heisenware/docker-agent:v88

When everything was setup up correctly, you should see something similar like this on your console:

Persisting Data

In order to persist data (e.g. the instances you created) you need to mount the /shared volume.