Saltar a contenido

O9.1 - Knowledge Portal Publication

Fecha: 2026-06-01

Objetivo

Publicar oficialmente el Knowledge Portal en https://doc.alpuntodeventa.com.ar/ detras de Nginx Proxy Manager, sin modificar el contenido funcional del portal.

Safe Point

  • git status -sb -> ## main...origin/main
  • git rev-parse HEAD -> 831acb98f5cf32c000bd5babf758e0801cdbe328

DNS validado desde VPS

  • getent ahostsv4 doc.alpuntodeventa.com.ar
  • 46.202.151.32

Ajuste de publicacion del portal

  • knowledge-portal sigue sirviendo el mismo sitio estatico generado por MkDocs Material
  • se ajusto la infraestructura de publicacion para que NPM pueda alcanzarlo en proxy-network
  • estado final del contenedor:
  • bind local: 127.0.0.1:8085 -> 8085
  • red compartida: proxy-network
  • reachability desde NPM: docker exec nginx-proxy-manager curl -I http://knowledge-portal:8085/ -> HTTP/1.1 200 OK

Proxy Host creado en NPM

  • dominio: doc.alpuntodeventa.com.ar
  • forward host: knowledge-portal
  • forward port: 8085
  • scheme: http
  • certificate id: 4
  • SSL forced: true
  • HTTP/2: true
  • HSTS: true
  • archivo generado: /docker/nginx-proxy-manager/data/nginx/proxy_host/4.conf

Certificado Let's Encrypt

  • certificado emitido por NPM: /etc/letsencrypt/live/npm-4/fullchain.pem
  • subject: doc.alpuntodeventa.com.ar
  • issuer: Let's Encrypt YE2
  • validez:
  • notBefore=Jun 1 17:33:49 2026 GMT
  • notAfter=Aug 30 17:33:48 2026 GMT

Validacion funcional

  • HTTP:
  • curl -I http://doc.alpuntodeventa.com.ar/
  • resultado: 301 Moved Permanently a HTTPS
  • HTTPS:
  • curl -I https://doc.alpuntodeventa.com.ar/
  • resultado: HTTP/2 200
  • navegacion:
  • / -> 200
  • /PROJECT-STATE/ -> 200
  • /governance/knowledge/ -> 200
  • busqueda:
  • /search/search_index.json -> 200
  • el indice contiene la palabra Portainer
  • Mermaid:
  • /governance/knowledge/infrastructure/dns-tls/ -> 200
  • el HTML publicado contiene mermaid

Secretos

  • mkdocs build --strict -> OK
  • revision de patron sensible: rg -n -i "api[_-]?key|token|password|secret|bearer |sk-" docs infra README.md mkdocs.yml
  • conclusion: no se agregaron secretos nuevos en los archivos tocados por O9.1

Metodo de despliegue aplicado

  • el checkout del VPS en /opt/openclawai estaba como snapshot sin .git
  • se aplico sync controlado de archivos y luego: docker compose -f infra/knowledge-portal/docker-compose.yml up -d --build
  • el portal quedo publicado sin impacto sobre OpenClaw, Portainer ni el resto de NPM

Resultado

  • doc.alpuntodeventa.com.ar publicado oficialmente
  • Let's Encrypt emitido y activo
  • HTTP -> HTTPS forzado
  • navegacion, busqueda y Mermaid validados