loadbalancer/docs/testing.md

Testing

All project validation should run through Docker-based commands.

Canonical test command

The canonical project validation command is:

docker compose config

Smoke test

After replacing the example backend addresses and starting the stack, verify HTTP routing:

curl -H 'Host: lab.younerd.org' http://LOAD_BALANCER_HOST/
curl -H 'Host: azionelab.org' http://LOAD_BALANCER_HOST/
curl -H 'Host: www.azionelab.org' http://LOAD_BALANCER_HOST/

Then verify TCP TLS connectivity:

openssl s_client -connect LOAD_BALANCER_HOST:443 -servername EXPECTED_DNS_NAME

The certificate shown by openssl should be the backend certificate, not a certificate stored by Traefik.

For the included SNI example:

openssl s_client -connect LOAD_BALANCER_HOST:443 -servername lab.younerd.org
openssl s_client -connect LOAD_BALANCER_HOST:443 -servername azionelab.org
openssl s_client -connect LOAD_BALANCER_HOST:443 -servername www.azionelab.org

Test categories

• Docker/Compose validation: docker compose config.
• Runtime health: docker compose ps.
• Backend health checks: Traefik load-balancer health checks configured per site.
• HTTP route smoke test: curl.
• TLS passthrough smoke test: openssl s_client.