github
/
prometheus
mirror of https://github.com/prometheus/prometheus
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
prometheus/docs/installation.md

98 lines
2.6 KiB
Markdown
Raw Normal View History

Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
---
Import querying documentation from prometheus/docs
2017-10-26 13:53:27 +00:00
title: Installation
sort_rank: 2
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
---
Import querying documentation from prometheus/docs
2017-10-26 13:53:27 +00:00
# Installation
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
## 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
Migrate all Docker image references to Docker Hub (#4864) Signed-off-by: noqcks <benny@noqcks.io>
2018-11-16 11:26:10 +00:00
All Prometheus services are available as Docker images on
[Quay.io](https://quay.io/repository/prometheus/prometheus) or
[Docker Hub[(https://hub.docker.com/u/prom/).
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
Running Prometheus on Docker is as simple as `docker run -p 9090:9090
Migrate all Docker image references to Docker Hub (#4864) Signed-off-by: noqcks <benny@noqcks.io>
2018-11-16 11:26:10 +00:00
prom/prometheus`. This starts Prometheus with a sample
configuration and exposes it on port 9090.
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
The Prometheus image uses a volume to store the actual metrics. For
production deployments it is highly recommended to use the
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
[Data Volume Container](https://docs.docker.com/engine/admin/volumes/volumes/)
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
pattern to ease managing the data on Prometheus upgrades.
To provide your own configuration, there are several options. Here are
two examples.
### Volumes & bind-mount
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
Bind-mount your `prometheus.yml` from the host by running:
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
```bash
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
docker run -p 9090:9090 -v /tmp/prometheus.yml:/etc/prometheus/prometheus.yml \
prom/prometheus
```
Or use an additional volume for the config:
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
```bash
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
docker run -p 9090:9090 -v /prometheus-data \
docs: update flags to new double-dash syntax
2017-10-28 10:08:33 +00:00
prom/prometheus --config.file=/prometheus-data/prometheus.yml
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
```
### 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
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
`Dockerfile` like this:
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
```Dockerfile
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
FROM prom/prometheus
ADD prometheus.yml /etc/prometheus/
```
Now build and run it:
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
```bash
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
docker build -t my-prometheus .
docker run -p 9090:9090 my-prometheus
```
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
A more advanced option is to render the configuration dynamically on start
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
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:
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
### Ansible
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
fix link name
2017-11-27 17:22:27 +00:00
* [Cloud Alchemy/ansible-prometheus](https://github.com/cloudalchemy/ansible-prometheus)
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
### Chef
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
* [rayrod2030/chef-prometheus](https://github.com/rayrod2030/chef-prometheus)
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
### Puppet
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
* [puppet/prometheus](https://forge.puppet.com/puppet/prometheus)
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
### SaltStack
Import first batch of Prometheus documentation In order to provide documentation for each individual version, this commit starts moving Prometheus server specific documentation into the repository itself.
2017-10-10 12:58:52 +00:00
* [bechtoldt/saltstack-prometheus-formula](https://github.com/bechtoldt/saltstack-prometheus-formula)