ObjectOS
설정

시스템 설정

매니페스트와 공유 K/V 스토어를 통해 테넌트 및 사용자 설정을 구성합니다.

시스템 설정

ObjectStack에는 런타임 및 플러그인 설정을 위한 설정 서비스가 포함되어 있습니다. ObjectOS는 애플리케이션 아티팩트가 설정 기능을 요구할 때 Console을 통해 이러한 설정을 노출합니다.

설정 모델

설정은 코드로 선언되며 값으로 저장됩니다.

계층목적
설정 매니페스트필드, 레이블, 기본값, 검증, 가시성, 액션을 정의
sys_setting테넌트/사용자 K/V 값을 저장
리졸버유효 값을 읽음
Console UI표준 설정 페이지를 렌더링

플러그인은 일반적인 구성을 위해 일회성 설정 테이블을 만들어서는 안 됩니다. 설정 매니페스트를 선언하고 ObjectOS가 값을 일관되게 렌더링하고 저장하도록 해야 합니다.

해석 순서

각 설정은 범위(global, tenant, 또는 user)를 선언합니다. 리졸버는 우선순위가 가장 높은 것부터 낮은 것까지 캐스케이드를 따라가며, 설정된 첫 번째 값이 우선합니다.

Environment override (locked)
Global setting
Tenant setting
User setting
Manifest default

환경 재정의는 잠겨 있습니다. 값이 환경 변수를 통해 설정되면 Console UI는 이를 호스트에 의해 관리되는 것으로 표시하고 런타임 편집을 거부합니다. 체인 상단의 잠긴 값은 유효 값도 잠그므로, 하위 범위가 이를 가릴 수 없습니다.

일반적인 설정 영역

고객 대상 설정에는 일반적으로 다음이 포함됩니다.

영역예시
EmailSMTP 호스트, 제공업체 API 키, 발신 주소, 테스트 이메일
Branding제품명, 로고 URL, 강조 색상, 기본 테마
Feature flags테넌트 수준 기능 스위치
Storage로컬 파일 시스템 또는 객체 스토리지 자격 증명
AI providers모델 제공업체, API 키, 예산 한도
SSOOIDC 제공업체 설정 및 연결 테스트

시크릿

비밀번호 및 자격 증명 필드는 설정 서비스에 의해 암호화되거나 환경 관리 값으로 제공되어야 합니다. 시크릿 제공자가 구성되면 설정 서비스는 암호문을 sys_secret에 저장하고 sys_setting에는 핸들만 보관합니다. 시크릿을 아티팩트, compose 파일 또는 Git에 저장하지 마십시오.

테스트 액션

설정 매니페스트는 다음과 같은 표준 액션 버튼을 선언할 수 있습니다.

  • 테스트 이메일 전송;
  • SSO 디스커버리 테스트;
  • 객체 스토리지 자격 증명 확인;
  • 웹훅 대상 검증.

운영자에게 먼저 로그를 검사하도록 요청하는 대신, 고객 설정 플로우에 이러한 액션을 사용하십시오.

관련 항목

여러 설정 영역에는 전용 구성 가이드가 있습니다.

On this page