문제 해결

증상에서 시작한 다음, 가장 작은 경계부터 먼저 확인하세요.

ObjectOS가 시작되지 않음

확인 사항:

1. 컨테이너 로그.
2. Node 버전 및 패키지 설치.
3. PORT 충돌.
4. 누락된 아티팩트.
5. 인증 엔드포인트가 필요할 때 누락된 OS_AUTH_SECRET.

Docker의 경우:

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

아티팩트를 로드할 수 없음

확인 사항:

• OS_ARTIFACT_FILE이 마운트된 파일을 가리키는지;
• 파일이 컨테이너 내부에 존재하는지;
• 파일이 유효한 JSON인지;
• 아티팩트가 소스 메타데이터가 아니라 컴파일된 ObjectStack 아티팩트인지;
• 파일 권한이 읽기 액세스를 허용하는지.

컨테이너 내부에서:

ls -l /artifacts/objectstack.json

로그인 실패

확인 사항:

• OS_AUTH_SECRET이 구성되어 있는지;
• 공개 URL과 콜백 URL이 일치하는지;
• OIDC 디스커버리 URL에 ObjectOS에서 접근할 수 있는지;
• 신뢰할 수 있는 오리진에 공개 도메인이 포함되어 있는지;
• 쿠키가 올바른 프로젝트 호스트 이름으로 범위가 지정되어 있는지;
• 프로젝트 커널에서 인증이 활성화되어 있는지.

사용자가 레코드를 볼 수 없음

확인 사항:

1. 올바른 프로젝트 호스트 이름.
2. 사용자가 예상된 조직에 속해 있음.
3. 객체 read 권한.
4. 행 수준 보안.
5. 공유 규칙 또는 레코드 공유.
6. 일부 필드만 누락된 경우 필드 보안.

설정을 편집할 수 없음

설정이 환경 재정의에 의해 잠겨 있을 수 있습니다. 유효 설정은 다음 순서로 해석됩니다:

Environment -> Tenant -> User -> Default

환경에서 값을 제공하면, 런타임 편집은 값을 자동으로 덮어쓰는 대신 거부되어야 합니다.

웹훅 또는 작업이 실행되지 않음

확인 사항:

• 아티팩트의 requires 목록에 필요한 기능이 포함되어 있는지;
• ObjectOS 이미지에 선택적 서비스 패키지가 포함되어 있는지;
• 큐/작업 서비스 구성을 사용할 수 있는지;
• 대상으로의 아웃바운드 네트워크 액세스가 허용되는지;
• 전달 로그 또는 작업 실행이 Console 진단에서 표시되는지.

데이터베이스 오류

확인 사항:

• 데이터베이스 URL 및 드라이버 유형;
• ObjectOS에서 데이터베이스로의 네트워크 액세스;
• 자격 증명 및 TLS 옵션;
• 스키마 동기화/마이그레이션 로그;
• 로컬 SQLite를 사용하는 경우 스토리지 지속성.