78 lines
4.9 KiB
Markdown
78 lines
4.9 KiB
Markdown
|
# Taken - Umbrelapp
|
|||
|
|
|
|||
|
|
> **App: Evolu Relay.** Prioriteit: **A** | Afhankelijk van: –
|
|||
|
|
>
|
|||
|
|
> Actief sinds 25-08-2026. Gepromoveerd uit `Masterplannen/` omdat de gebruiker besloot het pakket meteen te
|
|||
|
|
> maken. De afhankelijkheid op **Proefopstelling** is daarmee geen blokkade meer maar een parallelle bron:
|
|||
|
|
> fase 1 daarvan is af en leverde de feiten waarop dit pakket rust. Wat er nog uit moet komen zijn twee
|
|||
|
|
> vragen die pas bij het installeren pijn doen, en die staan hieronder als eigen taak.
|
|||
|
|
|
|||
|
|
## Volgende stap
|
|||
|
|
|
|||
|
|
- [ ] **De image bouwen op de Umbrel met `tools/evolu-relay/build.sh`.** Dat is de enige stap tussen wat er
|
|||
|
|
nu in de repo staat en een installatie die kan slagen. Het script haalt de broncode op commit
|
|||
|
|
`c03a204` en bouwt de Dockerfile van Trezor; verwacht minuten, want er zit een `yarn install` en een
|
|||
|
|
`yarn build` in. **Eigenaar: gebruiker**
|
|||
|
|
|
|||
|
|
## Fase 1 - De app-map
|
|||
|
|
|
|||
|
|
- [x] **`whatsnext-evolu-relay/` aangemaakt met `umbrel-app.yml` en `docker-compose.yml` (25-08-2026).**
|
|||
|
|
Mapnaam gelijk aan het `id`, met het store-voorvoegsel `whatsnext-`, en de manifestvelden in de
|
|||
|
|
voorgeschreven volgorde
|
|||
|
|
- [x] `data/postgres/.gitkeep` erin, zodat de mount bij de eerste start niet als root wordt aangemaakt
|
|||
|
|
- [x] **`dependencies` weggelaten en niet leeg gezet.** Deze app hangt van geen enkele andere app af; een
|
|||
|
|
leeg veld zou suggereren dat er iets te kiezen valt
|
|||
|
|
- [ ] **Een eigen icoon.** Er staat nu géén `icon` in het manifest, dus de tegel blijft naamloos in de
|
|||
|
|
store. Bewust leeg: een geleend of verkeerd icoon is erger dan geen. **Eigenaar: gebruiker**
|
|||
|
|
|
|||
|
|
## Fase 2 - De compose
|
|||
|
|
|
|||
|
|
- [x] **`app_proxy` met `PROXY_AUTH_ADD: "false"`, en geen eigen `ports:`.** Trezor Suite is geen browser
|
|||
|
|
met een sessiecookie. Dit is het patroon van de eigen `nostr-relay`-app van Umbrel, dus een precedent
|
|||
|
|
en geen omweg; zie [PLAN.md](PLAN.md) §4c
|
|||
|
|
- [x] **Relay en quota-manager uit één image met een ander `command`.** Expliciet en niet leunend op de
|
|||
|
|
`CMD` van de Dockerfile, want daar staat `yarn start` met bovenstrooms zelf een twijfel erbij
|
|||
|
|
- [x] **De quota-manager gaat mee.** Niet omdat de relay hem aanroept, maar omdat de relay elke eigenaar
|
|||
|
|
zonder limietenrij weigert en dit is wat die rijen maakt
|
|||
|
|
- [x] **Postgres onder `${APP_DATA_DIR}/data/postgres`**, wachtwoord uit `${APP_PASSWORD}`, `PGDATA` op een
|
|||
|
|
submap, en `postgres:17-alpine` in plaats van `postgres` kaal
|
|||
|
|
- [x] **Healthcheck op de eigen database en gebruiker**, niet op `-d postgres` zoals bovenstrooms: die
|
|||
|
|
database bestaat hier niet, en dan is de controle groen op het verkeerde antwoord
|
|||
|
|
- [ ] **De images pinnen op een digest.** `postgres:17-alpine` kan meteen, met
|
|||
|
|
`docker buildx imagetools inspect`. De eigen image kan pas als hij in een register staat; zie
|
|||
|
|
[OPEN.md](OPEN.md) punt 1. Beide staan als TODO in de compose
|
|||
|
|
|
|||
|
|
## Fase 3 - Het bouwrecept
|
|||
|
|
|
|||
|
|
- [x] **`tools/evolu-relay/build.sh` (25-08-2026).** Haalt de broncode op een vastgezette commit en bouwt
|
|||
|
|
de Dockerfile van Trezor. Niet hun bouwstappen nabouwen; wat wij toevoegen is de pin
|
|||
|
|
- [x] **Niet in de app-map gezet, en dat is geen netheid.** Een `Dockerfile` staat niet in de
|
|||
|
|
update-whitelist, dus bouwen-in-de-app zou elke nieuwe versie een herinstallatie kosten. Zie
|
|||
|
|
[PLAN.md](PLAN.md) §4f
|
|||
|
|
- [x] **Onder `tools/` en niet onder `build/`:** dat laatste staat in `.gitignore` als bouwselmap, dus het
|
|||
|
|
recept zou stilzwijgend buiten de repo blijven. Gevonden bij het stagen, niet bij het schrijven
|
|||
|
|
- [x] Het script controleert na het ophalen dat de commit is wat hij verwachtte, en faalt hard als dat niet
|
|||
|
|
zo is. Zonder die regel bouwt het stil de verkeerde toestand
|
|||
|
|
|
|||
|
|
## Fase 4 - Installeren en verifiëren op de Umbrel
|
|||
|
|
|
|||
|
|
Niets hiervan is op een laptop te doen. Eigenaar van deze hele fase: **gebruiker**.
|
|||
|
|
|
|||
|
|
- [ ] De image gebouwd (zie "Volgende stap")
|
|||
|
|
- [ ] De app geïnstalleerd, en alle drie de containers blijven draaien
|
|||
|
|
- [ ] **Gecontroleerd of het databaseschema zichzelf aanmaakt.** Niet uitgezocht, en dit is de eerste
|
|||
|
|
plek waar het misgaat als het antwoord nee is. Kijk in de logs van de relay-container
|
|||
|
|
- [ ] Trezor Suite naar `<umbrel>:3851` laten wijzen en een label synchroniseren. **Dit is de enige
|
|||
|
|
controle die telt**, en hij kan mislukken op de eigenaarsregistratie zonder dat er iets mis is met het
|
|||
|
|
pakket
|
|||
|
|
- [ ] De app gestopt en gestart, en de database heeft het overleefd
|
|||
|
|
- [ ] Gecontroleerd dat het toevoegen van deze app Electrum Gate niet raakt
|
|||
|
|
|
|||
|
|
## Geblokkeerd / wacht op
|
|||
|
|
|
|||
|
|
- [ ] **Hoe registreer je een eigenaar bij de quota-manager?** Zonder antwoord kan er niet gesynchroniseerd
|
|||
|
|
worden, ook al draait alles. Wacht op **Proefopstelling** fase 1; begin bij `bruno-collection/` in de
|
|||
|
|
bovenstroomse repo
|
|||
|
|
- [ ] **Accepteert Trezor Suite dit adres, en in welke vorm?** Wacht op **Proefopstelling**, "Volgende
|
|||
|
|
stap". Als het antwoord nee is, is dit pakket zonder waarde
|