콘텐츠로 이동

설정

설정

바른의 설정은 매우 단순합니다. 서버로 동작히기 때문에 서버와 관련된 설정을 넣어두면 충분합니다.

설정파일

설정 파일은 $BAREUN_ROOT/config 디렉터리에 있습니다. 설정 파일도 딱 하나만 존재합니다.

아래는 그 파일의 내용입니다. 파일 형식은 JSON 입니다. 이 파일은 서버 응용 프로그램에서 바로 읽어들이기 때문에 형식과 변수는 배포된 것과 동일하게 유지되어야 합니다. 수정할 때, 오타가 생긴다면 시스템은 동작하지 않게 됩니다.

{
  "version": 1008000,
  "address": {
    "ipAddr": "0.0.0.0",
    "port": 5656
  },
  "libPath": "${BAREUN_ROOT}/lib",
  "modelPath": "${BAREUN_ROOT}/models",
  "customDictPath": "${BAREUN_ROOT}/var/custom-dict",
  "licenseFile" : "${BAREUN_ROOT}/var/license.pem",
  "logPath" : "${BAREUN_ROOT}/var/logs",
  "varPath" : "${BAREUN_ROOT}/var",
  "staticAddress": {
    "ipAddr": "0.0.0.0",
    "port": 5656
  },
  "manualPath": "${BAREUN_ROOT}/docs",
  "webPath": "${BAREUN_ROOT}/webroot",
  "hasTestWeb": true
}
변수 서브 변수 설명
address ipAddr 서버가 입력을 받아들일 주소입니다. 주소 중에서 ipAddr0.0.0.0이 기본값입니다.
설치한 호스트에 네트워크 인터페이스가 여러 개인데, 특정한 네트워크 인터페이스만 지원하고자 한다면 이 값을 특정한 호스트의 주소로 변경해도 됩니다.
port 기본값으로 5656을 사용합니다. 변경해도 됩니다. 변경 후에는 서버를 다시 실행해야 합니다.
libPath 모델을 추론하는 ONNX 런타임 라이브러리가 들어 있는 위치입니다. 굳이 바꾸실 필요가 없습니다.
modelPath 모델의 경로 실행할 모델의 위치를 정해줍니다. 굳이 바꾸실 필요가 없습니다.
customDictPath 사용자 사전의 경로, 자동으로 계산됩니다. 폐기되었습니다. 다양한 방법으로 사용자 사전을 등록할 수 있습니다.
licenseFile 라이선스 파일 경로, 이 파일은 바른을 폐쇄망에서 사용할 때, 반드시 필요합니다. 자동으로 계산됩니다. 폐기되었습니다.
logPath 로그 경로. 로그 파일이 저장되는 경로입니다.
staticAddress 내장 웹 서버 주소: 내장 웹서버가 도움말 등 기본 정보를 제공합니다.
manualPath 매뉴얼 경로: 내장 웹 서버가 참조하는 도움말 경로를 가리킵니다. 지금 보고 있는 이 문서가 들어 있는 경로입니다.
webPath 웹 어플리케이션 경로: 내장 웹 서버가 바른을 테스트해볼 수 있는 웹 페이지를 제공합니다. 이것은 도커 버전에거만 제공합니다. 도커에서만 envoy를 실행하기가 용이합니다. 각 OS별 배포한에서는 이를 지원하지 않습니다.
hasTestWeb 테스트용 웹 어플리케이션 포함 여부: 이 설정은 바꾸시면 안됩니다. 내장 웹 서버가 오동작합니디.

설정 변경하기

설정을 변경할 때에는 편집기를 열어서 편집하고 저장하면 됩니다. 자신이 없으면 원래 설정파일을 백업해 두는 습관을 들이면 좋겠습니다.

변경된 설정을 유지하기

변경된 설정 정보를 저장하는 좋은 방법은 사용자의 홈 디렉터리 아래에 .bareun을 만들고, 그 아래에 bareun.json을 두는 방법입니다.

이렇게 하면, 이 값은 재설치 이후에도 안전하게 보장됩니다.

새 버전이 배포될 때, 설정은 늘 원래 초기값을 가지고 배포됩니다. 새 버전의 기능을 그대로 쓰면서도 기존 설정파일을 유지하고 싶은 경우에는 한번 수정해 놓은 설정파일을 재사용하고 싶을 수 있습니다.

기존 버전의 설정 파일을 복사해서 가져오는 방법이 우선 가능합니다.

도움이 되었나요?