Of Crickets and Continuous Integration

The Story

The Adventure Begins

Hardware Utilization and Services

BCM2835 Support

napa - A helper for installing stuff without a package.json with npm.

package.json

						{
							...
							"scripts": {
								"install": "napa",
								...
							},
							...
							"napa": {
								"bcm2835": "http://www.airspayce.com/mikem/
									bcm2835/bcm2835-1.55.tar.gz",
								...
							}
						}
					

Reading the DHT-22

TemperatureSensorReader.js

						var deferred = new Promise(() => (resolve, reject) {
							temperatureSensor.read(22, 22, // sensor model, pin
								(err, temperature, humidity) => {
									if (!err) {
										resolve({
									        temperature,
									        humidity
										});
									} else { reject(err); }
							});
						});
					

Mocking the DHT-22

MockTemperatureSensor.js

						function read(dhtModel, gpio, callback) {
							// ...

							var temperature = getRandomInt(15, 60);
							var humidity = getRandomInt(0, 100);

							// ...

							setTimeout(() => {
								callback(err, temperature, humidity);
							}, 2000); // Simulate maximum 2s readout interval.
						}
					

Reading the MQ-2

GasSensorReader.js

						var deferred = new Promise(() => (resolve, reject) {
							gasSensor.readADCSingleEnded
								(channel, progGainAmp, sampleRate,
									(error, data) => {
										if (!error) { resolve(data); }
										else { reject(error); }
									}
								);
						});
					

Mocking the MQ-2

MockGasSensor.js

						function readADCSingleEnded(
							channel, progGainAmp, sampleRate, callback) {
							// ...

							var gasLevel = getRandomInt(0, 65000);
							callback(null, gasLevel);

							// ...
						}
					

Persistence

DynamoStorage.js

						var docClient = new aws.DynamoDB.DocumentClient({
							apiVersion: '2012-08-10'
						});

						var deferred = new Promise(() => (resolve, reject) {

							docClient.put(params, () => (error, response) {
								if (!error) { resolve(response); }
								else { reject(error); }
							});

						});
					

The Requirements Have Been Altered - Pray I Do Not Alter Them Further

Requirements

• Provide WiFi configuration through this application (now dubbed "Elise")
• Constrain users to Elise
• Improve responsiveness compared to the full desktop environment

Accepting User Input

https://www.npmjs.com/package/inquirer

MainView.js

						const choices = [
							'Manage WiFi Connection',
							'About Elise'
						];

						const question = {
							name: 'main',
							message: 'Select an option below using the arrow keys ' +
								'on your keyboard and then press Enter: ',
							type: 'list',
							choices: choices
						};

						return inquirer.prompt([question]);
					

WiFi Configuration

node-wifi

WifiController.js

					var deferred = new Promise(() => (resolve, reject) {
					  wifiService.scan(() => (err, networks) {
					    if (!err) {
						  view.showMainMenu(networks).then
					        (promptWifiPassword, showMainMenu).then(
						      connectToWifi, checkIfBack).then(
						        () => (connectedNetwork) {
					              resolve(connectedNetwork);
								}, () => (err) {
					              reject(err);
					            });
					    } else {
						  reject(err);
					}});});
					

The Deal is Altered Further

Nexe

Create a single executable out of your node.js apps

https://github.com/nexe/nexe

package.json

						// ...
						"scripts": {
							// ...
							"build": "npx nexe --build index.js -o bin/elise",
							// ...
						}
					

						$ npm run build
					

Nexe Benefits

• Single-file deployment
• Includes embedding native modules (*.node files)
• Bundles known working version of the Node runtime with your application
• Runtime can be upgraded (or reverted) anytime during a standard deployment

GitLab and Continuous Integration

GitLab

GitLab is a single application for the entire software development lifecycle. From project planning and source code management to CI/CD, monitoring and security.

Gitlab Runner

CI Pipelines

Auto DevOps

Pre-configured pipeline centered around scalable web applictions.

• Kubernetes
• Helm
• Docker
• GitLab Runner
• Prometheus

.gitlab-ci.yml

In-repository, per-branch configuration file for custom CI pipelines.

• SSH
• Shell
• Parallels
• VirtualBox
• Docker
• Docker Machine (auto-scaling)
• Kubernetes

GitLab CI Structure

• Pipeline
  • Stages
    • Jobs

Elise's .gitlab-ci.yml

Stages

						stages:
						- Setup
						- Analyze
						- Test
						- Build
						- Stage
					

Cache Configuration

						cache:
						  untracked: true
						  key: "$CI_COMMIT_REF_NAME"
						  paths:
						    - node_modules/
					

Setup

						Setup:
							stage: Setup
							script:
								- npm install
								- cd ./node_modules/bcm2835
								- ./configure
								- make
								- sudo make check
								- sudo make install
								- cd ../../
								- npm rebuild
					

Analysis

						Analysis:
							stage: Analyze
							script:
								- npm run lint
								- npm audit
					

Test

						Test:
							stage: Test
							script:
								- npm test
					

						// ...
						"scripts": {
							// ...
							"test": "npx nyc --reporter=html --reporter=text mocha
								--recursive",
							// ...
						},
						// ...
					

Build

						Build:
							stage: Build
							script:
								- npm run build
					

						// ...
						"scripts": {
							// ...
							"build": "npx nexe --build index.js -o bin/elise",
							// ...
						},
						// ...
					

Stage

						Virtual Staging:
							stage: Stage
							before_script:
								- vagrant plugin install vagrant-vbguest
								- vagrant box update
							script:
								- vagrant up
							after_script:
								- vagrant destroy --force
					

Tags

More Tags

Final Pipeline