JiriUhlir
50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
# Reverse proxy a Swagger (ROOT_PATH)
|
|
|
|
Tato služba běží v AppFactory za reverzní proxy (Caddy) na veřejné cestě:
|
|
|
|
```text
|
|
https://services.csbot.cz/apps/idoklad
|
|
```
|
|
|
|
## Jak Caddy předává requesty
|
|
|
|
Caddy používá `handle_path`, který prefix `/apps/idoklad` **odstraní** dříve, než
|
|
request dorazí do containeru. Container tedy přijímá routy bez prefixu:
|
|
|
|
```text
|
|
veřejně: GET /apps/idoklad/contacts
|
|
container: GET /contacts
|
|
```
|
|
|
|
Důsledek: `HttpRequest.PathBase` je uvnitř containeru **prázdný**, protože příchozí
|
|
cesta už prefix neobsahuje. Nelze z něj proto odvodit veřejnou cestu pro OpenAPI.
|
|
|
|
## Konfigurace v `Program.cs`
|
|
|
|
- `ROOT_PATH` (env, např. `/apps/idoklad`) je jediný spolehlivý zdroj veřejného prefixu.
|
|
- Z `ROOT_PATH` se sestaví `publicPrefix` (normalizovaný, s úvodním lomítkem).
|
|
- `UsePathBase(publicPrefix)` je za `handle_path` no-op, ale ponechán pro případ proxy,
|
|
která prefix nestrhává (`handle`), aby routy stále seděly.
|
|
- OpenAPI `servers[0].url` se v `PreSerializeFilters` nastaví na `publicPrefix`
|
|
(fallback na `PathBase`, nakonec `/` pro lokální běh).
|
|
|
|
Díky tomu Swagger UI „Try it out" volá `…/apps/idoklad/<endpoint>`, ne kořen domény.
|
|
|
|
## Ověření
|
|
|
|
| Kontrola | Lokálně (bez ROOT_PATH) | S `ROOT_PATH=/apps/idoklad` |
|
|
|---|---|---|
|
|
| `GET /health` | 200 | 200 |
|
|
| `GET /docs` (Swagger UI) | 200 | 200 |
|
|
| `GET /docs/v1/swagger.json` | 200 | 200 |
|
|
| `servers[0].url` v OpenAPI | `/` | `/apps/idoklad` |
|
|
|
|
Veřejně po deploy ověř:
|
|
|
|
```text
|
|
GET https://services.csbot.cz/apps/idoklad/health
|
|
GET https://services.csbot.cz/apps/idoklad/docs
|
|
```
|
|
|
|
a ve Swagger UI, že „Try it out" cílí na `https://services.csbot.cz/apps/idoklad/<endpoint>`.
|