Skip to content

nuvlabox/data-source-mjpg

Repository files navigation

data-source-mjpg

Maintenance GitHub issues Docker pulls Docker image size

CI Build CI Release

This repository contains the source code for the NuvlaBox MJPG Data Source - this microservice is only deployed on-demand, and takes care of routing the raw MJPG data from a peripheral into the NuvlaBox's Data Gateway


NOTE: this microservice is part of a loosely coupled architecture, thus when deployed by itself, it might not provide all of its functionalities. Please refer to https://github.com/nuvlabox/deployment and docs.nuvla.io for a fully functional deployment


Build the NuvlaBox MJPG Data Source

This repository is already linked with Travis CI, so with every commit, a new Docker image is released.

There is a POM file which is responsible for handling the multi-architecture and stage-specific builds.

If you're developing and testing locally in your own machine, simply run docker build . or even deploy the microservice via the local compose files to have your changes built into a new Docker image, and saved into your local filesystem.

If you're developing in a non-master branch, please push your changes to the respective branch, and wait for Travis CI to finish the automated build. You'll find your Docker image in the nuvladev organization in Docker hub, names as nuvladev/data-source-mjpg:<branch>.

Deploy the NuvlaBox MJPG Data Source

Prerequisites

  • Docker (version 18 or higher)
  • Docker Compose (version 1.23.2 or higher)

Launching the NuvlaBox MJPG Data Source

Simply run docker-compose up --build

Test the NuvlaBox MJPG Data Source

This component needs an existing NuvlaBox to be up and running before it can be deployed.

Once you have a fully functional NuvlaBox running, simply SSH into it, clone this repository and run docker-compose up -d.

Contributing

This is an open-source project, so all community contributions are more than welcome. Please read CONTRIBUTING.md

Copyright

Copyright © 2021, SixSq SA

About

MJPG streamer microservice to be used in routing mode for gathering video feeds from the NB USB peripherals into the NB Data Gateway

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published