Cómo autoalojar un despliegue — PointSav Documentation

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.

[edit]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.com con 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

[edit]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.

[edit]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.

[edit]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].

[edit]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.

[edit]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.

[edit]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.

[edit]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