prometheus/docs/installation.md

103 lines
2.6 KiB
Markdown
Raw Normal View History

---
title: Installation
sort_rank: 2
---
# Installation
## Using pre-compiled binaries
We provide precompiled binaries for most official Prometheus components. Check
out the [download section](https://prometheus.io/download) for a list of all
available versions.
## From source
For building Prometheus components from source, see the `Makefile` targets in
the respective repository.
## Using Docker
All Prometheus services are available as Docker images on
[Quay.io](https://quay.io/repository/prometheus/prometheus) or
[Docker Hub](https://hub.docker.com/r/prom/prometheus/).
Running Prometheus on Docker is as simple as `docker run -p 9090:9090
prom/prometheus`. This starts Prometheus with a sample
configuration and exposes it on port 9090.
The Prometheus image uses a volume to store the actual metrics. For
production deployments it is highly recommended to use a
[named volume](https://docs.docker.com/storage/volumes/)
to ease managing the data on Prometheus upgrades.
To provide your own configuration, there are several options. Here are
two examples.
### Volumes & bind-mount
2017-10-26 06:42:07 -07:00
Bind-mount your `prometheus.yml` from the host by running:
2017-10-26 06:42:07 -07:00
```bash
docker run \
-p 9090:9090 \
-v /path/to/prometheus.yml:/etc/prometheus/prometheus.yml \
prom/prometheus
```
Or bind-mount the directory containing `prometheus.yml` onto
`/etc/prometheus` by running:
2017-10-26 06:42:07 -07:00
```bash
docker run \
-p 9090:9090 \
-v /path/to/config:/etc/prometheus \
prom/prometheus
```
### Custom image
To avoid managing a file on the host and bind-mount it, the
configuration can be baked into the image. This works well if the
configuration itself is rather static and the same across all
environments.
For this, create a new directory with a Prometheus configuration and a
2017-10-26 06:42:07 -07:00
`Dockerfile` like this:
2017-10-26 06:42:07 -07:00
```Dockerfile
FROM prom/prometheus
ADD prometheus.yml /etc/prometheus/
```
Now build and run it:
2017-10-26 06:42:07 -07:00
```bash
docker build -t my-prometheus .
docker run -p 9090:9090 my-prometheus
```
2017-10-26 06:42:07 -07:00
A more advanced option is to render the configuration dynamically on start
with some tooling or even have a daemon update it periodically.
## Using configuration management systems
If you prefer using configuration management systems you might be interested in
the following third-party contributions:
2017-10-26 06:42:07 -07:00
### Ansible
2017-11-27 09:22:27 -08:00
* [Cloud Alchemy/ansible-prometheus](https://github.com/cloudalchemy/ansible-prometheus)
2017-10-26 06:42:07 -07:00
### Chef
* [rayrod2030/chef-prometheus](https://github.com/rayrod2030/chef-prometheus)
2017-10-26 06:42:07 -07:00
### Puppet
* [puppet/prometheus](https://forge.puppet.com/puppet/prometheus)
2017-10-26 06:42:07 -07:00
### SaltStack
* [saltstack-formulas/prometheus-formula](https://github.com/saltstack-formulas/prometheus-formula)