54 lines
1.4 KiB
Markdown
54 lines
1.4 KiB
Markdown
# satbd-explorer
|
|
|
|
A small website to display http://satellite.bar 's BD thèque
|
|
|
|
## Installation
|
|
|
|
### Production
|
|
|
|
For production use, we recommend to use the docker image. You do not want to mess with your server, do you ?
|
|
|
|
In order to run, we need a csv file like one fetched from online.bdgest.com.
|
|
|
|
```bash
|
|
docker build -t satbd .
|
|
mkdir -p /var/lib/satbd/log
|
|
cd /var/lib/satbd
|
|
docker run -d -p 33276:33276 --name satbd-runner --restart=on-failure:10 -v /var/lib/satbd/log:/satbd/tmp/log -v <your_csv_file>:/satbd/data.csv satbd ./satbd-explorer --csv data.csv
|
|
```
|
|
|
|
This will start the app on port 33276, and you can proxy pass your
|
|
frontend http(s) server to that port.
|
|
|
|
As usual with docker, you can `ps`, `logs` , `stop` and `start` the
|
|
container. There is a large cache used by the app. In order to remove
|
|
it, simply `rm` and `run` it again.
|
|
|
|
### Development
|
|
|
|
The web applictaion is constitued of a backend golang server, and an angular frontend.
|
|
|
|
#### Backend
|
|
|
|
It requires go 1.5. Please follow instruction [here](golang.org) to get go.
|
|
|
|
```bash
|
|
# ugly one line command to get all dependencies for package and tests
|
|
go get $(go list -e -f "{{.Imports}} {{.TestImports}}" | tr "[" " " | tr "]" " " | xargs go list -e -f "{{if not .Standard}}{{.ImportPath}}{{end}}")
|
|
make
|
|
```
|
|
|
|
#### Frontend
|
|
|
|
Front end is build using npm and gulp.
|
|
|
|
```
|
|
# if you do not have gulp installed globaly yet
|
|
npm install -g gulp
|
|
npm install
|
|
gulp build
|
|
```
|
|
|
|
|
|
|