RESOURCE CATALOG
Gateway
Receives traffic, distributes across replicas, manages domain and TLS.
type: "gateway"analogous to load balancer + DNS + TLS issuerDefinition
Combines traffic balancing, domain management, and automatic TLS via Let's Encrypt. Points to a target Compute through the alvo_recurso_id field.
When to use
- Every publicly exposed web or API Compute.
- When the Project uses a custom domain with HTTPS.
When not to use
- Workers and crons — they do not receive external traffic.
- Internal service communication — use Fabric.
Configuration fields
Each field is validated at creation time. Defaults apply when fields are omitted.
config · gateway
| Campo | Tipo | Default · Opções |
|---|---|---|
dominio Domínio | string | Default exemplo.com.br |
tls HTTPS automático | bool | Default true |
alvo_recurso_id VM destino | ref → compute | — |
Examples
Full payloads for POST to /api/projetos/{id}/recursos:
Domain with HTTPS
json
{
"tipo": "gateway",
"nome": "loja-dns",
"config": {
"dominio": "loja.acme.com.br",
"tls": true,
"alvo_recurso_id": "<id_da_aplicacao_web>"
}
}