콘텐츠로 이동
mofcloud

환경 변수(ENV)

마지막 업데이트:

변경이 필요한 항목만 설정하세요. 기본값은 배포 파일에 넣지 않아도 됩니다.

ENV 설정 위치

Compose: 해당 서비스의 environment에 지정합니다. Kubernetes: 해당 컨테이너의 env / envFrom에 지정합니다. 변경 후에는 워크로드를 다시 생성하거나 재시작하세요.

RK_* 이름은 boot.yaml에 대응하며, 숫자는 배열 인덱스입니다. Compose에서는 불리언 값을 따옴표로 감싸고, 리터럴 $는 $$로 이스케이프하세요. RK는 쉼표와 백슬래시도 해석하므로, 새 데이터베이스에는 긴 무작위 16진수 비밀번호를 사용하세요. 업그레이드할 때는 기존 비밀번호를 유지하세요.

이 페이지에는 자주 쓰는 항목만 정리했습니다. boot.yaml의 모든 값은 같은 방식으로 재정의할 수 있습니다. 참고: rk-boot: boot 재정의 ↗.

Terminal · Compose
docker compose up -d
Terminal · Kubernetes
kubectl -n mof rollout restart deployment/mof

데이터베이스

변수기본값설명
RK_POSTGRES_0_ADDRlocalhost:5432PostgreSQL 주소:포트.
RK_POSTGRES_0_USERpostgres로그인과 CREATEDB 권한을 가진 데이터베이스 역할.
RK_POSTGRES_0_PASSpassword기존 데이터베이스 비밀번호를 사용하세요.
RK_POSTGRES_0_DATABASE_0_MAXOPENCONN30MOF 프로세스당 최대 데이터베이스 연결 수. 프로세스가 여러 개이면 합계가 데이터베이스 한도를 넘지 않도록 하세요.

rk-boot 문서의 전체 옵션 ↗

데이터베이스 Params가 비어 있으면 sslmode=disable과 TimeZone=Asia/Shanghai가 사용됩니다. MOF 클라우드 제공업체 데이터베이스에 TLS를 적용하지 않으므로, TLS 전용 PostgreSQL은 지원되지 않습니다.

서버와 Admin

변수기본값설명
MOF_ADMIN_PASSWORD—선택 사항인 Admin 비밀번호 재정의. 설정하지 않으면 최초 설정 시 생성됩니다.
RK_CONFIG_0_CONTENT_MODE_WEBfalse웹 전용 모드. all-in-one으로 실행하려면 두 모드 플래그를 모두 설정하지 마세요.
RK_CONFIG_0_CONTENT_MODE_WORKERfalseWorker 전용 모드. 웹 전용 모드와 함께 켜지 마세요.
RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS2한 프로세스에서 동시에 실행하는 동기화 작업(청구서, 리소스, 내보내기) 수.
RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS2한 프로세스에서 동시에 실행하는 운영 작업(계정 삭제, 청구서 정리, 가상 태그 적용) 수.
MOF_JWT_SECRET—선택 사항인 로그인 서명 키로, 32자 이상이어야 합니다. 설정하지 않으면 첫 시작 시 생성되어 데이터베이스에 저장됩니다. 설정한다면 모든 MOF 프로세스에서 같은 값을 사용하세요.

CORS

변수기본값설명
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0*허용할 브라우저 오리진. 스킴과 포트를 포함하고 경로는 넣지 않습니다.
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALSfalse크로스 오리진 자격 증명을 사용할 때는 * 대신 명시적인 오리진을 지정하세요.

rk-boot 문서의 전체 옵션 ↗

예시: 크로스 오리진 자격 증명
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_LEVELinfo애플리케이션 로그 레벨: debug, info, warn, error.
RK_LOGGER_0_ZAP_ENCODINGconsole애플리케이션 로그 형식: console 또는 json(로그 수집기용).
RK_GIN_0_MIDDLEWARE_LOGGING_ENABLEDtrueHTTP 요청 로그. 애플리케이션 로그와는 별개입니다.
RK_POSTGRES_0_LOGGER_LEVELwarnSQL 로그: info, warn, error, silent.

rk-boot 문서의 전체 옵션 ↗

MCP와 OAuth

변수기본값설명
MOF_MCP_INTERNAL_URLhttp://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_UPSTREAMhttp://mof:8080MOF 주소: compose 서비스 / Kubernetes Service 이름. MOF를 다른 이름으로 실행할 때만 설정하세요.

아웃바운드 프록시

변수기본값설명
HTTP_PROXY—선택적 아웃바운드 HTTP 프록시.
HTTPS_PROXY—선택적 아웃바운드 HTTPS 프록시.
NO_PROXY—내부 호스트와 데이터베이스 주소를 제외합니다. SDK마다 지원 여부가 다릅니다.

—는 미설정을 의미합니다. 라이선스와 사용자 관리는 Admin에서 합니다.