You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
100 lines
2.7 KiB
100 lines
2.7 KiB
# Contributing
|
|
|
|
There are multiple ways to develop on the scrutiny codebase locally. The two most popular are:
|
|
- Docker Development Container - only requires docker
|
|
- Run Components Locally - requires smartmontools, golang & nodejs installed locally
|
|
|
|
## Docker Development
|
|
```
|
|
docker build -f docker/Dockerfile . -t analogj/scrutiny
|
|
docker run -it --rm -p 8080:8080 \
|
|
-v /run/udev:/run/udev:ro \
|
|
--cap-add SYS_RAWIO \
|
|
--device=/dev/sda \
|
|
--device=/dev/sdb \
|
|
analogj/scrutiny
|
|
/scrutiny/bin/scrutiny-collector-metrics run
|
|
```
|
|
|
|
|
|
## Local Development
|
|
|
|
### Frontend
|
|
The frontend is written in Angular.
|
|
If you're working on the frontend and can use mocked data rather than a real backend, you can use
|
|
```
|
|
cd webapp/frontend
|
|
npm install
|
|
ng serve
|
|
```
|
|
|
|
However, if you need to also run the backend, and use real data, you'll need to run the following command:
|
|
```
|
|
cd webapp/frontend && ng build --watch --output-path=../../dist --deploy-url="/web/" --base-href="/web/" --prod
|
|
```
|
|
|
|
> Note: if you do not add `--prod` flag, app will display mocked data for api calls.
|
|
|
|
### Backend
|
|
|
|
If you're using the `ng build` command above to generate your frontend, you'll need to create a custom config file and
|
|
override the `web.src.frontend.path` value.
|
|
|
|
```
|
|
# config file for local development. store as scrutiny.yaml
|
|
version: 1
|
|
|
|
web:
|
|
listen:
|
|
port: 8080
|
|
host: 0.0.0.0
|
|
database:
|
|
# can also set absolute path here
|
|
location: ./scrutiny.db
|
|
src:
|
|
frontend:
|
|
path: ./dist
|
|
|
|
|
|
log:
|
|
file: 'web.log' #absolute or relative paths allowed, eg. web.log
|
|
level: DEBUG
|
|
|
|
```
|
|
|
|
Once you've created a config file, you can pass it to the scrutiny binary during startup.
|
|
|
|
```
|
|
go run webapp/backend/cmd/scrutiny/scrutiny.go start --config ./scrutiny.yaml
|
|
```
|
|
|
|
Now visit http://localhost:8080
|
|
|
|
|
|
### Collector
|
|
```
|
|
brew install smartmontools
|
|
go run collector/cmd/collector-metrics/collector-metrics.go run --debug
|
|
```
|
|
|
|
|
|
## Debugging
|
|
|
|
If you need more verbose logs for debugging, you can use the following environmental variables:
|
|
|
|
- `DEBUG=true` - enables debug level logging on both the `collector` and `webapp`
|
|
- `COLLECTOR_DEBUG=true` - enables debug level logging on the `collector`
|
|
- `SCRUTINY_DEBUG=true` - enables debug level logging on the `webapp`
|
|
|
|
In addition, you can instruct scrutiny to write its logs to a file using the following environmental variables:
|
|
|
|
- `COLLECTOR_LOG_FILE=/tmp/collector.log` - write the `collector` logs to a file
|
|
- `SCRUTINY_LOG_FILE=/tmp/web.log` - write the `webapp` logs to a file
|
|
|
|
Finally, you can copy the files from the scrutiny container to your host using the following command(s)
|
|
|
|
```
|
|
docker cp scrutiny:/tmp/collector.log collector.log
|
|
docker cp scrutiny:/tmp/web.log web.log
|
|
```
|