saltstack-formulas/prometheus-formula
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Manage a Prometheus installation https://github.com/saltstack-formulas/prometheus-formula
30 Commits 5 Branches 32 Tags 816 KiB
SaltStack 50.5%
Jinja 20.8%
Ruby 18.9%
JavaScript 5.8%
Awk 2.3%
Other 1.7%
7ee67adf71
Go to file
semantic-release-bot 7ee67adf71 chore(release): 3.0.0 [skip ci] 
# [3.0.0](https://github.com/saltstack-formulas/prometheus-formula/compare/v2.0.0...v3.0.0) (2019-06-23)

### Bug Fixes

* **example:** fix pillar.example formatting ([a13dd03](https://github.com/saltstack-formulas/prometheus-formula/commit/a13dd03))
* **repo:** use_upstream_repo corrections; separate users state ([eda47f7](https://github.com/saltstack-formulas/prometheus-formula/commit/eda47f7))
* **service:** ensure service file is removed on clean ([c735a6d](https://github.com/saltstack-formulas/prometheus-formula/commit/c735a6d))
* **suse:** bypass salt alternatives.install errors ([1a890e5](https://github.com/saltstack-formulas/prometheus-formula/commit/1a890e5))
* **systemd:** ensure systemd detects new service ([149dd81](https://github.com/saltstack-formulas/prometheus-formula/commit/149dd81))

### Features

* **archives:** support for archives file format ([1f86f4a](https://github.com/saltstack-formulas/prometheus-formula/commit/1f86f4a))
* **archives:** support for various prometheus archives ([3ec910e](https://github.com/saltstack-formulas/prometheus-formula/commit/3ec910e))
* **archives:** user managementX ([d43033a](https://github.com/saltstack-formulas/prometheus-formula/commit/d43033a))
* **linux:** alternatives support & updated unit tests ([36b3e62](https://github.com/saltstack-formulas/prometheus-formula/commit/36b3e62))

### Tests

* **centos:** verified on CentosOS ([731198d](https://github.com/saltstack-formulas/prometheus-formula/commit/731198d))
* **inspec:** expand unittests for archive format ([b074bd3](https://github.com/saltstack-formulas/prometheus-formula/commit/b074bd3))
* **inspec:** fix tests ([4092fb4](https://github.com/saltstack-formulas/prometheus-formula/commit/4092fb4))

### BREAKING CHANGES

* **repo:** The formula has been refactored to accomodate multiple packages,
archives, users, and repos. Update your pillars and top states
* **archives:** the parameter `pkg` is now a dictionary. References
 to `prometheus.pkg` should be changed to `prometheus.pkg.name`.
2019-06-23 16:56:10 +00:00
docs chore(release): 3.0.0 [skip ci] 2019-06-23 16:56:10 +00:00
prometheus fix(suse): bypass salt alternatives.install errors 2019-06-23 17:01:52 +01:00
test/integration/default test(inspec): fix tests 2019-06-23 17:33:48 +01:00
.gitignore ci(travis): use structure of template-formula 2019-04-25 22:14:39 +02:00
.travis.yml ci(travis): use structure of template-formula 2019-04-25 22:14:39 +02:00
AUTHORS.md chore(release): 3.0.0 [skip ci] 2019-06-23 16:56:10 +00:00
CHANGELOG.md chore(release): 3.0.0 [skip ci] 2019-06-23 16:56:10 +00:00
commitlint.config.js ci(travis): use structure of template-formula 2019-04-25 22:14:39 +02:00
FORMULA chore(release): 3.0.0 [skip ci] 2019-06-23 16:56:10 +00:00
Gemfile ci(travis): use structure of template-formula 2019-04-25 22:14:39 +02:00
kitchen.yml fix(suse): bypass salt alternatives.install errors 2019-06-23 17:01:52 +01:00
LICENSE chore(licence): edited year 2019-04-30 22:12:32 +02:00
pillar.example fix(suse): bypass salt alternatives.install errors 2019-06-23 17:01:52 +01:00
pre-commit_semantic-release.sh ci(travis): use structure of template-formula 2019-04-25 22:14:39 +02:00
release-rules.js ci(travis): use structure of template-formula 2019-04-25 22:14:39 +02:00
release.config.js ci(travis): use structure of template-formula 2019-04-25 22:14:39 +02:00

docs/README.rst

prometheus-formula ================

Travis CI Build Status Semantic Release

Manage Prometheus on MacOS, GNU/Linux and FreeBSD.

Table of Contents

General notes

See the full SaltStack Formulas installation and usage instructions.

If you want to use this formula, please pay attention to the FORMULA file and/or git tag, which contains the currently released version. This formula is versioned according to Semantic Versioning.

See Formula Versioning Section for more details.

Contributing to this repo

Please see https://github.com/saltstack-formulas/prometheus-formula/blob/master/docs/CONTRIBUTING.rst

Available states

prometheus ^^^^^^^^^^^^

Meta-state (This is a state that includes other states).

This installs the prometheus package, manages the prometheus configuration file and then starts the associated prometheus service.

prometheus.archive ^^^^^^^^^^^^^^^^^^^^

This state will install the prometheus from archive file only.

prometheus.archive.alternatives ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This state will install the prometheus linux alternatives for archives only.

prometheus.package ^^^^^^^^^^^^^^^^^^^^

This state will install the prometheus package only.

prometheus.package.repo ^^^^^^^^^^^^^^^^^^^^^^^^^

This state will install the prometheus package only.

prometheus.config ^^^^^^^^^^^^^^^^^^^

This state will configure the prometheus service and has a dependency on prometheus.install via include list.

prometheus.service ^^^^^^^^^^^^^^^^^^^^

This state will start the prometheus service and has a dependency on prometheus.config via include list.

prometheus.clean ^^^^^^^^^^^^^^^^^^

Meta-state (This is a state that includes other states).

this state will undo everything performed in the prometheus meta-state in reverse order, i.e. stops the service, removes the configuration file and then uninstalls the package.

prometheus.service.clean ^^^^^^^^^^^^^^^^^^^^^^^^^^

This state will stop the prometheus service and disable it at boot time.

prometheus.config.clean ^^^^^^^^^^^^^^^^^^^^^^^^^

This state will remove the configuration of the prometheus service and has a dependency on prometheus.service.clean via include list.

prometheus.package.clean ^^^^^^^^^^^^^^^^^^^^^^^^^^

This state will remove the prometheus package and has a depency on prometheus.config.clean via include list.

prometheus.package.archive.clean ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This state will uninstall the prometheus archive-extracted directory only.

prometheus.package.archive.alternatives.clean ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This state will uninstall the prometheus linux alternatives for archives only.

prometheus.package.repo.clean ^^^^^^^^^^^^^^^^^^^^^^^^^

This state will uninstall the prometheus upstream package repository only.

prometheus.exporters

This state will manage prometheus exporters according to Pillar prometheus:exporters. It includes sub-states like prometheus.exporters.node. If you don't want to use Pillar data for this you may use the sub-states directly.