Skip to content

Latest commit

 

History

History
26 lines (19 loc) · 1.95 KB

README.md

File metadata and controls

26 lines (19 loc) · 1.95 KB

Using the balena API & SDK to set device tags from within apps.

This is a simple project which runs one container based on the balena simple-server-node repository that demonstrates how to set device tags from within your application.

This project serves up "Hello World!" on port :80 of your balena device and additionally:

  • Demonstrates how to use CURL to set tags (in the application's start.sh).
    • sets the device_tags_node.last_application_start tag with the current timestamp when the application starts.
  • Demonstrates how to use the javascript balena-SDK in the application's device_tags_node/server.js.
    • sets the device_tags_node.last_server_start tag with the current timestamp whenever the node server starts.
    • sets the device_tags_node.last_request tag with the current timestamp whenever the node server responds to an HTTP request.
  • Demonstrates how to use the python balena-SDK in the application's device_tags_python/src/app.py. To try to python version, you need to uncomment the respective section in the docker-compose.yml.
    • sets the device_tags_python.last_server_start tag with the current timestamp whenever the python server starts.
    • sets the device_tags_python.last_request tag with the current timestamp whenever the python server responds to an HTTP request.

Setup

Check out the instructions in the balena simple-server-node repository to get started.

Authentication

The scripts use the BALENA_API_KEY environment variable, which is injected to the environment of all balena applications, to authenticate all requests.