Cómo autoalojar un despliegue
Un despliegue de PointSav es una instancia nombrada y numerada de una configuración de gateway provisionada en infraestructura controlada por el operador. Cada despliegue ejecuta el mismo sustrato de distribución de software que el servicio alojado, con todos los datos y claves almacenados localmente. Esta guía cubre el provisionamiento de una nueva instancia de despliegue, la verificación de que el gateway inicia correctamente y su conexión a la plataforma central.
Para la arquitectura de despliegue, consulta deployment-patterns y edge-deployment. Para el modelo de distribución de software que suministra binarios firmados a tu instancia, consulta software-distribution-substrate.
Antes de empezar
Necesitas:
- Un servidor Linux con al menos 4 GB de RAM y 20 GB de disco disponible
- Una cuenta verificada en
software.pointsav.comcon una licencia de despliegue activa - Un nombre de dominio o dirección IP estática para el punto de conexión del gateway
- Un certificado TLS y su clave privada para la dirección de enlace del gateway
Paso 1: Descarga y verifica el binario del gateway
Sigue authenticate-binary-downloads para descargar y verificar la versión del gateway para tu plataforma. Una vez verificada, instala el binario:
sudo mv pointsav-gateway /usr/local/bin/
sudo chmod +x /usr/local/bin/pointsav-gateway
pointsav-gateway --version
El indicador --version imprime el SHA del build junto al número de versión.
Confirma que coincide con la entrada de las notas de versión que descargaste.
Paso 2: Crea los directorios del despliegue
sudo mkdir -p /etc/pointsav/gateway
sudo mkdir -p /var/lib/pointsav/data
Toda la configuración vive en /etc/pointsav/gateway/. Los datos en tiempo de
ejecución — el registro WORM, la caché local y el almacén de claves — se
escriben en /var/lib/pointsav/data/. Ambas rutas deben ser propiedad del
usuario de proceso que ejecutará el gateway.
Paso 3: Escribe el manifiesto del despliegue
Crea /etc/pointsav/gateway/manifest.toml:
[deployment]
name = "<nombre-de-tu-despliegue>"
instance = 1
licence_token = "<tu-token-de-licencia>"
[gateway]
bind = "0.0.0.0:443"
tls_cert = "/etc/pointsav/gateway/tls.crt"
tls_key = "/etc/pointsav/gateway/tls.key"
[data]
root = "/var/lib/pointsav/data"
name debe coincidir con el nombre de despliegue registrado en
software.pointsav.com. instance es un número entero que distingue
múltiples despliegues de la misma configuración nombrada. Coloca tu
certificado TLS y clave privada en las rutas declaradas bajo [gateway].
Paso 4: Inicia el gateway
sudo -u <usuario-del-proceso> pointsav-gateway \
--manifest /etc/pointsav/gateway/manifest.toml
Para producción, registra esto como un servicio systemd con
Restart=on-failure. El gateway registra en stderr; redirige al destino de
registro preferido en el archivo de unidad.
Paso 5: Verifica que el gateway está en buen estado
curl -sk https://localhost/healthz
# esperado: {"status":"ok","deployment":"<nombre-de-tu-despliegue>-1"}
Si la respuesta es {"status":"licence_error"}, el token de licencia ha
vencido o el campo name no coincide con el nombre de despliegue registrado.
Renueva el token en software.pointsav.com y reinicia. Si la respuesta es un
rechazo de conexión, confirma que el gateway está en ejecución y que el puerto
de enlace está abierto en el firewall del servidor.
Paso 6: Provisiona los módulos posteriores
Con el gateway en buen estado, provisiona los módulos relevantes para tu patrón de despliegue — consulta deployment-patterns para el catálogo de configuraciones disponibles. Para agregar capacidad de inferencia local, configura el servicio Doorman a continuación: consulta configure-doorman.
Véase también
- deployment-patterns — patrones de configuración de gateway y topologías de despliegue
- edge-deployment — arquitectura de instancia edge y modelo de conectividad
- software-distribution-substrate — cómo se entregan las versiones de binarios firmados
- authenticate-binary-downloads — verifica el binario antes de ejecutarlo
- configure-doorman — configura el gateway de inferencia después de que el despliegue esté en funcionamiento