Dépannage

Commencez par le symptôme, puis vérifiez d'abord la plus petite limite.

ObjectOS ne démarre pas

Vérifiez :

1. Les journaux du conteneur.
2. La version de Node et l'installation des paquets.
3. Un conflit de PORT.
4. Un artefact manquant.
5. L'absence de OS_AUTH_SECRET lorsque des points de terminaison d'authentification sont attendus.

Pour Docker :

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

L'artefact ne peut pas être chargé

Vérifiez :

• que OS_ARTIFACT_FILE pointe vers le fichier monté ;
• que le fichier existe à l'intérieur du conteneur ;
• que le fichier est un JSON valide ;
• que l'artefact est un artefact ObjectStack compilé, et non des métadonnées source ;
• que les permissions du fichier autorisent l'accès en lecture.

À l'intérieur d'un conteneur :

ls -l /artifacts/objectstack.json

La connexion échoue

Vérifiez :

• que OS_AUTH_SECRET est configuré ;
• que l'URL publique et l'URL de rappel correspondent ;
• que l'URL de découverte OIDC est joignable depuis ObjectOS ;
• que les origines de confiance incluent le domaine public ;
• que les cookies sont limités au nom d'hôte de projet correct ;
• que le kernel du projet a l'authentification activée.

Un utilisateur ne voit pas les enregistrements

Vérifiez :

1. Le nom d'hôte de projet correct.
2. Que l'utilisateur appartient à l'organisation attendue.
3. La permission read sur l'objet.
4. La sécurité au niveau des lignes.
5. Les règles de partage ou les partages d'enregistrements.
6. La sécurité des champs si seuls certains champs sont manquants.

Les paramètres ne sont pas modifiables

Un paramètre peut être verrouillé par une surcharge d'environnement. Les paramètres effectifs sont résolus dans cet ordre :

Environment -> Tenant -> User -> Default

Si l'environnement fournit une valeur, les modifications à l'exécution doivent être rejetées au lieu de l'écraser silencieusement.

Les webhooks ou les tâches ne s'exécutent pas

Vérifiez :

• que la liste requires de l'artefact inclut la capacité nécessaire ;
• que l'image ObjectOS inclut le paquet de service optionnel ;
• que la configuration du service de file d'attente/de tâches est disponible ;
• que l'accès réseau sortant vers la cible est autorisé ;
• que les journaux de livraison ou les exécutions de tâches sont visibles dans les diagnostics de la Console.

Erreurs de base de données

Vérifiez :

• l'URL de la base de données et le type de pilote ;
• l'accès réseau depuis ObjectOS vers la base de données ;
• les identifiants et les options TLS ;
• les journaux de synchronisation/migration du schéma ;
• la persistance du stockage si vous utilisez SQLite en local.