KISS healthcheck implemented in Python and Bash
Project description
InfraCheck
==========
[![Documentation Status](https://readthedocs.org/projects/infracheck/badge/?version=latest)](https://infracheck.docs.riotkit.org/en/latest/?badge=latest)
[![Build Status](https://travis-ci.org/riotkit-org/infracheck.svg?branch=master)](https://travis-ci.org/riotkit-org/infracheck)
![GitHub release](https://img.shields.io/github/release/riotkit-org/infracheck.svg?style=popout)
![PyPI](https://img.shields.io/pypi/v/infracheck.svg?style=popout)
[![codecov](https://codecov.io/gh/riotkit-org/infracheck/branch/master/graph/badge.svg)](https://codecov.io/gh/riotkit-org/infracheck)
Health check system designed to be easy to extend by not enforcing the programming language.
A single health check unit (let we call it later just 'check') can be written even in BASH.
Dictionary
----------
- `script` - a script that is checking something
- `check` - your definition (input arguments) how to use a `check` eg. "type": http + params what is the URL, you can define multiple configurations for single check
Guide to "check" creation
-------------------------
1. Write a `script` in any programming language, take environment variables as input (skip this step if you want to use existing pre-defined scripts)
2. Create a json `check` that will contain a working configuration example for your `script`.
Running
-------
See a working example in the `./example` directory.
```bash
# from this directory
make install
infracheck --help
```
docker or docker-compose:
```yaml
version: '2'
services:
healthcheck:
image: wolnosciowiec/infracheck
command: " --directory=/data --server-path-prefix=/some-prefix"
volumes:
# place your health checks structure at ./healthchecks
- "./healthchecks:/data"
- "/var/run/docker.sock:/var/run/docker.sock:ro"
ports:
- "8000:8000"
#labels:
# - "traefik.frontend.rule=Host: health.localhost; PathPrefix: /some-prefix"
# - "traefik.enable=true"
# - "traefik.basic.protocol=${PROTO}"
# - "traefik.port=8000"
```
==========
[![Documentation Status](https://readthedocs.org/projects/infracheck/badge/?version=latest)](https://infracheck.docs.riotkit.org/en/latest/?badge=latest)
[![Build Status](https://travis-ci.org/riotkit-org/infracheck.svg?branch=master)](https://travis-ci.org/riotkit-org/infracheck)
![GitHub release](https://img.shields.io/github/release/riotkit-org/infracheck.svg?style=popout)
![PyPI](https://img.shields.io/pypi/v/infracheck.svg?style=popout)
[![codecov](https://codecov.io/gh/riotkit-org/infracheck/branch/master/graph/badge.svg)](https://codecov.io/gh/riotkit-org/infracheck)
Health check system designed to be easy to extend by not enforcing the programming language.
A single health check unit (let we call it later just 'check') can be written even in BASH.
Dictionary
----------
- `script` - a script that is checking something
- `check` - your definition (input arguments) how to use a `check` eg. "type": http + params what is the URL, you can define multiple configurations for single check
Guide to "check" creation
-------------------------
1. Write a `script` in any programming language, take environment variables as input (skip this step if you want to use existing pre-defined scripts)
2. Create a json `check` that will contain a working configuration example for your `script`.
Running
-------
See a working example in the `./example` directory.
```bash
# from this directory
make install
infracheck --help
```
docker or docker-compose:
```yaml
version: '2'
services:
healthcheck:
image: wolnosciowiec/infracheck
command: " --directory=/data --server-path-prefix=/some-prefix"
volumes:
# place your health checks structure at ./healthchecks
- "./healthchecks:/data"
- "/var/run/docker.sock:/var/run/docker.sock:ro"
ports:
- "8000:8000"
#labels:
# - "traefik.frontend.rule=Host: health.localhost; PathPrefix: /some-prefix"
# - "traefik.enable=true"
# - "traefik.basic.protocol=${PROTO}"
# - "traefik.port=8000"
```
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
infracheck-1.0.2.dev14.tar.gz
(42.4 kB
view hashes)
Built Distribution
Close
Hashes for infracheck-1.0.2.dev14-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 89bd77c3e65c06ec9a80d1ccaf17d4969d314858329049e1c9b17749b1bd83f6 |
|
MD5 | 56f2a3bb20c123b234c31914f34f1fa3 |
|
BLAKE2b-256 | 32072d201dc2b9cdf6835809de711ae7c1d5bfe11974e7c648d8a669edebdd69 |