balena-cloud-apps

This is a free NodeJS script to package the containers native interface BalenaOS for the Raspberry Pi and similar platforms.

The open source Balena-CLI is required, first install Balena-CLI on the host that's sending command lines.

Within an open source application, like balena-sound, wifi-repeater, install this module:

#!/usr/bin/env bash
cd application
npm install balena-cloud-apps

Template fields

(BALENA_PROJECTS_FLAGS) take variable names %%templates_var%% that are replaced by ther value in <arch>.env Make changes to the Dockerfile.template files.

Initialize .env and package.json:

post_install

It will scan for any Docker files in the sub-folders and reset package.json, common.env and <arch>.env files.

Configure template environment

Complete common definitions (leading and trailing ( spaces ) when defining arrays !!):

BALENA_PROJECTS=( MY/PATH MY/RELATIVE/PATH )
BALENA_PROJECTS_FLAGS=( BALENA_MACHINE_NAME MY_VARIABLE )

Define architectures: An ARM computer units like Raspberry PI use armhf.env (or aarch64.env if it's deployed on a 64 bits platform), desktop units are often x86_64.env:

BALENA_ARCH=x86_64
BALENA_MACHINE_NAME=intel-nuc
IMG_TAG=latest
PRIMARY_HUB=docker-hub-balenalib-repo\\/container-servìce-image

Test

Run unit tests on local host or CI

npm test

Build dependencies

Docker Image dependencies are required to validate test units. Theses dependencies include build images needed by Docker based environments:

• Docker and cloud platform (BalenaOS, etc.)
• CircleCI, TravisCI, etc.
• Kubernetes and similar (Openshift, Micro-k8s, etc.)

First login to Docker, if you already have an account or create one.

docker login

The folder deployments contains Dockerfile templates that maybe pulled from Docker.

balena_deploy test/build/

Finally select the corresponding architecture ARM32, ARM64 bits or X86-64 (choose 1, 2 or 3) and choose to build dependencies

It takes a few minutes for the docker machine to pull, update local images and to push them to the repository. They take the name $DOCKER_USER/<image> and get a public URL at https://hub.docker.com/r/$DOCKER_USER/<image>

Deploy

Deploy to Docker or BalenOS, easy, choose targets:

balena_deploy .

You can build locally:

docker_build .

In BASH scripts, use arguments:

balena_deploy . x86_64 --nobuild --exit
balena_deploy . armhf --balena

Updating and managing npm version

Follow general guidelines in the documention about versioning this project on npm