Resolución de problemas

Comienza por el síntoma y luego revisa primero el límite más pequeño.

ObjectOS no arranca

Revisa:

1. Los registros del contenedor.
2. La versión de Node y la instalación de paquetes.
3. Conflictos en PORT.
4. Artefacto faltante.
5. Falta de OS_AUTH_SECRET cuando se esperan endpoints de autenticación.

Para Docker:

docker compose -f docker/docker-compose.yml logs objectos

No se puede cargar el artefacto

Revisa:

• que OS_ARTIFACT_FILE apunte al archivo montado;
• que el archivo exista dentro del contenedor;
• que el archivo sea un JSON válido;
• que el artefacto sea un artefacto compilado de ObjectStack, no metadatos de origen;
• que los permisos del archivo permitan el acceso de lectura.

Dentro de un contenedor:

ls -l /artifacts/objectstack.json

El inicio de sesión falla

Revisa:

• que OS_AUTH_SECRET esté configurado;
• que la URL pública y la URL de callback coincidan;
• que la URL de descubrimiento de OIDC sea accesible desde ObjectOS;
• que los orígenes de confianza incluyan el dominio público;
• que las cookies estén delimitadas al nombre de host correcto del proyecto;
• que el kernel del proyecto tenga la autenticación habilitada.

El usuario no puede ver registros

Revisa:

1. El nombre de host correcto del proyecto.
2. Que el usuario pertenezca a la organización esperada.
3. El permiso read del objeto.
4. La seguridad a nivel de fila.
5. Las reglas de compartición o los registros compartidos.
6. La seguridad de campo si solo faltan algunos campos.

Los ajustes no se pueden editar

Un ajuste puede estar bloqueado por una anulación de entorno. Los ajustes efectivos se resuelven en este orden:

Environment -> Tenant -> User -> Default

Si el entorno proporciona un valor, las ediciones en tiempo de ejecución deberían rechazarse en lugar de sobrescribirlo de forma silenciosa.

Los webhooks o trabajos no se ejecutan

Revisa:

• que la lista requires del artefacto incluya la capacidad necesaria;
• que la imagen de ObjectOS incluya el paquete de servicio opcional;
• que la configuración del servicio de cola/trabajos esté disponible;
• que se permita el acceso de red saliente hacia el destino;
• que los registros de entrega o las ejecuciones de trabajos sean visibles en los diagnósticos de Console.

Errores de base de datos

Revisa:

• la URL de la base de datos y el tipo de controlador;
• el acceso de red desde ObjectOS hacia la base de datos;
• las credenciales y las opciones de TLS;
• los registros de sincronización/migración de esquema;
• la persistencia del almacenamiento si usas SQLite local.