touchify/nats-tools repository overview

⁠Supported tags and respective Dockerfile links

• 0.1.0, 0.1, latest (Dockerfile)⁠

This image is updated via pull requests to the touchifyapp/docker-nats-tools GitHub repo⁠.

⁠Tools for NATS⁠: A high-performance cloud native messaging system.

nats is a high performance server for the NATS Messaging System.

⁠Tools included

• nats⁠: Go CLI Application that combines nats sub and pub.
• nats-top⁠: Top like program monitor for NATS.

⁠How to use

⁠As a simple container

# Run NATS tools
$ docker run -it --name nats-tools --link nats-server touchify/nats-tools

# Use nats-cli
nats-tools:/# nats sub -s nats://nats-server:4222 topic &
nats-tools:/# nats pub -s nats://nats-server:4222 topic message

# Use nats-top
nats-tools:/# nats-top -s nats://nats-server:4222

⁠As a Docker 1.12 service cluster

# Run a NATS subscriber.

$ docker service create \
$     --name nats-subscriber \
$     --network nats-network \
$     --replicas 3 \
$     touchify/nats-tools \
$     nats sub -s nats://nats-server:4222 topic

# Run a NATS publisher.

$ docker service create \
$     --name nats-publisher \
$     --network nats-network \
$     --replicas 3 \
$     touchify/nats-tools \
$     I=0; while true; do I=$(expr $I + 1); nats public -s nats://nats-server:4222 topic "message$I"; sleep 1; done

# Run NATS top.

$ docker service create \
$     --name nats-publisher \
$     --network nats-network \
$     --replicas 3 \
$     touchify/nats-tools \
$     nats-top -s nats://nats-server:4222 topic

⁠License

View license information⁠ for the software contained in this image.

⁠Supported Docker versions

This image is officially supported on Docker version 1.12+.

Please see the Docker installation documentation⁠ for details on how to upgrade your Docker daemon.

⁠User Feedback

⁠Documentation

Documentation for this image is stored in the touchifyapp/docker-nats-tools GitHub repo⁠. Be sure to familiarize yourself with the repository's README.md file before attempting a pull request.

⁠Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue⁠.

⁠Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue⁠, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.