pub-solar/obs-portal
5
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

Document usage of keycloak users export in upgrade guide

Browse source
This commit is contained in:
Paul Bienkowski 2021-11-17 18:37:54 +01:00
parent e20b291823
commit fbc0e26912
1 changed files with 13 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
UPGRADING.md
View file

@ -20,12 +20,20 @@ explicitly. Once we implement them, their usage will be described in the
it will need to be mounted to `api/config.py` in the container. Ignore the
Keycloak options for now.
* Run the database reset script: `docker-compose run --rm api python tools/reset_database.py`
* Run the database migration script: `docker-compose run --rm api python
tools/import_from_mongodb.py mongodb://mongo/obs`. You might need to adjust
the URL.
* Run the database migration script:
```bash
docker-compose run --rm \
-v $PWD/export:/export \
api \
python tools/import_from_mongodb.py mongodb://mongo/obs \
--keycloak-users-file /export/users.json
```
* Shut down the `mongo` service, you can now remove it from docker-compose.yaml
* Start `keycloak` and configure it, similarly to how it was configured in the
development setup (but choose more secure options). Update the API config
file to match your keycloak configuration.
* Start `api`, `worker` and `frontend`
file to match your keycloak configuration. Import the file
`export/users.json` into your realm, it will re-add all the users from the
old installation. You should delete the file and `export/` folder afterwards.
* Start `api`, `worker` and `frontend`.