using github container registry images.
update documentation to enable persistence by default update docs to include influxdb
This commit is contained in:
@@ -72,6 +72,8 @@ If you're using Docker, getting started is as simple as running the following co
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker run -it --rm -p 8080:8080 \
|
docker run -it --rm -p 8080:8080 \
|
||||||
|
-v `pwd`/scrutiny:/scrutiny/config \
|
||||||
|
-v `pwd`/influxdb2:/var/lib/influxdb2 \
|
||||||
-v /run/udev:/run/udev:ro \
|
-v /run/udev:/run/udev:ro \
|
||||||
--cap-add SYS_RAWIO \
|
--cap-add SYS_RAWIO \
|
||||||
--device=/dev/sda \
|
--device=/dev/sda \
|
||||||
@@ -84,21 +86,27 @@ docker run -it --rm -p 8080:8080 \
|
|||||||
- `--cap-add SYS_RAWIO` is necessary to allow `smartctl` permission to query your device SMART data
|
- `--cap-add SYS_RAWIO` is necessary to allow `smartctl` permission to query your device SMART data
|
||||||
- NOTE: If you have **NVMe** drives, you must add `--cap-add SYS_ADMIN` as well. See issue [#26](https://github.com/AnalogJ/scrutiny/issues/26#issuecomment-696817130)
|
- NOTE: If you have **NVMe** drives, you must add `--cap-add SYS_ADMIN` as well. See issue [#26](https://github.com/AnalogJ/scrutiny/issues/26#issuecomment-696817130)
|
||||||
- `--device` entries are required to ensure that your hard disk devices are accessible within the container.
|
- `--device` entries are required to ensure that your hard disk devices are accessible within the container.
|
||||||
- `analogj/scrutiny` is a omnibus image, containing both the webapp server (frontend & api) as well as the S.M.A.R.T metric collector. (see below)
|
- `ghcr.io/analogj/scrutiny:master-omnibus` is a omnibus image, containing both the webapp server (frontend & api) as well as the S.M.A.R.T metric collector. (see below)
|
||||||
|
|
||||||
### Hub/Spoke Deployment
|
### Hub/Spoke Deployment
|
||||||
|
|
||||||
In addition to the Omnibus image (available under the `latest` tag) there are 2 other Docker images available:
|
In addition to the Omnibus image (available under the `latest` tag) there are 2 other Docker images available:
|
||||||
|
|
||||||
- `analogj/scrutiny:collector` - Contains the Scrutiny data collector, `smartctl` binary and cron-like scheduler. You can run one collector on each server.
|
- `ghcr.io/analogj/scrutiny:master-collector` - Contains the Scrutiny data collector, `smartctl` binary and cron-like scheduler. You can run one collector on each server.
|
||||||
- `analogj/scrutiny:web` - Contains the Web UI, API and Database. Only one container necessary
|
- `ghcr.io/analogj/scrutiny:master-web` - Contains the Web UI, API and Database. Only one container necessary
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker run -it --rm -p 8080:8080 \
|
docker run --rm -p 8086:8086 \
|
||||||
|
-v `pwd`/influxdb2:/var/lib/influxdb2 \
|
||||||
|
--name scrutiny-web \
|
||||||
|
influxdb:2.2
|
||||||
|
|
||||||
|
docker run --rm -p 8080:8080 \
|
||||||
|
-v `pwd`/scrutiny:/scrutiny/config \
|
||||||
--name scrutiny-web \
|
--name scrutiny-web \
|
||||||
ghcr.io/analogj/scrutiny:master-web
|
ghcr.io/analogj/scrutiny:master-web
|
||||||
|
|
||||||
docker run -it --rm \
|
docker run --rm \
|
||||||
-v /run/udev:/run/udev:ro \
|
-v /run/udev:/run/udev:ro \
|
||||||
--cap-add SYS_RAWIO \
|
--cap-add SYS_RAWIO \
|
||||||
--device=/dev/sda \
|
--device=/dev/sda \
|
||||||
|
|||||||
Vendored
+2
@@ -1,3 +1,5 @@
|
|||||||
|
# This vagrant file is only used for local development & testing.
|
||||||
|
|
||||||
Vagrant.configure("2") do |config|
|
Vagrant.configure("2") do |config|
|
||||||
config.vm.guest = :freebsd
|
config.vm.guest = :freebsd
|
||||||
config.vm.synced_folder ".", "/vagrant", id: "vagrant-root", disabled: true
|
config.vm.synced_folder ".", "/vagrant", id: "vagrant-root", disabled: true
|
||||||
|
|||||||
@@ -3,7 +3,7 @@ version: '3.5'
|
|||||||
services:
|
services:
|
||||||
scrutiny:
|
scrutiny:
|
||||||
container_name: scrutiny
|
container_name: scrutiny
|
||||||
image: analogj/scrutiny
|
image: ghcr.io/analogj/scrutiny:master-omnibus
|
||||||
cap_add:
|
cap_add:
|
||||||
- SYS_RAWIO
|
- SYS_RAWIO
|
||||||
ports:
|
ports:
|
||||||
@@ -11,6 +11,7 @@ services:
|
|||||||
volumes:
|
volumes:
|
||||||
- /run/udev:/run/udev:ro
|
- /run/udev:/run/udev:ro
|
||||||
- ./config:/scrutiny/config
|
- ./config:/scrutiny/config
|
||||||
|
- ./influxdb:/var/lib/influxdb2
|
||||||
devices:
|
devices:
|
||||||
- "/dev/sda"
|
- "/dev/sda"
|
||||||
- "/dev/sdb"
|
- "/dev/sdb"
|
||||||
|
|||||||
@@ -132,6 +132,8 @@ chmod +x /opt/scrutiny/bin/scrutiny-collector-metrics-linux-amd64
|
|||||||
|
|
||||||
Next, we will manually trigger the collector, to populate the Scrutiny dashboard:
|
Next, we will manually trigger the collector, to populate the Scrutiny dashboard:
|
||||||
|
|
||||||
|
> NOTE: if you need to pass a config file to the scrutiny collector, you can provide it using the `--config` flag.
|
||||||
|
|
||||||
```
|
```
|
||||||
/opt/scrutiny/bin/scrutiny-collector-metrics-linux-amd64 run --api-endpoint "http://localhost:8080"
|
/opt/scrutiny/bin/scrutiny-collector-metrics-linux-amd64 run --api-endpoint "http://localhost:8080"
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -19,13 +19,13 @@ To install, simply click 'Install'; the configuration parameters should not need
|
|||||||
|
|
||||||
As a docker image can be created using various OS bases, the image choice is entirely the users choice. Recommendations of a specific image from a specific maintainer is beyond the scope of this guide. However, to provide some context given the number of questions posed regarding the various versions available:
|
As a docker image can be created using various OS bases, the image choice is entirely the users choice. Recommendations of a specific image from a specific maintainer is beyond the scope of this guide. However, to provide some context given the number of questions posed regarding the various versions available:
|
||||||
|
|
||||||
- **analogj/scrutiny**
|
- **ghcr.io/analogj/scrutiny:master-omnibus**
|
||||||
- `Image maintained directly by the application author`
|
- `Image maintained directly by the application author`
|
||||||
- `Debian based docker image`
|
- `Debian based docker image`
|
||||||
- **linuxserver/scrutiny:**
|
- **linuxserver/scrutiny**
|
||||||
- `Image maintained by the LinuxServer.io group`
|
- `Image maintained by the LinuxServer.io group`
|
||||||
- `Alpine based docker image`
|
- `Alpine based docker image`
|
||||||
- **hotio/scrutiny:**
|
- **hotio/scrutiny**
|
||||||
- `Image maintained by hotio`
|
- `Image maintained by hotio`
|
||||||
- `DETAILS TBD`
|
- `DETAILS TBD`
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user