|
|
@@ -1,6 +1,6 @@
|
|
|
# Supported tags and respective `Dockerfile` links
|
|
|
|
|
|
-- [`0.3.0`, `latest` (*Dockerfile*)](https://github.com/nats-io/nats-streaming-docker/blob/1fcbfd456264c5da5888e279d9ea865166eeb3cf/Dockerfile)
|
|
|
+- [`0.3.6`, `latest` (*Dockerfile*)](https://github.com/nats-io/nats-streaming-docker/blob/d4c16d81cdfb43b502983473c4d4f53eb15cdad2/Dockerfile)
|
|
|
|
|
|
For more information about this image and its history, please see [the relevant manifest file (`library/nats-streaming`)](https://github.com/docker-library/official-images/blob/master/library/nats-streaming). This image is updated via [pull requests to the `docker-library/official-images` GitHub repo](https://github.com/docker-library/official-images/pulls?q=label%3Alibrary%2Fnats-streaming).
|
|
|
|
|
|
@@ -25,37 +25,38 @@ $ docker run -d nats-streaming
|
|
|
|
|
|
Output that you would get if you had started with `-ti` instead of `d` (for daemon):
|
|
|
|
|
|
-[INF] Starting nats-streaming-server[test-cluster] version 0.3.0
|
|
|
-[INF] Starting nats-server version 0.9.4
|
|
|
-[INF] Listening for client connections on 0.0.0.0:4222
|
|
|
-[INF] Server is ready
|
|
|
-[INF] STAN: Message store is MEMORY
|
|
|
-[INF] STAN: --------- Store Limits ---------
|
|
|
-[INF] STAN: Channels: 100 *
|
|
|
-[INF] STAN: -------- channels limits -------
|
|
|
-[INF] STAN: Subscriptions: 1000 *
|
|
|
-[INF] STAN: Messages : 1000000 *
|
|
|
-[INF] STAN: Bytes : 976.56 MB *
|
|
|
-[INF] STAN: Age : unlimited *
|
|
|
-[INF] STAN: --------------------------------
|
|
|
+[1] 2016/12/21 17:37:56.743377 [INF] Starting nats-streaming-server[test-cluster] version 0.3.6
|
|
|
+[1] 2016/12/21 17:37:56.743575 [INF] Starting nats-server version 0.9.6
|
|
|
+[1] 2016/12/21 17:37:56.743600 [INF] Starting http monitor on 0.0.0.0:8222
|
|
|
+[1] 2016/12/21 17:37:56.743851 [INF] Listening for client connections on 0.0.0.0:4222
|
|
|
+[1] 2016/12/21 17:37:56.743891 [INF] Server is ready
|
|
|
+[1] 2016/12/21 17:37:57.023416 [INF] STAN: Message store is MEMORY
|
|
|
+[1] 2016/12/21 17:37:57.023453 [INF] STAN: --------- Store Limits ---------
|
|
|
+[1] 2016/12/21 17:37:57.023464 [INF] STAN: Channels: 100 *
|
|
|
+[1] 2016/12/21 17:37:57.023467 [INF] STAN: -------- channels limits -------
|
|
|
+[1] 2016/12/21 17:37:57.023473 [INF] STAN: Subscriptions: 1000 *
|
|
|
+[1] 2016/12/21 17:37:57.023478 [INF] STAN: Messages : 1000000 *
|
|
|
+[1] 2016/12/21 17:37:57.023489 [INF] STAN: Bytes : 976.56 MB *
|
|
|
+[1] 2016/12/21 17:37:57.023502 [INF] STAN: Age : unlimited *
|
|
|
+[1] 2016/12/21 17:37:57.023506 [INF] STAN: --------------------------------
|
|
|
|
|
|
To use a file based store instead, you would run:
|
|
|
|
|
|
$ docker run -d nats-streaming -store file -dir datastore
|
|
|
|
|
|
-[INF] Starting nats-streaming-server[test-cluster] version 0.3.0
|
|
|
-[INF] Starting nats-server version 0.9.4
|
|
|
-[INF] Listening for client connections on 0.0.0.0:4222
|
|
|
-[INF] Server is ready
|
|
|
-[INF] STAN: Message store is FILE
|
|
|
-[INF] STAN: --------- Store Limits ---------
|
|
|
-[INF] STAN: Channels: 100 *
|
|
|
-[INF] STAN: -------- channels limits -------
|
|
|
-[INF] STAN: Subscriptions: 1000 *
|
|
|
-[INF] STAN: Messages : 1000000 *
|
|
|
-[INF] STAN: Bytes : 976.56 MB *
|
|
|
-[INF] STAN: Age : unlimited *
|
|
|
-[INF] STAN: --------------------------------
|
|
|
+[1] 2016/12/21 17:38:25.128903 [INF] Starting nats-streaming-server[test-cluster] version 0.3.6
|
|
|
+[1] 2016/12/21 17:38:25.130717 [INF] Starting nats-server version 0.9.6
|
|
|
+[1] 2016/12/21 17:38:25.130746 [INF] Listening for client connections on 0.0.0.0:4222
|
|
|
+[1] 2016/12/21 17:38:25.130819 [INF] Server is ready
|
|
|
+[1] 2016/12/21 17:38:25.409344 [INF] STAN: Message store is FILE
|
|
|
+[1] 2016/12/21 17:38:25.409422 [INF] STAN: --------- Store Limits ---------
|
|
|
+[1] 2016/12/21 17:38:25.409435 [INF] STAN: Channels: 100 *
|
|
|
+[1] 2016/12/21 17:38:25.409440 [INF] STAN: -------- channels limits -------
|
|
|
+[1] 2016/12/21 17:38:25.409445 [INF] STAN: Subscriptions: 1000 *
|
|
|
+[1] 2016/12/21 17:38:25.409450 [INF] STAN: Messages : 1000000 *
|
|
|
+[1] 2016/12/21 17:38:25.409464 [INF] STAN: Bytes : 976.56 MB *
|
|
|
+[1] 2016/12/21 17:38:25.409495 [INF] STAN: Age : unlimited *
|
|
|
+[1] 2016/12/21 17:38:25.409505 [INF] STAN: --------------------------------
|
|
|
|
|
|
You can also connect to a remote NATS Server running in a docker image.
|
|
|
First, run NATS Server:
|
|
|
@@ -64,19 +65,18 @@ $ docker run -d --name=nats-main nats
|
|
|
|
|
|
Now, start the Streaming server and link it to the above docker image:
|
|
|
|
|
|
-$ docker run -d --link nats-main nats-streaming -ns nats://nats-main:4222
|
|
|
+$ docker run -d --link nats-main nats-streaming -store file -dir datastore -ns nats://nats-main:4222
|
|
|
|
|
|
-[INF] Starting nats-streaming-server[test-cluster] version 0.3.0
|
|
|
-[INF] Server is ready
|
|
|
-[INF] STAN: Message store is MEMORY
|
|
|
-[INF] STAN: --------- Store Limits ---------
|
|
|
-[INF] STAN: Channels: 100 *
|
|
|
-[INF] STAN: -------- channels limits -------
|
|
|
-[INF] STAN: Subscriptions: 1000 *
|
|
|
-[INF] STAN: Messages : 1000000 *
|
|
|
-[INF] STAN: Bytes : 976.56 MB *
|
|
|
-[INF] STAN: Age : unlimited *
|
|
|
-[INF] STAN: --------------------------------
|
|
|
+[1] 2016/12/21 17:40:51.007013 [INF] Starting nats-streaming-server[test-cluster] version 0.3.6
|
|
|
+[1] 2016/12/21 17:40:51.419640 [INF] STAN: Message store is FILE
|
|
|
+[1] 2016/12/21 17:40:51.419752 [INF] STAN: --------- Store Limits ---------
|
|
|
+[1] 2016/12/21 17:40:51.419779 [INF] STAN: Channels: 100 *
|
|
|
+[1] 2016/12/21 17:40:51.419799 [INF] STAN: -------- channels limits -------
|
|
|
+[1] 2016/12/21 17:40:51.419820 [INF] STAN: Subscriptions: 1000 *
|
|
|
+[1] 2016/12/21 17:40:51.420004 [INF] STAN: Messages : 1000000 *
|
|
|
+[1] 2016/12/21 17:40:51.420083 [INF] STAN: Bytes : 976.56 MB *
|
|
|
+[1] 2016/12/21 17:40:51.420275 [INF] STAN: Age : unlimited *
|
|
|
+[1] 2016/12/21 17:40:51.420711 [INF] STAN: --------------------------------
|
|
|
|
|
|
Notice that the output shows that the NATS Server was not started, as opposed to the first output.
|
|
|
|
|
|
@@ -96,6 +96,9 @@ Streaming Server Options:
|
|
|
-ma, --max_age <seconds> Max duration a message can be stored ("0s" for unlimited)
|
|
|
-ns, --nats_server <url> Connect to this external NATS Server (embedded otherwise)
|
|
|
-sc, --stan_config <file> Streaming server configuration file
|
|
|
+ -hbi, --hb_interval <duration> Interval at which server sends heartbeat to a client
|
|
|
+ -hbt, --hb_timeout <duration> How long server waits for a heartbeat response
|
|
|
+ -hbf, --hb_fail_count <number> Number of failed heartbeats before server closes the client connection
|
|
|
|
|
|
Streaming Server File Store Options:
|
|
|
--file_compact_enabled Enable file compaction
|
|
|
@@ -106,7 +109,10 @@ Streaming Server File Store Options:
|
|
|
--file_crc Enable file CRC-32 checksum
|
|
|
--file_crc_poly <int> Polynomial used to make the table used for CRC-32 checksum
|
|
|
--file_sync Enable File.Sync on Flush
|
|
|
- --file_cache Enable messages caching
|
|
|
+ --file_slice_max_msgs Maximum number of messages per file slice (subject to channel limits)
|
|
|
+ --file_slice_max_bytes Maximum file slice size - including index file (subject to channel limits)
|
|
|
+ --file_slice_max_age Maximum file slice duration starting when the first message is stored (subject to channel limits)
|
|
|
+ --file_slice_archive_script Path to script to use if you want to archive a file slice being removed
|
|
|
|
|
|
Streaming Server TLS Options:
|
|
|
-secure Use a TLS connection to the NATS server without
|
|
|
@@ -147,7 +153,7 @@ TLS Options:
|
|
|
--tls Enable TLS, do not verify clients (default: false)
|
|
|
--tlscert <file> Server certificate file
|
|
|
--tlskey <file> Private key for server certificate
|
|
|
- --tlsverify Enable TLS, very client certificates
|
|
|
+ --tlsverify Enable TLS, verify client certificates
|
|
|
--tlscacert <file> Client certificate CA for verification
|
|
|
|
|
|
NATS Clustering Options:
|
|
|
@@ -170,7 +176,7 @@ View [license information](https://github.com/nats-io/nats-streaming-server/blob
|
|
|
|
|
|
# Supported Docker versions
|
|
|
|
|
|
-This image is officially supported on Docker version 1.12.3.
|
|
|
+This image is officially supported on Docker version 1.12.5.
|
|
|
|
|
|
Support for older versions (down to 1.6) is provided on a best-effort basis.
|
|
|
|