Přeskočit obsah

Aktivace nové aplikace v platformě

Tento průvodce je pro super_adminy (Avaxis tým). Popisuje, jak aktivovat gateway routing pro nově vytvořenou vendor aplikaci, aby ji uživatelé mohli začít používat.

Pro koho je tato stránka

Pouze pro super_adminy s rolí system_role=super_admin. Vendor vývojáři tuto stránku neuvidí — jejich onboarding je popsán v Vendor onboarding.

Co je "gateway routing"

Apps-gateway je interní reverse proxy, která propojuje launcher uživatele s konkrétní vendor aplikací. Bez aktivace gateway:

  • Aplikace existuje v platformě (DB row, Gitea repo, S3 bucket)
  • Vendor může pushovat kód a CI buduje image
  • ALE uživatelé app nemohou používat (gateway ji neroutuje)

Po aktivaci gateway:

  • Backend aplikace je dostupný přes https://api.avaxis.cz/apps/<slug>/*
  • Launcher2 ji nabídne v "Obchodě" k instalaci (pokud is_public=true)

Postup

1. Otevřete launcher jako super_admin

Přihlaste se a otevřete tab Admin (vlevo dole). Pokud tab nevidíte, nemáte super_admin oprávnění.

2. Najděte aplikaci v seznamu

Tab Aplikace → seznam všech aplikací v platformě, abecedně. Vyhledejte nově vytvořenou aplikaci.

Vedle jména uvidíte štítky:

  • public — viditelná v Obchodě
  • backend — má serverovou část (per-app kontejner)
  • ⏳ gateway (šedý) — gateway aktivní, ale stav backendu se zjišťuje
  • ✅ gateway (zelený) — gateway aktivní a backend odpovídá zdravě
  • ❌ gateway (červený) — gateway aktivní, ale backend neodpovídá
  • ⚠ gateway (oranžový) — degraded (rezervováno pro budoucí použití)

Pokud aplikace nemá štítek backend, nepotřebuje gateway routing — má jen klientskou část (.exe).

3. Otevřete detail aplikace

Klik na ▼ Detail vpravo od aplikace v seznamu.

4. Aktivujte gateway

V sekci 🌐 Distribuce zaškrtněte checkbox "Gateway routing (apps-gateway)".

Co se stane:

  1. Backend aplikace se nastaví jako gateway_enabled=true a is_public=true (gateway routuje jen veřejné aplikace).
  2. Apps-gateway si do 1 vteřiny obnoví seznam aplikací (přes Redis pubsub).
  3. Spustí se automatická kontrola zdraví — backend zkouší 30 sekund pingnout /<slug>/health endpoint backendové aplikace.
  4. Štítek ⏳ gateway se přebarví na ✅ gateway (úspěch) nebo ❌ gateway (selhání).

5. Sledujte výsledek health check

Po ~30 sekundách obnovte tab Aplikace (klik jinam a zpět, nebo F5):

  • ✅ gateway — všechno OK. App je dostupná uživatelům.
  • ❌ gateway — kontejner backendu pravděpodobně neběží, nebo /health endpoint nereaguje. Pošlete vendorovi info a po opravě kontejneru znovu zaškrtněte/odškrtněte checkbox pro re-probe.

Časté otázky

Co když checkbox je šedý (nelze zaškrtnout)?

Aplikace nemá štítek backend — je čistě klientská (.exe bez serverové části). Gateway routing nemá smysl, checkbox je proto vypnutý.

Mohu deaktivovat gateway zpětně?

Ano — odškrtnutí checkboxu nastaví gateway_enabled=false. Aplikace přestane být routovaná přes gateway (do ~1 s). Uživatelé, kteří už ji mají nainstalovanou, dostanou při dalším volání 503 / 404.

is_public zůstává true — pokud chcete app skrýt z Obchodu úplně, odškrtněte i checkbox "Viditelné v Obchodě" vedle.

Co když health badge zůstane ⏳ gateway (šedý) trvale?

Pravděpodobně:

  • Background probe v backendu padl (uvicorn worker restartoval během 30 s polingu)
  • Apps-gateway loopback (127.0.0.1:8100) je nedostupný

Řešení: odškrtněte a znovu zaškrtněte checkbox — spustí novou probe. Pokud problém přetrvává, kontaktujte vývojářský tým — interní problém backendu.

Mohu spustit re-probe ručně bez vypnutí gateway?

Aktuálně ne přes UI — workaround je vypnout a zase zapnout checkbox. Probe se znovu spustí. Manuální endpoint je v plánu (TODO Fáze 6).

Co znamená "degraded" stav?

Rezervováno pro budoucí použití — aktuálně se nepoužívá. Bude indikovat pomalou ale funkční aplikaci (např. odpověď > 1 s).

Související