From 81187b7b50f5af5bdb64d75882f4d9c782ad52c3 Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Wed, 31 Dec 2014 16:56:22 -0700 Subject: [PATCH] Add initial rabbitmq docs --- rabbitmq/README-short.txt | 1 + rabbitmq/README.md | 0 rabbitmq/content.md | 61 ++++++++++++++++++++++++++++++++++++++ rabbitmq/license.md | 2 ++ rabbitmq/logo.png | Bin 0 -> 8353 bytes 5 files changed, 64 insertions(+) create mode 100644 rabbitmq/README-short.txt create mode 100644 rabbitmq/README.md create mode 100644 rabbitmq/content.md create mode 100644 rabbitmq/license.md create mode 100644 rabbitmq/logo.png diff --git a/rabbitmq/README-short.txt b/rabbitmq/README-short.txt new file mode 100644 index 000000000..d0ddddeea --- /dev/null +++ b/rabbitmq/README-short.txt @@ -0,0 +1 @@ +RabbitMQ is a highly reliable enterprise messaging system based on the emerging AMQP standard diff --git a/rabbitmq/README.md b/rabbitmq/README.md new file mode 100644 index 000000000..e69de29bb diff --git a/rabbitmq/content.md b/rabbitmq/content.md new file mode 100644 index 000000000..2a79f5e19 --- /dev/null +++ b/rabbitmq/content.md @@ -0,0 +1,61 @@ +# What is RabbitMQ? + +RabbitMQ is open source message broker software (sometimes called +message-oriented middleware) that implements the Advanced Message Queuing +Protocol (AMQP). The RabbitMQ server is written in the Erlang programming +language and is built on the Open Telecom Platform framework for clustering and +failover. Client libraries to interface with the broker are available for all +major programming languages. + +> [wikipedia.org/wiki/RabbitMQ](https://en.wikipedia.org/wiki/RabbitMQ) + +%%LOGO%% + +# How to use this image + +## Running the daemon + +One of the important things to note about RabbitMQ is that it stores data based +on what it calls the "Node Name", which defaults to the hostname. What this +means for usage in Docker is that we should either specify `-h`/`--hostname` or +`-e RABBITMQ_NODENAME=...` explicitly for each daemon so that we don't get a +random hostname and can keep track of our data: + + docker run -d -e RABBITMQ_NODENAME=my-rabbit --name some-rabbit rabbitmq:3 + +If you give that a minute, then do `docker logs some-rabbit`, you'll see in the +output a block similar to: + + =INFO REPORT==== 31-Dec-2014::23:21:09 === + node : my-rabbit@988c28b0eb2e + home dir : /var/lib/rabbitmq + config file(s) : /etc/rabbitmq/rabbitmq.config (not found) + cookie hash : IFQiLgiJ4goGJrdsLJvN7A== + log : undefined + sasl log : undefined + database dir : /var/lib/rabbitmq/mnesia/my-rabbit + +Note the `database dir` there, especially that it has my `RABBITMQ_NODENAME` +appended to the end for the file storage. This image makes all of +`/var/lib/rabbitmq` a volume by default. + +### Management Plugin + +There is a second set of tags provided with the [management +plugin](https://www.rabbitmq.com/management.html) installed and enabled by +default, which is available on the standard management port of 15672, with the +default username and password of `guest` / `guest`: + + docker run -d -e RABBITMQ_NODENAME=my-rabbit --name some-rabbit rabbitmq:3-management + +You can access it by visiting `http://container-ip:15672` in a browser or, if +you need access outside the host, on port 8080: + + docker run -d -e RABBITMQ_NODENAME=my-rabbit --name some-rabbit -p 8080:15672 rabbitmq:3-management + +You can then go to `http://localhost:8080` or `http://host-ip:8080` in a +browser. + +## Connecting to the daemon + + docker run --name some-app --link some-rabbit:rabbit -d application-that-uses-rabbitmq diff --git a/rabbitmq/license.md b/rabbitmq/license.md new file mode 100644 index 000000000..1962af7d6 --- /dev/null +++ b/rabbitmq/license.md @@ -0,0 +1,2 @@ +View [license information](https://www.rabbitmq.com/mpl.html) for the software +contained in this image. diff --git a/rabbitmq/logo.png b/rabbitmq/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..b4979d9acda4af92d331d4dd051166dbe26d980a GIT binary patch literal 8353 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