변경이 필요한 항목만 설정하세요. 기본값은 배포 파일에 넣지 않아도 됩니다.
ENV 설정 위치
Compose: 해당 서비스의 environment에 지정합니다. Kubernetes: 해당 컨테이너의 env / envFrom에 지정합니다. 변경 후에는 워크로드를 다시 생성하거나 재시작하세요.
RK_* 이름은 boot.yaml에 대응하며, 숫자는 배열 인덱스입니다. Compose에서는 불리언 값을 따옴표로 감싸고, 리터럴 $는 $$로 이스케이프하세요. RK는 쉼표와 백슬래시도 해석하므로, 새 데이터베이스에는 긴 무작위 16진수 비밀번호를 사용하세요. 업그레이드할 때는 기존 비밀번호를 유지하세요.
이 페이지에는 자주 쓰는 항목만 정리했습니다. boot.yaml의 모든 값은 같은 방식으로 재정의할 수 있습니다. 참고: rk-boot: boot 재정의 ↗.
Terminal · Compose
docker compose up -dTerminal · Kubernetes
kubectl -n mof rollout restart deployment/mof데이터베이스
| 변수 | 기본값 | 설명 |
|---|---|---|
RK_POSTGRES_0_ADDR | localhost:5432 | PostgreSQL 주소:포트. |
RK_POSTGRES_0_USER | postgres | 로그인과 CREATEDB 권한을 가진 데이터베이스 역할. |
RK_POSTGRES_0_PASS | password | 기존 데이터베이스 비밀번호를 사용하세요. |
RK_POSTGRES_0_DATABASE_0_MAXOPENCONN | 30 | MOF 프로세스당 최대 데이터베이스 연결 수. 프로세스가 여러 개이면 합계가 데이터베이스 한도를 넘지 않도록 하세요. |
데이터베이스 Params가 비어 있으면 sslmode=disable과 TimeZone=Asia/Shanghai가 사용됩니다. MOF 클라우드 제공업체 데이터베이스에 TLS를 적용하지 않으므로, TLS 전용 PostgreSQL은 지원되지 않습니다.
서버와 Admin
| 변수 | 기본값 | 설명 |
|---|---|---|
MOF_ADMIN_PASSWORD | — | 선택 사항인 Admin 비밀번호 재정의. 설정하지 않으면 최초 설정 시 생성됩니다. |
RK_CONFIG_0_CONTENT_MODE_WEB | false | 웹 전용 모드. all-in-one으로 실행하려면 두 모드 플래그를 모두 설정하지 마세요. |
RK_CONFIG_0_CONTENT_MODE_WORKER | false | Worker 전용 모드. 웹 전용 모드와 함께 켜지 마세요. |
RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS | 2 | 한 프로세스에서 동시에 실행하는 동기화 작업(청구서, 리소스, 내보내기) 수. |
RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS | 2 | 한 프로세스에서 동시에 실행하는 운영 작업(계정 삭제, 청구서 정리, 가상 태그 적용) 수. |
MOF_JWT_SECRET | — | 선택 사항인 로그인 서명 키로, 32자 이상이어야 합니다. 설정하지 않으면 첫 시작 시 생성되어 데이터베이스에 저장됩니다. 설정한다면 모든 MOF 프로세스에서 같은 값을 사용하세요. |
CORS
| 변수 | 기본값 | 설명 |
|---|---|---|
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0 | * | 허용할 브라우저 오리진. 스킴과 포트를 포함하고 경로는 넣지 않습니다. |
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALS | false | 크로스 오리진 자격 증명을 사용할 때는 * 대신 명시적인 오리진을 지정하세요. |
예시: 크로스 오리진 자격 증명
Compose · mof.environment
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0: "https://mof.example.com"
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALS: "true"오리진은 _1, _2 등으로 추가합니다. 자격 증명을 활성화할 때는 기본값 *를 바꾸세요.
로그
| 변수 | 기본값 | 설명 |
|---|---|---|
RK_LOGGER_0_ZAP_LEVEL | info | 애플리케이션 로그 레벨: debug, info, warn, error. |
RK_LOGGER_0_ZAP_ENCODING | console | 애플리케이션 로그 형식: console 또는 json(로그 수집기용). |
RK_GIN_0_MIDDLEWARE_LOGGING_ENABLED | true | HTTP 요청 로그. 애플리케이션 로그와는 별개입니다. |
RK_POSTGRES_0_LOGGER_LEVEL | warn | SQL 로그: info, warn, error, silent. |
MCP와 OAuth
| 변수 | 기본값 | 설명 |
|---|---|---|
MOF_MCP_INTERNAL_URL | http://mof-mcp:8001 | 내부 MCP 주소: compose 서비스 / Kubernetes Service 이름. 설정하지 마세요. |
MOF_PUBLIC_URL | — | Dash와 MOF가 공유하는 OAuth 공개 HTTPS 오리진(경로 제외). |
MOF_MCP_OAUTH_SECRET | — | OAuth 시크릿, 32자 이상. 모든 MOF 노드에서 공유합니다. |
예시: OAuth
Compose · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"개인 토큰에는 OAuth가 필요 없습니다. Admin → 설정 → MCP에서 MCP 접근을 활성화하세요. OAuth 구성 상태가 공개 콜백 연결을 보장하지는 않습니다.
Dash 업스트림
| 변수 | 기본값 | 설명 |
|---|---|---|
MOF_UPSTREAM | http://mof:8080 | MOF 주소: compose 서비스 / Kubernetes Service 이름. MOF를 다른 이름으로 실행할 때만 설정하세요. |
아웃바운드 프록시
| 변수 | 기본값 | 설명 |
|---|---|---|
HTTP_PROXY | — | 선택적 아웃바운드 HTTP 프록시. |
HTTPS_PROXY | — | 선택적 아웃바운드 HTTPS 프록시. |
NO_PROXY | — | 내부 호스트와 데이터베이스 주소를 제외합니다. SDK마다 지원 여부가 다릅니다. |
—는 미설정을 의미합니다. 라이선스와 사용자 관리는 Admin에서 합니다.