Health and network profiles

Health profile

The health profile controls how verify decides whether the app is usable. It should match the path users actually depend on, not only process existence.

Common fields:

• Health check type, such as HTTP.
• Check path, such as /health.
• Expected status code.
• Interval, timeout, retries, and start period.

If no health check is configured, Appaloft can fall back to weaker runtime checks, but UI and docs should make that clear.

Network profile

The network profile describes listener ports, protocols, and proxy targets. It answers where the proxy should send traffic.

Common fields:

• Internal listener port.
• Protocol, such as HTTP.
• Whether proxy/public access is required.
• Optional service name or target hint.

Custom domains are separate access configuration. Make network profile and generated access work before handling DNS/TLS.

Saving the network profile is a durable resource profile edit. It only affects future deployment admission and route planning. It does not edit historical deployment snapshots, immediately apply proxy routes, or restart the current runtime.

Readiness failures

If health checks fail, inspect the listener port, path, startup time, and proxy target before retrying or changing the profile.

Troubleshooting order:

1. Inspect runtime logs.
2. Confirm the app listener port.
3. Confirm health path and expected status.
4. Confirm start period is long enough.
5. Confirm proxy readiness and generated access.

Entrypoints

The Web console should expose health/network fields during resource creation and configuration, including defaults.

The CLI should allow configuring health and network profiles and point failures at the relevant profile rather than a generic failure.

The HTTP API should return profile summaries, latest health observations, and structured errors.

Related pages: Generated access routes and Logs and health.

CLI examples:

Configure HTTP health check

appaloft resource configure-health res_web \
  --path /health \
  --method GET \
  --expected-status 200 \
  --interval 5 \
  --timeout 5 \
  --retries 10 \
  --start-period 15

Configure network profile

appaloft resource configure-network res_web \
  --internal-port 3000 \
  --upstream-protocol http \
  --exposure-mode reverse-proxy