2021-01-18 07:06:19 +00:00
|
|
|
## How to install `secretmgr`
|
|
|
|
|
|
|
|
|
|
How to install its dependencies:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# on fedora:
|
|
|
|
|
dnf install -y openldap-devel
|
|
|
|
|
# on ubuntu:
|
|
|
|
|
apt-get install -y libldap2-dev
|
|
|
|
|
|
|
|
|
|
# for eveyrone:
|
|
|
|
|
pip3 install --user --requirement requirements.txt
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## How to use `secretmgr`
|
|
|
|
|
|
|
|
|
|
Check that all secrets are correctly deployed for app `dummy`:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
./secretmgr.py check dummy
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Generate secrets for app `dummy` if they don't already exist:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
./secretmgr.py gen dummy
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Rotate secrets for app `dummy`, overwriting existing ones (be careful, this is dangerous!):
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
./secretmgr.py regen dummy
|
|
|
|
|
```
|
|
|
|
|
|
2020-06-02 10:26:41 +00:00
|
|
|
## How to upgrade our packaged apps to a new version?
|
|
|
|
|
|
|
|
|
|
1. Edit `docker-compose.yml`
|
|
|
|
|
2. Change the `VERSION` variable to the desired version
|
|
|
|
|
3. Increment the docker image tag by 1 (eg: superboum/riot:v13 -> superboum/riot:v14)
|
|
|
|
|
4. Run `docker-compose build`
|
|
|
|
|
5. Run `docker-compose push`
|
|
|
|
|
6. Done
|
