sporada/nopaque
1
0
Fork 0
mirror of https://gitlab.ub.uni-bielefeld.de/sfb1288inf/nopaque.git synced 2024-11-15 01:05:42 +00:00
Code Issues Projects Releases Wiki Activity

Add some Readme stuff

Browse Source
This commit is contained in:
Stephan Porada 2020-03-16 10:49:45 +01:00
parent 55b8fe54a8
commit 52e5092d13
1 changed files with 24 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
README.md
View File

@ -44,8 +44,8 @@ A shared network space is necessary so that all swarm members have access to all
``` bash ``` bash
# Example: Create a Samba share via Docker # Example: Create a Samba share via Docker
# More details can be found under https://hub.docker.com/r/dperson/samba/ # More details can be found under https://hub.docker.com/r/dperson/samba/
$ sudo mkdir -p /srv/nopaque/storage sudo mkdir -p /srv/nopaque/storage
$ docker run \ docker run \
--name opaque_storage \ --name opaque_storage \
-v /srv/nopaque/storage:/srv/nopaque/storage \ -v /srv/nopaque/storage:/srv/nopaque/storage \
-p 445:445 \ -p 445:445 \
@ -55,34 +55,41 @@ $ docker run \
-u nopaque;nopaque -u nopaque;nopaque
# Mount the Samba share on all swarm member nodes with the following code # Mount the Samba share on all swarm member nodes with the following code
$ sudo mkdir /mnt/nopaque sudo mkdir /mnt/nopaque
$ sudo mount --types cifs --options gid=${USER},password=nopaque,uid=${USER},user=nopaque,vers=3.0 //<YOUR IP>/storage.nopaque /mnt/nopaque sudo mount --types cifs --options gid=${USER},password=nopaque,uid=${USER},user=nopaque,vers=3.0 //<YOUR IP>/storage.nopaque /mnt/nopaque
``` ```
3. **Download Opaque** 3. **Download Opaque**
``` bash ``` bash
$ git clone https://gitlab.ub.uni-bielefeld.de/sfb1288inf/opaque.git git clone https://gitlab.ub.uni-bielefeld.de/sfb1288inf/opaque.git
$ cd opaque cd opaque
$ docker-compose pull docker-compose pull
``` ```
4. **Configure your instance:** 4. **Configure your instance:**
For production environments it is recommended to activate and secure the Docker HTTP API. You can read more [here](https://gitlab.ub.uni-bielefeld.de/sfb1288inf/opaque_daemon). For production environments it is recommended to activate and secure the Docker HTTP API. You can read more [here](https://gitlab.ub.uni-bielefeld.de/sfb1288inf/opaque_daemon).
``` bash ``` bash
$ mkdir logs mkdir logs
$ cp nopaque.env.tpl nopaque.env cp nopaque.env.tpl nopaque.env
$ <YOUR EDITOR> nopaque.env # Fill out the empty variables within this file. <YOUR EDITOR> nopaque.env # Fill out the empty variables within this file. For the gitlab login either use your credentials (not recommended) Or create a gitlab token
``` ```
5. **Start your instance**
5. Further development instructions
Use the following command to allow docker to pull images from your gitlab registry. TODO: Check if this could also work wit a token?
```bash
docker login gitlab.ub.uni-bielefeld.de:4567
```
6. **Start your instance**
``` bash ``` bash
# Execute the following 3 steps only on first startup # Execute the following 3 steps only on first startup
$ docker-compose run web flask db upgrade docker-compose run web flask db upgrade
$ docker-compose run web flask insert-initial-database-entries docker-compose run web flask insert-initial-database-entries
$ docker-compose down docker-compose down
$ docker-compose up docker-compose up
``` ```
6. **Alter Database Models** 6. **Alter Database Models**
``` bash ``` bash
$ docker-compose run web flask db migrate docker-compose run web flask db migrate
$ docker-compose run web flask db upgrade docker-compose run web flask db upgrade
``` ```