balena-io-examples / device-tags

Examples on how to use the balena API & SDK to set device tags from within your app.

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 stats.last_application_start tag with the current timestamp when the application starts.
• Demonstrates how to use the javascript balena-SDK in the application's server.js.
  • sets the stats.last_server_start tag with the current timestamp whenever the node server starts.
  • sets the stats.last_request tag with the current timestamp whenever the node 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.