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

103 lines
2.9 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.
Integrate changes from prometheus/docs
2017-10-26 13:42:07 +00:00
NOTE: **Note:** The documentation on this website refers to the latest stable
release (excluding pre-releases). The branch
[next-release](https://github.com/prometheus/docs/compare/next-release) refers
to unreleased changes that are in master branches of source repos.
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 Docker
All Prometheus services are available as Docker images under the
[prom](https://hub.docker.com/u/prom/) organization.
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 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 \
prom/prometheus -config.file=/prometheus-data/prometheus.yml
```
### 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
* [griggheo/ansible-prometheus](https://github.com/griggheo/ansible-prometheus)
* [William-Yeh/ansible-prometheus](https://github.com/William-Yeh/ansible-prometheus)
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)