Skip to content

operations.md

Latest commit

 

History

History
153 lines (103 loc) · 2.43 KB

operations.md

File metadata and controls

153 lines (103 loc) · 2.43 KB

Operativita'

Health Check

Endpoint:

GET /api/health

Esempio:

curl http://localhost:4321/api/health

Risposta attesa:

{
  "ok": true,
  "port": 4321,
  "apacheModuleHint": "a2enmod ssl proxy proxy_ajp proxy_http proxy_wstunnel rewrite headers",
  "generatedDir": "/app/generated"
}

Backup

Backup minimo:

  • data/db.json
  • data/secrets/
  • volume letsencrypt

Docker:

docker run --rm \
  -v apache-proxy-manager_app-data:/data \
  -v "$PWD:/backup" \
  busybox tar czf /backup/app-data.tgz -C /data .

Backup certificati:

docker run --rm \
  -v apache-proxy-manager_letsencrypt:/letsencrypt \
  -v "$PWD:/backup" \
  busybox tar czf /backup/letsencrypt.tgz -C /letsencrypt .

Restore

Ferma il container prima del restore:

docker compose down

Ripristina i volumi e riavvia:

docker compose up -d

Verifica:

curl http://localhost:4321/api/health

Log

Applicazione:

docker compose logs -f apache-proxy-manager

Apache nel container:

docker exec -it apache-proxy-manager ls -la /var/log/apache2

Log dall'interfaccia:

  • Logs generali: registro attivita' applicativo.
  • Logs host: legge CustomLog o ErrorLog configurati nel VirtualHost.

Test Configurazione Apache

Nel container:

docker exec -it apache-proxy-manager apachectl configtest

Reload:

docker exec -it apache-proxy-manager apachectl graceful

Troubleshooting

Il container non diventa healthy

Controlla:

docker logs apache-proxy-manager
docker exec -it apache-proxy-manager curl -fsS http://127.0.0.1:4321/api/health

Cause comuni:

  • Porta 4321 gia' occupata sull'host.
  • Processo Node non avviato.
  • Database JSON non scrivibile.

Apache non ricarica

Controlla:

docker exec -it apache-proxy-manager apachectl configtest

Cause comuni:

  • Certificato referenziato ma non presente.
  • Direttiva custom non valida.
  • Modulo Apache mancante.

Certbot OVH fallisce

Controlla:

  • Endpoint OVH corretto.
  • Application key, application secret e consumer key validi.
  • Dominio gestito dall'account OVH indicato.
  • Tempo DNS propagation sufficiente.

Backend proxy offline

La dashboard usa connessioni TCP verso host e porta delle regole proxy. Se un backend e' marcato offline:

  • Verifica risoluzione DNS dal container.
  • Verifica reachability della porta.
  • Verifica firewall tra container e backend.