separating build and run instructions, so users can just download the released softwa...
authorDaniel Caballero <dani.caba@gmail.com>
Wed, 27 Mar 2019 11:22:48 +0000 (12:22 +0100)
committerBrian Brazil <brian.brazil@robustperception.io>
Wed, 27 Mar 2019 11:22:48 +0000 (11:22 +0000)
Signed-off-by: Daniel Caballero <dani.caba@gmail.com>
README.md

index 53713296c51f738a5541c3274b3a3f5a5eb8479a..67fdbec04d86a946d19c3eabe0a4388c5e696d79 100644 (file)
--- a/README.md
+++ b/README.md
@@ -7,22 +7,42 @@
 The blackbox exporter allows blackbox probing of endpoints over
 HTTP, HTTPS, DNS, TCP and ICMP.
 
-## Building and running
+## Running this software
 
-### Local Build
+### From binaries
+
+Download the most suitable binary from [the releases tab](https://github.com/prometheus/blackbox_exporter/releases)
+
+Then:
 
-    make
     ./blackbox_exporter <flags>
 
+
+### Using the docker image
+
+*Note: You may want to [enable ipv6 in your docker configuration](https://docs.docker.com/v17.09/engine/userguide/networking/default_network/ipv6/)*
+
+    docker run --rm -d -p 9115:9115 --name blackbox_exporter -v `pwd`:/config prom/blackbox-exporter:master --config.file=/config/blackbox.yml
+
+### Checking the results
+
 Visiting [http://localhost:9115/probe?target=google.com&module=http_2xx](http://localhost:9115/probe?target=google.com&module=http_2xx)
 will return metrics for a HTTP probe against google.com. The `probe_success`
 metric indicates if the probe succeeded. Adding a `debug=true` parameter
 will return debug information for that probe.
 
+## Building the software
+
+### Local Build
+
+    make
+
+
 ### Building with Docker
 
+After a successful local build:
+
     docker build -t blackbox_exporter .
-    docker run -d -p 9115:9115 --name blackbox_exporter -v `pwd`:/config blackbox_exporter --config.file=/config/blackbox.yml
 
 ## [Configuration](CONFIGURATION.md)