delonix net httproute

Reverse-proxy L7/HTTP embutido (`kind: HTTPRoute`) — routing por Host + prefixo de path.

Built-in L7/HTTP reverse proxy (`kind: HTTPRoute`) — routing by Host + path prefix.

Um reverse-proxy HTTP/HTTPS embutido (hyper puro, sem Nginx/Envoy), que corre dentro do netns do holder e roteia por Host + prefixo de path para containers backend na SDN. TLS termina no proxy (self-signed ou secretRef); reload a quente por SIGHUP (as rotas trocam sem downtime, os listeners ficam fixos no arranque). Um container com --expose <porta> auto-regista-se sob <nome>.<namespace>.delonix.internal, sem precisar de nenhum kind: HTTPRoute manual. É o que o kind: Gateway normalmente põe à frente para dar uma única URL pública a vários backends.

A built-in HTTP/HTTPS reverse proxy (pure hyper, no Nginx/Envoy), running inside the holder's netns and routing by Host + path prefix to backend containers on the SDN. TLS terminates at the proxy (self-signed or secretRef); hot reload via SIGHUP (routes swap with no downtime, listeners stay fixed at startup). A container with --expose <port> self-registers under <name>.<namespace>.delonix.internal, with no manual kind: HTTPRoute needed. It's what kind: Gateway normally sits in front of to give several backends a single public URL.

📄 Implementação real em Rust: cmd/httproute.rs

Usage: delonix net httproute [OPTIONS] <COMMAND>

Commands:
  apply  Apply the HTTPRoutes of a manifest (brings up/reloads the proxy)
  rm     Stop the proxy and unpublish the ports (teardown)
  help   Print this message or the help of the given subcommand(s)

Options:
      --l18n <en|pt>
          Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand

  -h, --help
          Print help (see a summary with '-h')

COMMAND MAP:
  Declarative  apply
  Maintenance  rm

EXAMPLES:
  # apply the HTTPRoutes of a manifest — it brings the proxy up, or reloads it
  # in place
  delonix net httproute apply -f delonix-manifest.yaml

  # tear it down and give the host ports back
  delonix net httproute rm

SEE ALSO:
  delonix get · delonix net ingress publish · delonix net tunnel expose ·
  delonix stack apply

  delonix › net › httproute

ExemplosExamples

Estado do proxy + rotas activas — `httproute ls` saiu para o verbo genérico
Proxy state + active routes — `httproute ls` moved to the generic verb
delonix get httproutes

httproute apply

Apply the HTTPRoutes of a manifest (brings up/reloads the proxy)

Usage: delonix net httproute apply [OPTIONS]

Options:
  -f, --file <FILE>
          Manifest file (default `./delonix-manifest.yaml`)

      --l18n <en|pt>
          Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand

  -h, --help
          Print help (see a summary with '-h')

EXAMPLES:
  # the routes from the manifest in this directory
  delonix net httproute apply

  # from a file of your own — a re-apply reloads by SIGHUP, same pid, no
  # dropped connection
  delonix net httproute apply -f examples/httproute.yaml

  # listeners and TLS are fixed when the proxy starts: changing a port means
  # `httproute rm` and then this again
  delonix net httproute apply -f examples/httproute.yaml

SEE ALSO:
  delonix get · delonix net httproute rm · delonix stack apply · delonix
  secret create

  delonix › net › httproute › apply

ExemplosExamples

Aplicar as HTTPRoutes de um manifesto (sobe/recarrega o proxy)
Apply the HTTPRoutes from a manifest (brings up/reloads the proxy)
delonix net httproute apply -f delonix-manifest.yaml

httproute rm

Stop the proxy and unpublish the ports (teardown)

Usage: delonix net httproute rm [OPTIONS]

Options:
      --l18n <en|pt>
          Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand

  -h, --help
          Print help (see a summary with '-h')

EXAMPLES:
  # stop the proxy and unpublish its ports — only the MANUAL routes go, the
  # ones auto-registered by `container run --expose` survive
  delonix net httproute rm

SEE ALSO:
  delonix net httproute apply · delonix get · delonix container rm

  delonix › net › httproute › rm

ExemplosExamples

Parar o proxy e despublicar as portas
Stop the proxy and unpublish the ports
delonix net httproute rm

LaboratórioLab

Um proxy L7, duas apps, uma porta — routing por Host.

delonix net httproute apply -f httproute.yaml
curl app1.local:8443 -H 'Host: app1.local'
curl app2.local:8443 -H 'Host: app2.local'

One L7 proxy, two apps, one port — routing by Host.

delonix net httproute apply -f httproute.yaml
curl app1.local:8443 -H 'Host: app1.local'
curl app2.local:8443 -H 'Host: app2.local'

DesafioChallenge

Em vez de escreveres um kind: HTTPRoute à mão, usa container run --expose 8080 e alcança o container pelo FQDN interno automático (<nome>.<namespace>.delonix.internal) — zero configuração manual de rota.

Instead of writing a kind: HTTPRoute by hand, use container run --expose 8080 and reach the container through the automatic internal FQDN (<name>.<namespace>.delonix.internal) — zero manual route configuration.