Merge branch 'master' into debian
Roger A. Light
8 years ago
commit
a0916bdd67
@ -0,0 +1,23 @@
|
||||
{
|
||||
"@context": "https://raw.githubusercontent.com/codemeta/codemeta/master/codemeta.jsonld",
|
||||
"@type": "Code",
|
||||
"author": [
|
||||
{
|
||||
"@id": "http://orcid.org/0000-0001-9218-7797",
|
||||
"@type": "Person",
|
||||
"email": "",
|
||||
"name": "Roger A. Light",
|
||||
"affiliation": ""
|
||||
}
|
||||
],
|
||||
"identifier": "",
|
||||
"codeRepository": "https://github.com/eclipse/mosquitto",
|
||||
"datePublished": "2017-05-17",
|
||||
"dateModified": "2017-05-17",
|
||||
"dateCreated": "2017-05-17",
|
||||
"description": "Broker and client implementation of the MQTT protocol.",
|
||||
"keywords": "IoT, MQTT, messaging, pubsub",
|
||||
"license": "EPL 2.0 / EDL 2.0",
|
||||
"title": "Mosquitto",
|
||||
"version": "v1.4.11"
|
||||
}
|
||||
@ -0,0 +1,49 @@
|
||||
---
|
||||
title: 'Mosquitto: server and client implementation of the MQTT protocol'
|
||||
tags:
|
||||
- Internet of Things
|
||||
- MQTT
|
||||
- Pubsub
|
||||
- Messaging
|
||||
authors:
|
||||
- name: Roger A Light
|
||||
orcid: 0000-0001-9218-7797
|
||||
date: 17 May 2017
|
||||
bibliography: paper.bib
|
||||
---
|
||||
|
||||
# Summary
|
||||
|
||||
Mosquitto provides standards compliant server and client implementations of the
|
||||
[MQTT](http://mqtt.org/) messaging protocol. MQTT uses a publish/subscribe
|
||||
model, has low network overhead and can be implemented on low power devices
|
||||
such microcontrollers that might be used in remote Internet of Things sensors.
|
||||
As such, Mosquitto is intended for use in all situations where there is a need
|
||||
for lightweight messaging, particularly on constrained devices with limited
|
||||
resources.
|
||||
|
||||
The Mosquitto project is a member of the [Eclipse Foundation](http://eclipse.org/)
|
||||
|
||||
There are three parts to the project.
|
||||
|
||||
* The main `mosquitto` server
|
||||
* The `mosquitto_pub` and `mosquitto_sub` client utilities that are one method of communicating with an MQTT server
|
||||
* An MQTT client library written in C, with a C++ wrapper
|
||||
|
||||
Mosquitto allows research directly related to the MQTT protocol itself, such as
|
||||
comparing the performance of MQTT and the Constrained Application Protocol
|
||||
(CoAP) [@Thangavel_2014] or investigating the use of OAuth in MQTT
|
||||
[@Fremantle_2014]. Mosquitto supports other research activities as a useful
|
||||
block for building larger systems and has been used to evaluate MQTT for use in
|
||||
Smart City Services [@Antonic_2015], and in the development of an environmental
|
||||
monitoring system [@Bellavista_2017]. Mosquitto has also been used to support
|
||||
research less directly as part of a scheme for remote control of an experiment
|
||||
[@Schulz_2014].
|
||||
|
||||
Outside of academia, Mosquitto is used in other open source projects such as
|
||||
the [openHAB](http://www.openhab.org/) home automation project and
|
||||
[OwnTracks](http://owntracks.org/), the personal location tracking project, and
|
||||
has been integrated into commercial products.
|
||||
|
||||
# References
|
||||
|
||||
@ -0,0 +1,13 @@
|
||||
FROM alpine:3.5
|
||||
MAINTAINER David Audet <david.audet@ca.com>
|
||||
|
||||
LABEL Description="Eclipse Mosquitto MQTT Broker"
|
||||
|
||||
RUN apk --no-cache add mosquitto=1.4.10-r2 && \
|
||||
mkdir -p /mosquitto/config /mosquitto/data /mosquitto/log && \
|
||||
cp /etc/mosquitto/mosquitto.conf /mosquitto/config && \
|
||||
chown -R mosquitto:mosquitto /mosquitto
|
||||
|
||||
COPY docker-entrypoint.sh /
|
||||
ENTRYPOINT ["/docker-entrypoint.sh"]
|
||||
CMD ["/usr/sbin/mosquitto", "-c", "/mosquitto/config/mosquitto.conf"]
|
||||
@ -0,0 +1,49 @@
|
||||
#Eclipse Mosquitto v1.4.10 Docker Image
|
||||
|
||||
##Mount Points
|
||||
|
||||
Three mount points have been created in the image to be used for configuration, persistent storage and logs.
|
||||
```
|
||||
/mosquitto/config
|
||||
/mosquitto/data
|
||||
/mosquitto/log
|
||||
```
|
||||
|
||||
|
||||
##Configuration
|
||||
|
||||
When running the image, the default configuration values are used.
|
||||
To use a custom configuration file, mount a **local** configuration file to `/mosquitto/config/mosquitto.conf`
|
||||
```
|
||||
docker run -it -p 1883:1883 -p 9001:9001 -v <path-to-configuration-file>:/mosquitto/config/mosquitto.conf mosquitto:1.4.10
|
||||
```
|
||||
|
||||
Configuration can be changed to:
|
||||
|
||||
* persist data to `/mosquitto/data`
|
||||
* log to `/mosquitto/log/mosquitto.log`
|
||||
|
||||
i.e. add the following to `mosquitto.conf`:
|
||||
```
|
||||
persistence true
|
||||
persistence_location /mosquitto/data/
|
||||
|
||||
log_dest file /mosquitto/log/mosquitto.log
|
||||
```
|
||||
|
||||
**Note**: If a volume is used, the data will persist between containers.
|
||||
|
||||
##Build
|
||||
Build the image:
|
||||
```
|
||||
docker build -t mosquitto:1.4.10 .
|
||||
```
|
||||
|
||||
##Run
|
||||
Run a container using the new image:
|
||||
```
|
||||
docker run -it -p 1883:1883 -p 9001:9001 -v <path-to-configuration-file>:/mosquitto/config/mosquitto.conf -v /mosquitto/data -v /mosquitto/log mosquitto:1.4.10
|
||||
```
|
||||
:boom: if the mosquitto configuration (mosquitto.conf) was modified
|
||||
to use non-default ports, the docker run command will need to be updated
|
||||
to expose the ports that have been configured.
|
||||
@ -0,0 +1,5 @@
|
||||
#!/bin/ash
|
||||
|
||||
set -e
|
||||
exec "$@"
|
||||
|
||||
@ -0,0 +1,13 @@
|
||||
FROM alpine:3.3
|
||||
MAINTAINER David Audet <david.audet@ca.com>
|
||||
|
||||
LABEL Description="Eclipse Mosquitto MQTT Broker"
|
||||
|
||||
RUN apk --no-cache add mosquitto=1.4.4-r0 && \
|
||||
mkdir -p /mosquitto/config /mosquitto/data /mosquitto/log && \
|
||||
cp /etc/mosquitto/mosquitto.conf /mosquitto/config && \
|
||||
chown -R mosquitto:mosquitto /mosquitto
|
||||
|
||||
COPY docker-entrypoint.sh /
|
||||
ENTRYPOINT ["/docker-entrypoint.sh"]
|
||||
CMD ["/usr/sbin/mosquitto", "-c", "/mosquitto/config/mosquitto.conf"]
|
||||
@ -0,0 +1,49 @@
|
||||
#Eclipse Mosquitto v1.4.4 Docker Image
|
||||
|
||||
##Mount Points
|
||||
|
||||
Three mount points have been created in the image to be used for configuration, persistent storage and logs.
|
||||
```
|
||||
/mosquitto/config
|
||||
/mosquitto/data
|
||||
/mosquitto/log
|
||||
```
|
||||
|
||||
|
||||
##Configuration
|
||||
|
||||
When running the image, the default configuration values are used.
|
||||
To use a custom configuration file, mount a **local** configuration file to `/mosquitto/config/mosquitto.conf`
|
||||
```
|
||||
docker run -it -p 1883:1883 -p 9001:9001 -v <path-to-configuration-file>:/mosquitto/config/mosquitto.conf mosquitto:1.4.4
|
||||
```
|
||||
|
||||
Configuration can be changed to:
|
||||
|
||||
* persist data to `/mosquitto/data`
|
||||
* log to `/mosquitto/log/mosquitto.log`
|
||||
|
||||
i.e. add the following to `mosquitto.conf`:
|
||||
```
|
||||
persistence true
|
||||
persistence_location /mosquitto/data/
|
||||
|
||||
log_dest file /mosquitto/log/mosquitto.log
|
||||
```
|
||||
|
||||
**Note**: If a volume is used, the data will persist between containers.
|
||||
|
||||
##Build
|
||||
Build the image:
|
||||
```
|
||||
docker build -t mosquitto:1.4.4 .
|
||||
```
|
||||
|
||||
##Run
|
||||
Run a container using the new image:
|
||||
```
|
||||
docker run -it -p 1883:1883 -p 9001:9001 -v <path-to-configuration-file>:/mosquitto/config/mosquitto.conf -v /mosquitto/data -v /mosquitto/log mosquitto:1.4.4
|
||||
```
|
||||
:boom: if the mosquitto configuration (mosquitto.conf) was modified
|
||||
to use non-default ports, the docker run command will need to be updated
|
||||
to expose the ports that have been configured.
|
||||
@ -0,0 +1,5 @@
|
||||
#!/bin/ash
|
||||
|
||||
set -e
|
||||
exec "$@"
|
||||
|
||||
@ -0,0 +1,13 @@
|
||||
FROM alpine:3.4
|
||||
MAINTAINER David Audet <david.audet@ca.com>
|
||||
|
||||
LABEL Description="Eclipse Mosquitto MQTT Broker"
|
||||
|
||||
RUN apk --no-cache add mosquitto=1.4.8-r2 && \
|
||||
mkdir -p /mosquitto/config /mosquitto/data /mosquitto/log && \
|
||||
cp /etc/mosquitto/mosquitto.conf /mosquitto/config && \
|
||||
chown -R mosquitto:mosquitto /mosquitto
|
||||
|
||||
COPY docker-entrypoint.sh /
|
||||
ENTRYPOINT ["/docker-entrypoint.sh"]
|
||||
CMD ["/usr/sbin/mosquitto", "-c", "/mosquitto/config/mosquitto.conf"]
|
||||
@ -0,0 +1,49 @@
|
||||
#Eclipse Mosquitto v1.4.8 Docker Image
|
||||
|
||||
##Mount Points
|
||||
|
||||
Three mount points have been created in the image to be used for configuration, persistent storage and logs.
|
||||
```
|
||||
/mosquitto/config
|
||||
/mosquitto/data
|
||||
/mosquitto/log
|
||||
```
|
||||
|
||||
|
||||
##Configuration
|
||||
|
||||
When running the image, the default configuration values are used.
|
||||
To use a custom configuration file, mount a **local** configuration file to `/mosquitto/config/mosquitto.conf`
|
||||
```
|
||||
docker run -it -p 1883:1883 -p 9001:9001 -v <path-to-configuration-file>:/mosquitto/config/mosquitto.conf mosquitto:1.4.8
|
||||
```
|
||||
|
||||
Configuration can be changed to:
|
||||
|
||||
* persist data to `/mosquitto/data`
|
||||
* log to `/mosquitto/log/mosquitto.log`
|
||||
|
||||
i.e. add the following to `mosquitto.conf`:
|
||||
```
|
||||
persistence true
|
||||
persistence_location /mosquitto/data/
|
||||
|
||||
log_dest file /mosquitto/log/mosquitto.log
|
||||
```
|
||||
|
||||
**Note**: If a volume is used, the data will persist between containers.
|
||||
|
||||
##Build
|
||||
Build the image:
|
||||
```
|
||||
docker build -t mosquitto:1.4.8 .
|
||||
```
|
||||
|
||||
##Run
|
||||
Run a container using the new image:
|
||||
```
|
||||
docker run -it -p 1883:1883 -p 9001:9001 -v <path-to-configuration-file>:/mosquitto/config/mosquitto.conf -v /mosquitto/data -v /mosquitto/log mosquitto:1.4.8
|
||||
```
|
||||
:boom: if the mosquitto configuration (mosquitto.conf) was modified
|
||||
to use non-default ports, the docker run command will need to be updated
|
||||
to expose the ports that have been configured.
|
||||
@ -0,0 +1,5 @@
|
||||
#!/bin/ash
|
||||
|
||||
set -e
|
||||
exec "$@"
|
||||
|
||||
@ -0,0 +1,4 @@
|
||||
# Docker Images
|
||||
|
||||
This directory contains the required files to build Mosquitto Docker images.
|
||||
|
||||
@ -0,0 +1,65 @@
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<!-- Created with Inkscape (http://www.inkscape.org/) -->
|
||||
|
||||
<svg
|
||||
xmlns:dc="http://purl.org/dc/elements/1.1/"
|
||||
xmlns:cc="http://creativecommons.org/ns#"
|
||||
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
||||
xmlns:svg="http://www.w3.org/2000/svg"
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
|
||||
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
|
||||
id="svg4136"
|
||||
version="1.1"
|
||||
inkscape:version="0.91 r13725"
|
||||
xml:space="preserve"
|
||||
width="152.76344"
|
||||
height="152.76344"
|
||||
viewBox="0 0 152.76344 152.76344"
|
||||
sodipodi:docname="mosquitto-logo-min.svg"
|
||||
inkscape:export-filename="/home/ral/src/mqtt/mosquitto/logo/mosquitto-14x14.png"
|
||||
inkscape:export-xdpi="8.25"
|
||||
inkscape:export-ydpi="8.25"><metadata
|
||||
id="metadata4142"><rdf:RDF><cc:Work
|
||||
rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
|
||||
rdf:resource="http://purl.org/dc/dcmitype/StillImage" /><dc:title></dc:title></cc:Work></rdf:RDF></metadata><defs
|
||||
id="defs4140" /><sodipodi:namedview
|
||||
pagecolor="#ffffff"
|
||||
bordercolor="#666666"
|
||||
borderopacity="1"
|
||||
objecttolerance="10"
|
||||
gridtolerance="10"
|
||||
guidetolerance="10"
|
||||
inkscape:pageopacity="0"
|
||||
inkscape:pageshadow="2"
|
||||
inkscape:window-width="1280"
|
||||
inkscape:window-height="995"
|
||||
id="namedview4138"
|
||||
showgrid="false"
|
||||
inkscape:zoom="2.4369022"
|
||||
inkscape:cx="79.546492"
|
||||
inkscape:cy="59.284918"
|
||||
inkscape:window-x="1280"
|
||||
inkscape:window-y="0"
|
||||
inkscape:window-maximized="1"
|
||||
inkscape:current-layer="g4144"
|
||||
fit-margin-top="0"
|
||||
fit-margin-left="0"
|
||||
fit-margin-right="0"
|
||||
fit-margin-bottom="0" /><g
|
||||
id="g4144"
|
||||
inkscape:groupmode="layer"
|
||||
inkscape:label="mosquitto"
|
||||
transform="matrix(1.25,0,0,-1.25,-458.46439,514.07261)"><g
|
||||
id="g3366"
|
||||
transform="translate(-8.0273435e-7,5.3788908)"><path
|
||||
sodipodi:nodetypes="cccsssccc"
|
||||
inkscape:connector-curvature="0"
|
||||
id="path4160"
|
||||
style="fill:#f3771c;fill-opacity:1;fill-rule:evenodd;stroke:none"
|
||||
d="m 427.87689,289.04733 4.33447,42.80506 1.28833,9.39302 c 5.1916,2.194 8.8356,7.3344 8.8356,13.324 0,7.9837 -6.4746,14.4584 -14.4584,14.4584 -7.9838,0 -14.4584,-6.4747 -14.4584,-14.4584 0,-5.9896 3.6439,-11.13 8.8356,-13.324 l 1.12419,-9.14681 z" /><path
|
||||
sodipodi:nodetypes="cccccccsccsccccccsccccccccccccscc"
|
||||
inkscape:connector-curvature="0"
|
||||
id="path4162"
|
||||
style="fill:#3c5280;fill-opacity:1;fill-rule:evenodd;stroke:none"
|
||||
d="m 382.10766,315.26637 c 0,0 -4.36735,5.20003 -7.72292,9.81394 -13.7812,24.8958 -8.5306,56.3422 13.1394,75.42 l 9.4666,-8.4844 8.4197,-7.5492 8.7333,-7.8288 c -3.2664,-2.048 -6.0429,-4.8044 -8.1148,-8.0538 -2.5602,-4.0158 -4.0439,-8.7843 -4.0439,-13.8982 0,-11.4001 7.3721,-21.0816 17.6077,-24.5373 l 0.8807,-12.0308 c -17.0538,3.435 -29.9009,18.5037 -29.9009,36.5681 0,8.0438 2.5472,15.4941 6.8791,21.5875 l -8.356,7.4922 -0.0315,0.0284 c -13.6984,-18.1953 -12.852,-43.4563 1.899,-60.7045 z m 54.05308,14.88224 c 10.2356,3.4557 17.6076,13.1375 17.6076,24.5373 0,5.1139 -1.4836,9.8824 -4.0436,13.8979 -2.0718,3.2494 -4.8484,6.0061 -8.1144,8.0538 l 8.7329,7.8288 8.4206,7.5486 -8e-4,9e-4 9.4666,8.4844 c 21.67,-19.0778 26.9206,-50.5242 13.1394,-75.42 l -7.44339,-10.23339 c -9.13531,8.24259 0,0 -9.13531,8.24259 14.7512,17.2482 15.5976,42.5092 1.8992,60.7045 l -0.0317,-0.0284 -8.356,-7.4922 c 4.3319,-6.0936 6.8791,-13.5439 6.8791,-21.5875 0,-18.0644 -12.8472,-33.1328 -29.9007,-36.5681 z" /></g></g></svg>
|
||||
|
After Width: | Height: | Size: 3.6 KiB |
|
Before Width: | Height: | Size: 4.1 KiB After Width: | Height: | Size: 4.2 KiB |
@ -0,0 +1,3 @@
|
||||
port 1883
|
||||
persistence true
|
||||
user root
|
||||
@ -0,0 +1,49 @@
|
||||
name: mosquitto-simple
|
||||
version: 1.4.11
|
||||
summary: Eclipse Mosquitto MQTT broker
|
||||
description: This is a message broker that supports version 3.1 and 3.1.1 of the MQTT
|
||||
protocol.
|
||||
MQTT provides a method of carrying out messaging using a publish/subscribe
|
||||
model. It is lightweight, both in terms of bandwidth usage and ease of
|
||||
implementation. This makes it particularly useful at the edge of the network
|
||||
where a sensor or other simple device may be implemented using an arduino for
|
||||
example.
|
||||
confinement: strict
|
||||
|
||||
apps:
|
||||
mosquitto:
|
||||
command: usr/local/sbin/mosquitto -c $SNAP/mosquitto.conf
|
||||
daemon: simple
|
||||
restart-condition: always
|
||||
plugs: [network, network-bind]
|
||||
|
||||
|
||||
parts:
|
||||
script:
|
||||
plugin: dump
|
||||
source: snap/
|
||||
prime:
|
||||
- mosquitto.conf
|
||||
|
||||
|
||||
mosquitto:
|
||||
plugin: make
|
||||
source: https://github.com/eclipse/mosquitto
|
||||
source-type: git
|
||||
|
||||
build-packages:
|
||||
- libssl-dev
|
||||
- uuid-dev
|
||||
- libc-ares-dev
|
||||
- xsltproc
|
||||
- docbook-xsl
|
||||
stage-packages:
|
||||
- libssl1.0.0
|
||||
- libuuid1
|
||||
- libc-ares2
|
||||
prime:
|
||||
- usr/local/sbin/mosquitto
|
||||
- lib/*-linux-gnu/libcrypto.so*
|
||||
- lib/*-linux-gnu/libssl.so*
|
||||
- lib/*-linux-gnu/libuuid.so*
|
||||
|
||||
Loading…
Reference in New Issue