Cumulocity IoT microservice example developed using Python and Docker.

• Local Docker installation
• An account on cumulocity.com. Create a free trial to test this example.

Execute the following commands to build the Docker image and save it as image.tar:

$ docker build -t python-microservice .
$ docker save python-microservice > "image.tar"

Then pack image.tar together with the manifest cumulocity.json into a ZIP file.

$ zip python-microservice cumulocity.json image.tar

The resulting python-microservice.zip file contains the microservice and it is ready to be uploaded to the Cumulocity IoT platform.

Deploy the microservice application (refer to Adding own applications in the Cumulocity IoT's User guide) and subscribe it afterwards.

It may take some minutes for the ZIP file to be uploaded. Once completed, the three endpoints of the microservice application can be tested.

Use a web browser or a terminal command (e.g. cURL) to make a GET request to the microservice endpoints providing your user credentials.

GET /service/python-microservice/environment
Host: <TENANT_DOMAIN>
Authorization: <AUTHORIZATION>

These tools are provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the master project.