mirror of
https://git.rwth-aachen.de/acs/public/villas/web-backend-go/
synced 2025-03-30 00:00:12 +01:00
139 lines
4.2 KiB
Markdown
139 lines
4.2 KiB
Markdown
# <img src="doc/pictures/villas_web.png" width=40 /> VILLASweb-backend-go
|
|
|
|
[](https://git.rwth-aachen.de/acs/public/villas/villasweb-backend-go/commits/master)
|
|
|
|
## Description
|
|
This is a rewrite of the backend for the VILLASweb
|
|
website in Go.
|
|
|
|
## Frameworks
|
|
The backend is build upon [gin-gonic](https://github.com/gin-gonic/gin) and [GORM](http://gorm.io).
|
|
|
|
## Quick start
|
|
|
|
### Docker
|
|
You can use the `Dockerfile.ubuntu` for development and testing.
|
|
To build an tag the image call the following in the top level of the repository:
|
|
|
|
```bash
|
|
$ docker build -f Dockerfile.ubuntu -t villaswebbackendgo:ubuntu .
|
|
```
|
|
|
|
To run an interactive container based on the image call:
|
|
|
|
```bash
|
|
$ docker run --rm -it villaswebbackendgo:ubuntu
|
|
```
|
|
|
|
By using the `--rm` option of docker, the container will be removed upon exit.
|
|
Omit this option if you want the container to persist on your system.
|
|
|
|
Within the container you need to start the PostgreSQL server by invoking the following command:
|
|
|
|
```bash
|
|
$ /etc/init.d/postgresql start
|
|
```
|
|
|
|
Now you are ready to compile an test the code.
|
|
### Compiling
|
|
|
|
```bash
|
|
$ go mod tidy
|
|
$ go build
|
|
```
|
|
|
|
### Testing
|
|
```bash
|
|
$ go mod tidy
|
|
$ cd common
|
|
$ go test -v -args -dbhost=/var/run/postgresql
|
|
```
|
|
|
|
|
|
## PostgreSQL Database
|
|
|
|
**The current repo is tested for PostgreSQL 11 and Go 1.11**
|
|
|
|
Before running the application the user has to setup and configure
|
|
[PostgreSQL](https://www.postgresql.org/).
|
|
Alternatively the provided Dockerfile can be used (see above).
|
|
|
|
To create a new database login to user `postgres` and start `psql`
|
|
```bash
|
|
$ su - postgres
|
|
$ psql
|
|
```
|
|
then
|
|
```sql
|
|
CREATE DATABASE villasdb ;
|
|
```
|
|
|
|
Some usefull commants for `psql`
|
|
```sql
|
|
\c somedb -- connect to a database
|
|
\dt -- list all tables of the database
|
|
\l -- list all databases
|
|
```
|
|
|
|
The default `host` for postgres is `\tmp` and the ssl mode is disabled
|
|
in development. The user can change those setting in
|
|
`common/database.go`.
|
|
|
|
To manage the database one can use [pgAdmin4](https://www.pgadmin.org/).
|
|
Instructions for rpm-based distributions can be found
|
|
[here](https://computingforgeeks.com/how-to-install-pgadmin-4-on-centos-7-fedora-29-fedora-28/).
|
|
The user might have to start pgAdmin as root
|
|
```bash
|
|
$ sudo pythonX /user/lib/pythonX.Y/site-packages/pgadmin4-web/pgAdmin4.py
|
|
```
|
|
where X.Y is the python version. The pgAdmin UI can be accessed by the
|
|
browser at `127.0.0.1:5050`. In case that the user is getting `FATAL:
|
|
Ident authentication failed for user "username"` the authentication for
|
|
local users has to be changed from `ident` to `trust` in `pg_hba.conf`
|
|
file
|
|
```text
|
|
# IPv4 local connections:
|
|
host all all 127.0.0.1/32 trust
|
|
# IPv6 local connections:
|
|
host all all ::1/128 trust
|
|
|
|
```
|
|
To do that edit the configuration file as root
|
|
```bash
|
|
$ sudo vim /var/lib/pgsql/11/data/pg_hba.conf
|
|
```
|
|
|
|
## Copyright
|
|
|
|
2019, Institute for Automation of Complex Power Systems, EONERC
|
|
|
|
## License
|
|
|
|
This project is released under the terms of the [GPL version 3](COPYING.md).
|
|
|
|
```
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
```
|
|
|
|
For other licensing options please consult [Prof. Antonello Monti](mailto:amonti@eonerc.rwth-aachen.de).
|
|
|
|
## Contact
|
|
|
|
[](http://www.acs.eonerc.rwth-aachen.de)
|
|
|
|
- Stefanos Mavros <stefanos.mavros@rwth-aachen.de>
|
|
|
|
[Institute for Automation of Complex Power Systems (ACS)](http://www.acs.eonerc.rwth-aachen.de)
|
|
[EON Energy Research Center (EONERC)](http://www.eonerc.rwth-aachen.de)
|
|
[RWTH University Aachen, Germany](http://www.rwth-aachen.de)
|